com.combex.e.edoc
Class EConstructorDoc

java.lang.Object
  |
  +--com.combex.e.edoc.EDoc
        |
        +--com.combex.e.edoc.EProgramElementDoc
              |
              +--com.combex.e.edoc.EMemberDoc
                    |
                    +--com.combex.e.edoc.EExecutableMemberDoc
                          |
                          +--com.combex.e.edoc.EConstructorDoc
All Implemented Interfaces:
Comparable, com.sun.javadoc.ConstructorDoc, com.sun.javadoc.Doc, com.sun.javadoc.ExecutableMemberDoc, Marker, com.sun.javadoc.MemberDoc, PassByConstruction, com.sun.javadoc.ProgramElementDoc, Serializable

class EConstructorDoc
extends EExecutableMemberDoc
implements com.sun.javadoc.ConstructorDoc


Field Summary
(package private)  EClassDoc myContainingClass
           
(package private)  String myFlatSignature
           
(package private)  int myModifiers
           
(package private)  EParameter[] myParameters
           
(package private)  EClassDoc[] myThrownExceptions
           
 
Fields inherited from interface org.erights.e.elib.serial.PassByConstruction
HONORARY, HONORED_NAMES, serialVersionUID
 
Constructor Summary
EConstructorDoc(EDocBuilder builder, com.sun.javadoc.ConstructorDoc cDoc)
           
 
Method Summary
 int arity()
           
(package private)  boolean checkAccess()
          Hook so we can allow unfiltered access, with a yet to be determined API addition.
(package private)  EComment comment()
          For lazy initialization of comment.
 String commentText()
          Return the text of the comment for this doc item.
 int compareTo(Object obj)
          Compares this Object with the specified Object for order.
 com.sun.javadoc.ClassDoc containingClass()
          Get the containing class of this program element.
 com.sun.javadoc.PackageDoc containingPackage()
          Return the package that this member is contained in.
(package private)  boolean equalParameterTypes(String[] paramTypeArray)
          Return true, if the respective parameter strings from EParameter Array and String array are equal else return false.
 com.sun.javadoc.Tag[] firstSentenceTags()
           
 String flatSignature()
          get flat signature.
(package private)  java.text.CollationKey generateKey()
          generate a key for sorting.
 String getRawCommentText()
          Return the full unprocessed text of the comment.
