Doclet-获取列表的泛型

Question

我正在编写一个扩展 com.sun.javadoc.Doclet 的 doclet。

当我想要将 ArrayList 记录为方法的字段时，我想获取泛型的类型（例如，在记录 ArrayList 时，我想获取这是一个列表的信息包含字符串）。

我只能得到信息，这是一个ArrayList。即使在调用时，

ParameterizedType paramType = fieldType.asParameterizedType();

我也只得到 java.util.ArrayList 而不是泛型的类型。

有人知道如何获取列表的通用类型吗？

这是示例代码：

FieldDoc[] fields = classDoc.fields();
for (int k = 0; k < fields.length; k++) {
    Type fieldType = fields[k].type();
    if (fieldType.asParameterizedType() != null) {
        ParameterizedType paramType = fieldType.asParameterizedType();
        String qualiName = paramType.qualifiedTypeName(); // this equals "java.util.ArrayList"
        fieldType.asParameterizedType().toString(); // this equals "java.util.ArrayList"
        fieldType.asParameterizedType().typeName(); // this equals "ArrayList"
    }
}

Answer 1

在 Java 1.6 下编写自定义 doclet 时，我遇到了泛型在类型上丢失的问题。我可以通过将以下方法添加到我的 doclet 来修复它。

   /**
    * NOTE: Without this method present and returning LanguageVersion.JAVA_1_5,
    *       Javadoc will not process generics because it assumes LanguageVersion.JAVA_1_1
    * @return language version (hard coded to LanguageVersion.JAVA_1_5)
    */
   public static LanguageVersion languageVersion() {
      return LanguageVersion.JAVA_1_5;
   }

Answer 2

是否输出是 java.util.ArrayList 并且您没有看到 部分，因为您的浏览器将其解释为未知的 HTML标签？

对于 HTML 输出，您必须转义 <。

如果这不是问题，请显示足够的代码，以便我们可以重现问题。

---

看到你的示例后，我可以用这个 doclet 重现它：

package de.fencing_game.paul.examples.doclet;

import com.sun.javadoc.*;
import java.util.ArrayList;

/**
 * A test doclet to see how generic fields work.
 *
 * Inspired by the question <a href="http://stackoverflow.com/q/5731619/600500">Doclet- Get generics of a list</a> on Stackoverflow.
 */
public class GenericTestDoclet<Y> extends Doclet {

    public ArrayList<? extends Y> stringList;

    /**
     * Erstellt ein(e(n)) neu(e(n)) <code>GenericTestDoclet</code>.
     *
     */
    public GenericTestDoclet() {

    }


    public ArrayList<? extends Y> getList() {
        return stringList;
    }

    public void printType(Type fieldType, DocErrorReporter err) {
        err.printNotice("type: " + fieldType);
        if (fieldType.asParameterizedType() != null) {
            ParameterizedType paramType = fieldType.asParameterizedType();
            err.printNotice("paramType:" + paramType);
            String qualiName = paramType.qualifiedTypeName();
            err.printNotice("qualiName: " + qualiName);

            String typeName = fieldType.asParameterizedType().typeName();
            err.printNotice("typeName: " + typeName);

            Type[] parameters = paramType.typeArguments();
            err.printNotice("parameters.length: " + parameters.length);
            for(Type p : parameters) {
                err.printNotice("param: " + p);
            }
        }
        err.printNotice("");
    }


    public void listFields(ClassDoc classDoc, DocErrorReporter err) {
        FieldDoc[] fields = classDoc.fields();
        for (int k = 0; k < fields.length; k++) {
            err.printNotice("field: " + fields[k]);
            Type fieldType = fields[k].type();
            printType(fieldType, err);
        }
    }


    public void listMethods(ClassDoc classDoc, DocErrorReporter err) {
        MethodDoc[] methods = classDoc.methods();
        for (int k = 0; k < methods.length; k++) {
            err.printNotice("method: " + methods[k]);
            Type returnType = methods[k].returnType();
            printType(returnType, err);
        }
    }



    /**
     * The entry point of the doclet.
     * @return true if all the included elements have enough documentation,
     *   false if some documentation is missing.
     */
    public static boolean start(RootDoc root) {
        GenericTestDoclet<?> d = new GenericTestDoclet<Integer>();
        for(ClassDoc clazz : root.classes()) {
            d.listFields(clazz, root);
            d.listMethods(clazz, root);
        }
        return true;
    }

}

输出，如果应用于自身：

field: de.fencing_game.paul.examples.doclet.GenericTestDoclet.stringList
type: java.util.ArrayList
paramType:java.util.ArrayList
qualiName: java.util.ArrayList
typeName: ArrayList
parameters.length: 0

method: de.fencing_game.paul.examples.doclet.GenericTestDoclet.getList()
type: java.util.ArrayList
paramType:java.util.ArrayList
qualiName: java.util.ArrayList
typeName: ArrayList
parameters.length: 0

[more methods omitted]

它表明返回类型在这里似乎也是无参数的。

我想说我已经使用此方法 递归打印类型名称，但它表明我的 LaTeX-Doclet 实际上甚至没有使用我创建的递归方法（而是类型为 从该类型的编译器树打印）。

但不知何故，这必须是可能的，因为不知何故标准 Doclet 设法创建正确的输出。

Answer 3

使用 Trex 的答案启用 Java 1.5 模式后，您可以使用以下方式访问 fieldType 的通用类型

Type[] typeArguments = fieldType.asParameterizedType().typeArguments()

Answer 4

假设 ArrayList 是您的类的成员字段，它看起来像以下答案< /a> 将提供您需要的内容。

该答案中的代码片段显示了总体思路（但请看一下该问题/答案）：

Field stringListField = Test.class.getDeclaredField("stringList");
ParameterizedType stringListType = (ParameterizedType) stringListField.getGenericType();
Class<?> stringListClass = (Class<?>) stringListType.getActualTypeArguments()[0];
System.out.println(stringListClass); // class java.lang.String.