Package Torello.JavaDoc
Interface UserProcessorPage
-
public interface UserProcessorPage
An interface that may be implemented by a user to execute detailed customizations and modifications to a specific Java-Doc Web Page. This interface should be implemented by a class that has the same name as the class being processed, but ending with a'$'
.
After writing a Java Class which implements this interface, simply copy it to the directory in your file-system that contains the Java CIET/Type - in a sub-directory that has the following name:upgrade-files/user-processors/MyClassName$.java
Notice that the name of the this particular class ends with a'$'
. The first part of the class' name is being utilized to identify to the Java-Doc Upgrader logic the name of the actual class/CIET/Type that your processor-class is going to process.
If you had a class named'BigNumberCruncher.java'
that was a Java'class'
, and you wanted to write an HTML-Processor to insert several notices into the JavaDoc Page for theBigNumberCruncher
type - you would write a user-processor named'BigNumberCruncher$.java'
. You would make sure to leave the processor in the following Java Source-Code Directory:../com/MyCompany/MyPackage/upgrade-files/user-processors/BigNumberCruncher$.class
The class that you write would implement this interface'UserProcessorPage'
. During the JavaDoc Upgrader phase of your build, the upgrader logic would invoke your user-processor and pass it the relevant HTML Data from the Java-Doc HTML Web-Page that had been created by the Java-Doc Tool to your processor.
Hi-Lited Source-Code:- View Here: Torello/JavaDoc/UserProcessorPage.java
- Open New Browser-Tab: Torello/JavaDoc/UserProcessorPage.java
File Size: 8,972 Bytes Line Count: 187 '\n' Characters Found
-
-
Method Summary
Dispatch-Accessor Methods Modifier and Type Method default void
process(JavaDocHTMLFile jdhf)
default void
processHeaderFooter(HeaderFooterHTML headerFooter)
Summary Table HTML Dispatch-Accessor Methods Modifier and Type Method default void
processAESumm(SummaryTableHTML<AnnotationElem> oaeSummaries, SummaryTableHTML<AnnotationElem> raeSummaries)
default void
processCtorSumm(SummaryTableHTML<Constructor> constructorSummaries)
default void
processECSumm(SummaryTableHTML<EnumConstant> ecSummaries)
default void
processFieldSumm(SummaryTableHTML<Field> fieldSummaries)
default void
processMethodSumm(SummaryTableHTML<Method> methodSummaries)
Detail HTML Dispatch-Accessor Methods Modifier and Type Method default void
processAEDetails(ReadOnlyList<ReflHTML<AnnotationElem>> aeDetails)
default void
processCtorDetails(ReadOnlyList<ReflHTML<Constructor>> constructorDetails)
default void
processECDetails(ReadOnlyList<ReflHTML<EnumConstant>> ecDetails)
default void
processFieldDetails(ReadOnlyList<ReflHTML<Field>> fieldDetails)
default void
processMethodDetails(ReadOnlyList<ReflHTML<Method>> methodDetails)
-
-
-
Method Detail
-
process
default void process(JavaDocHTMLFile jdhf)
Process a complete Java-Doc Generated Web-Page- Parameters:
jdhf
- An instance of the fully parsed HTML Page.
-
processHeaderFooter
default void processHeaderFooter(HeaderFooterHTML headerFooter)
Interface' hook method for performing HTML-Processing on the Header & Footer parts of a JavaDoc Generated Web-Page.- Parameters:
headerFooter
- The Header-Footer HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.headerFooter
.- See Also:
JavaDocHTMLFile.headerFooter
-
processFieldSumm
default void processFieldSumm(SummaryTableHTML<Field> fieldSummaries)
Interface' hook method for performing HTML-Processing on the Field Summary Table of a JavaDoc Generated Web-Page.- Parameters:
fieldSummaries
- The Field Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.fieldSummaryTable
.- See Also:
JavaDocHTMLFile.fieldSummaryTable
-
processCtorSumm
default void processCtorSumm (SummaryTableHTML<Constructor> constructorSummaries)
Interface' hook method for performing HTML-Processing on the Constructor Summary Table of a JavaDoc Generated Web-Page.- Parameters:
constructorSummaries
- The Constructor Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.constructorSummaryTable
.- See Also:
JavaDocHTMLFile.constructorSummaryTable
-
processMethodSumm
default void processMethodSumm(SummaryTableHTML<Method> methodSummaries)
Interface' hook method for performing HTML-Processing on the Method Summary Table of a JavaDoc Generated Web-Page.- Parameters:
methodSummaries
- The Method Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.methodSummaryTable
.- See Also:
JavaDocHTMLFile.methodSummaryTable
-
processECSumm
default void processECSumm(SummaryTableHTML<EnumConstant> ecSummaries)
Interface' hook method for performing HTML-Processing on the Enum-Constant Summary Table of a JavaDoc Generated Web-Page.
NOTE: The vast majority of Java Type's (CIET's) will not have any "Enum Constants" - and would therefore not have an Enum-Constant Summary Table! Only Javaenum's
may have such constants defined.- Parameters:
ecSummaries
- The Enum-Constant Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.ecSummaryTable
.- See Also:
JavaDocHTMLFile.ecSummaryTable
-
processAESumm
default void processAESumm(SummaryTableHTML<AnnotationElem> oaeSummaries, SummaryTableHTML<AnnotationElem> raeSummaries)
Interface' hook method for performing HTML-Processing on the Annotation-Element Summary Table of a JavaDoc Generated Web-Page.
NOTE: The vast majority of Java Type's (CIET's) will not have any "Annotation Elements" - and would therefore not have an Annotation Element Summary Table! Only Java@annotations
may have such elements defined.- Parameters:
oaeSummaries
- The Annotation-Element Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.oaeSummaryTable
.raeSummaries
- The Annotation-Element Summary Table HTML
NOTE: An instance of this object may also be obtained by referencing the fieldJavaDocHTMLFile.raeSummaryTable
.- See Also:
JavaDocHTMLFile.oaeSummaryTable
,JavaDocHTMLFile.raeSummaryTable
-
processFieldDetails
default void processFieldDetails (ReadOnlyList<ReflHTML<Field>> fieldDetails)
Interface' hook method for performing HTML-Processing on each Field "Detail HTML Segment" (the explanation portion) of a JavaDoc Generated Web-Page.- Parameters:
fieldDetails
- A JavaReadOnlyList
ofReflHTML
Object-Instances, each containing all details (as categorized HTML) about a single Java Field.
-
processCtorDetails
default void processCtorDetails (ReadOnlyList<ReflHTML<Constructor>> constructorDetails)
Interface' hook method for performing HTML-Processing on each Constructor "Detail HTML Segment" (the explanation portion) of a JavaDoc Generated Web-Page.- Parameters:
constructorDetails
- A JavaReadOnlyList
ofReflHTML
Object-Instances, each containing all details (as categorized HTML) about a single Java Constructor.
-
processMethodDetails
default void processMethodDetails (ReadOnlyList<ReflHTML<Method>> methodDetails)
Interface' hook method for performing HTML-Processing on each Method "Detail HTML Segment" (the explanation portion) of a JavaDoc Generated Web-Page.- Parameters:
methodDetails
- A JavaReadOnlyList
ofReflHTML
Object-Instances, each containing all details (as categorized HTML) about a single Java Method.
-
processECDetails
default void processECDetails (ReadOnlyList<ReflHTML<EnumConstant>> ecDetails)
Interface' hook method for performing HTML-Processing on each Enum-Constant "Detail HTML Segment" (the explanation portion) of a JavaDoc Generated Web-Page.
Extremely Uncommon:
The vast majority of Java Type's (CIET's) will not have any "Enum Constants" - and would therefore not have an Annotation Element Detail HTML Block! Only Javaenum
may have such constants defined.- Parameters:
ecDetails
- A JavaReadOnlyList
ofReflHTML
Object-Instances, each containing all details (as categorized HTML) about a single Java Enum-Constant.
-
processAEDetails
default void processAEDetails (ReadOnlyList<ReflHTML<AnnotationElem>> aeDetails)
Interface' hook method for performing HTML-Processing on each Annotation-Element "Detail HTML Segment" (the explanation portion) of a JavaDoc Generated Web-Page.
Extremely Uncommon:
The vast majority of Java Type's (CIET's) will not have any "Annotation Elements" - and would therefore not have an Annotation Element Detail HTML Block! Only Java@annotations
may have such elements defined.- Parameters:
aeDetails
- A JavaReadOnlyList
ofReflHTML
Object-Instances, each containing all details (as categorized HTML) about a single Java Annotation-Element.
-
-