ParameterizedType, which
duke@1: * represents an invocation of a generic class or interface.
duke@1: *
jjg@1359: * This is NOT part of any supported API. jjg@1359: * If you write code that depends on this, you do so at your own risk. jjg@1359: * This code and its internal interfaces are subject to change or jjg@1359: * deletion without notice. jjg@1359: * duke@1: * @author Scott Seligman duke@1: * @since 1.5 duke@1: */ duke@1: public class ParameterizedTypeImpl duke@1: extends AbstractTypeImpl implements ParameterizedType { duke@1: duke@1: ParameterizedTypeImpl(DocEnv env, Type type) { duke@1: super(env, type); duke@1: } duke@1: duke@1: /** duke@1: * Return the generic class or interface that declared this type. duke@1: */ jjg@910: @Override duke@1: public ClassDoc asClassDoc() { duke@1: return env.getClassDoc((ClassSymbol)type.tsym); duke@1: } duke@1: duke@1: /** duke@1: * Return the actual type arguments of this type. duke@1: */ duke@1: public com.sun.javadoc.Type[] typeArguments() { duke@1: return TypeMaker.getTypes(env, type.getTypeArguments()); duke@1: } duke@1: duke@1: /** duke@1: * Return the class type that is a direct supertype of this one. duke@1: * Return null if this is an interface type. duke@1: */ duke@1: public com.sun.javadoc.Type superclassType() { duke@1: if (asClassDoc().isInterface()) { duke@1: return null; duke@1: } duke@1: Type sup = env.types.supertype(type); duke@1: return TypeMaker.getType(env, duke@1: (sup != type) ? sup : env.syms.objectType); duke@1: } duke@1: duke@1: /** duke@1: * Return the interface types directly implemented by or extended by this duke@1: * parameterized type. duke@1: * Return an empty array if there are no interfaces. duke@1: */ duke@1: public com.sun.javadoc.Type[] interfaceTypes() { duke@1: return TypeMaker.getTypes(env, env.types.interfaces(type)); duke@1: } duke@1: duke@1: /** duke@1: * Return the type that contains this type as a member. duke@1: * Return null is this is a top-level type. duke@1: */ duke@1: public com.sun.javadoc.Type containingType() { jjg@1374: if (type.getEnclosingType().hasTag(CLASS)) { duke@1: // This is the type of an inner class. duke@1: return TypeMaker.getType(env, type.getEnclosingType()); duke@1: } duke@1: ClassSymbol enclosing = type.tsym.owner.enclClass(); duke@1: if (enclosing != null) { duke@1: // Nested but not inner. Return the ClassDoc of the enclosing duke@1: // class or interface. duke@1: // See java.lang.reflect.ParameterizedType.getOwnerType(). duke@1: return env.getClassDoc(enclosing); duke@1: } duke@1: return null; duke@1: } duke@1: duke@1: duke@1: // Asking for the "name" of a parameterized type doesn't exactly make duke@1: // sense. It's a type expression. Return the name of its generic duke@1: // type. jjg@910: @Override duke@1: public String typeName() { duke@1: return TypeMaker.getTypeName(type, false); duke@1: } duke@1: jjg@910: @Override duke@1: public ParameterizedType asParameterizedType() { duke@1: return this; duke@1: } duke@1: jjg@910: @Override duke@1: public String toString() { duke@1: return parameterizedTypeToString(env, (ClassType)type, true); duke@1: } duke@1: duke@1: static String parameterizedTypeToString(DocEnv env, ClassType cl, duke@1: boolean full) { duke@1: if (env.legacyDoclet) { duke@1: return TypeMaker.getTypeName(cl, full); duke@1: } jjg@910: StringBuilder s = new StringBuilder(); jjg@1374: if (!(cl.getEnclosingType().hasTag(CLASS))) { // if not an inner class... duke@1: s.append(TypeMaker.getTypeName(cl, full)); duke@1: } else { duke@1: ClassType encl = (ClassType)cl.getEnclosingType(); duke@1: s.append(parameterizedTypeToString(env, encl, full)) duke@1: .append('.') duke@1: .append(cl.tsym.name.toString()); duke@1: } duke@1: s.append(TypeMaker.typeArgumentsString(env, cl, full)); duke@1: return s.toString(); duke@1: } duke@1: }