(package private)  boolean hasNameAndParameters(String methodName, String[] paramTypeArray)
          if this ExecutableMemberDoc has the same name and parameters return true else return false.
 com.sun.javadoc.Tag[] inlineTags()
           
 boolean isClass()
          Is this Doc item a class.
 boolean isConstructor()
          Return true if it is a constructor, which it is.
 boolean isError()
          Is this Doc item a error class? False until overridden.
 boolean isException()
          Is this Doc item a exception class? False until overridden.
 boolean isField()
          Is this Doc item a field? False until overridden.
 boolean isFinal()
          Return true if this program element is final
 boolean isIncluded()
          return true if this member is included in the active set.
 boolean isInterface()
          Is this Doc item a interface? False until overridden.
 boolean isMethod()
          Is this Doc item a simple method (i.e.
 boolean isNative()
          Return true if this method is native
 boolean isOrdinaryClass()
          Is this Doc item a ordinary class (i.e.
 boolean isPackagePrivate()
          Return true if this program element is package private
 boolean isPrivate()
          Return true if this program element is private
 boolean isProtected()
          Return true if this program element is protected
 boolean isPublic()
          Return true if this program element is public
 boolean isStatic()
          Return true if this program element is static
 boolean isSynchronized()
          Return true if this method is synchronized
 boolean isSynthetic()
          Returns true if this field was synthesized by the compiler.
(package private)  java.text.CollationKey key()
          return a key for sorting.
static ArrayList list(Object[] array)
           
 String modifiers()
          Get modifiers string.
 int modifierSpecifier()
          Get the modifier specifier integer.
 String name()
          Get the name.
 com.sun.javadoc.Parameter[] parameters()
          Get argument information.
 com.sun.javadoc.ParamTag[] paramTags()
          Return the param tags in this method.
 com.sun.javadoc.SourcePosition position()
          Need for 1.4
 String qualifiedName()
          Get the name.
(package private)  String readHTMLDocumentation(InputStream input, String filename)
          Utility for subclasses which read HTML documentation files.
 com.sun.javadoc.SeeTag[] seeTags()
          Return the see also tags in this Doc item.
 void setRawCommentText(String rawDocumentation)
          Set the full unprocessed text of the comment.
 String signature()
          Get the signature.
 com.sun.javadoc.Tag[] tags()
          Return all tags in this Doc item.
 com.sun.javadoc.Tag[] tags(String tagname)
          Return tags of the specified kind in this Doc item.
(package private)  EClassDoc thisClassDocImpl()
           
 com.sun.javadoc.ClassDoc[] thrownExceptions()
          Return exceptions this method or constructor throws.
 com.sun.javadoc.ThrowsTag[] throwsTags()
          Return the throws tags in this method.
 String toQualifiedString()
          Return the qualified name appended with the signature.
 String toString()
          Returns a string representation of the member.
 String typedVerb()
           
static EDoc[] visible(List list, Class memType)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Field Detail

myFlatSignature

final String myFlatSignature

myParameters

final EParameter[] myParameters

myThrownExceptions

final EClassDoc[] myThrownExceptions

myModifiers

final int myModifiers

myContainingClass

final EClassDoc myContainingClass
Constructor Detail

EConstructorDoc

public EConstructorDoc(EDocBuilder builder,
                       com.sun.javadoc.ConstructorDoc cDoc)
Method Detail

typedVerb

public String typedVerb()
Specified by:
typedVerb in class EMemberDoc

arity

public int arity()
Specified by:
arity in class EMemberDoc

qualifiedName

public String qualifiedName()
Get the name.

Overrides:
qualifiedName in class EMemberDoc
Returns:
the qualified name of the member.

name

public String name()
Get the name.

Overrides:
name in class EMemberDoc
Returns:
the unqualified name of the member.

isConstructor

public boolean isConstructor()
Return true if it is a constructor, which it is.

Overrides:
isConstructor in class EDoc
Returns:
true

hasNameAndParameters

boolean hasNameAndParameters(String methodName,
                             String[] paramTypeArray)
if this ExecutableMemberDoc has the same name and parameters return true else return false.

Returns:
boolean

equalParameterTypes

boolean equalParameterTypes(String[] paramTypeArray)
Return true, if the respective parameter strings from EParameter Array and String array are equal else return false.


generateKey

java.text.CollationKey generateKey()
generate a key for sorting.

default is toString();

Overrides:
generateKey in class EDoc

thrownExceptions

public com.sun.javadoc.ClassDoc[] thrownExceptions()
Return exceptions this method or constructor throws.

Returns:
an array of ClassDoc[] representing the exceptions thrown by this method.

isNative

public boolean isNative()
Return true if this method is native


isSynchronized

public boolean isSynchronized()
Return true if this method is synchronized


parameters

public com.sun.javadoc.Parameter[] parameters()
Get argument information.

Returns:
an array of EParameter, one element per argument in the order the arguments are present.
See Also:
EParameter

throwsTags

public com.sun.javadoc.ThrowsTag[] throwsTags()
Return the throws tags in this method.

Returns:
an array of ThrowTagImpl containing all @exception and @throws tags.

paramTags

public com.sun.javadoc.ParamTag[] paramTags()
Return the param tags in this method.

Returns:
an array of EParamTag containing all @param tags.

signature

public String signature()
Get the signature. It is the parameter list, type is qualified. For instance, for a method mymethod(String x, int y), it will return (java.lang.String,int).


flatSignature

public String flatSignature()
get flat signature. all types are not qualified. return a String, which is the flat signiture of this member. It is the parameter list, type is not qualified. For instance, for a method mymethod(String x, int y), it will return (String, int).


toQualifiedString

public String toQualifiedString()
Return the qualified name appended with the signature.

Overrides:
toQualifiedString in class EMemberDoc
Returns:
the qualified name.

thisClassDocImpl

EClassDoc thisClassDocImpl()
Overrides:
thisClassDocImpl in class EDoc

containingPackage

public com.sun.javadoc.PackageDoc containingPackage()
Return the package that this member is contained in. Return "" if in empty package.


isIncluded

public boolean isIncluded()
return true if this member is included in the active set.

Specified by:
isIncluded in class EDoc

isSynthetic

public boolean isSynthetic()
Returns true if this field was synthesized by the compiler.


toString

public String toString()
Returns a string representation of the member.

Overrides:
toString in class EDoc
Returns:
a description of the member

containingClass

public com.sun.javadoc.ClassDoc containingClass()
Get the containing class of this program element.

Returns:
a EClassDoc for this element's containing class. If this is a class with no outer class, return null.

modifierSpecifier

public int modifierSpecifier()
Get the modifier specifier integer.

See Also:
java.lang.reflect.Modifier

modifiers

public String modifiers()
Get modifiers string.
 Example, for:
   public abstract int foo() { ... }
 modifiers() would return:
   'public abstract'
 


isPublic

public boolean isPublic()
Return true if this program element is public


isProtected

public boolean isProtected()
Return true if this program element is protected


isPrivate

public boolean isPrivate()
Return true if this program element is private


isPackagePrivate

public boolean isPackagePrivate()
Return true if this program element is package private


isStatic

public boolean isStatic()
Return true if this program element is static


isFinal

public boolean isFinal()
Return true if this program element is final


list

public static ArrayList list(Object[] array)

comment

EComment comment()
For lazy initialization of comment.


checkAccess

boolean checkAccess()
Hook so we can allow unfiltered access, with a yet to be determined API addition.


commentText

public String commentText()
Return the text of the comment for this doc item. TagImpls have been removed.


tags

public com.sun.javadoc.Tag[] tags()
Return all tags in this Doc item.

Returns:
an array of Tag containing all tags on this Doc item.

tags

public com.sun.javadoc.Tag[] tags(String tagname)
Return tags of the specified kind in this Doc item.

Parameters:
tagname - name of the tag kind to search for.
Returns:
an array of ETag containing all tags whose 'kind()' matches 'tagname'.

seeTags

public com.sun.javadoc.SeeTag[] seeTags()
Return the see also tags in this Doc item.

Returns:
an array of SeeTag containing all @see tags.

inlineTags

public com.sun.javadoc.Tag[] inlineTags()

firstSentenceTags

public com.sun.javadoc.Tag[] firstSentenceTags()

readHTMLDocumentation

String readHTMLDocumentation(InputStream input,
                             String filename)
                       throws IOException
Utility for subclasses which read HTML documentation files.

IOException

getRawCommentText

public String getRawCommentText()
Return the full unprocessed text of the comment. Tags are included as text. Used mainly for store and retrieve operations like internalization.


setRawCommentText

public void setRawCommentText(String rawDocumentation)
Set the full unprocessed text of the comment. Tags are included as text. Used mainly for store and retrieve operations like internalization.


key

java.text.CollationKey key()
return a key for sorting.


compareTo

public int compareTo(Object obj)
Compares this Object with the specified Object for order. Returns a negative integer, zero, or a positive integer as this Object is less than, equal to, or greater than the given Object.

Included so that Doc item are java.lang.Comparable.

Specified by:
compareTo in interface Comparable
Parameters:
obj - the Object to be compared.
Returns:
a negative integer, zero, or a positive integer as this Object is less than, equal to, or greater than the given Object.
Throws:
ClassCastException - the specified Object's type prevents it from being compared to this Object.

isField

public boolean isField()
Is this Doc item a field? False until overridden.

Returns:
true if it represents a field

isMethod

public boolean isMethod()
Is this Doc item a simple method (i.e. not a constructor)? False until overridden.

Returns:
true is it represents a method, false if it is anything else, including constructor, field, class, ...

isInterface

public boolean isInterface()
Is this Doc item a interface? False until overridden.

Returns:
true is it represents a interface

isException

public boolean isException()
Is this Doc item a exception class? False until overridden.

Returns:
true is it represents a exception

isError

public boolean isError()
Is this Doc item a error class? False until overridden.

Returns:
true is it represents a error

isOrdinaryClass

public boolean isOrdinaryClass()
Is this Doc item a ordinary class (i.e. not an interface, exception, or error)? False until overridden.

Returns:
true is it represents a class

isClass

public boolean isClass()
Is this Doc item a class. Note: interfaces are not classes. False until overridden.

Returns:
true is it represents a class

visible

public static EDoc[] visible(List list,
                             Class memType)

position

public com.sun.javadoc.SourcePosition position()
Need for 1.4



comments?