Class DetailsPartConstructor


  • public class DetailsPartConstructor
    extends java.lang.Object
    JavaDoc Details-Part Constructor - Documentation.

    This will scour and retrieve the parts of a vectorized-HTML Java Class Documentation Method Definition for it's various sub-parts. Each JavaDoc generated HTML Page 'Constructor' details contains some or all of the following sections:

    • Constructor Name (always the same, i.e. the name of the class)
    • Constructor Signature
    • Constructor Description
    • Constructor Parameter Descriptions
    • Constructor Throws Types and Explanations
    • A 'see further' list of links

    The methods in this class will return the subsection as a DotPair pointer-pair, and it shall return null if this section was not found. These methods will throw an DetailsException if passed an invalid Method-HTML-Description part.

    USES, BENEFITS: Primarily, the three classes: DetailsPartConstructor, DetailsPartMethod and DetailsPartField is to help the user avoid trolling through the HTML-Source output of the JavaDoc utility. Having already done that, providing a simple method that can return an index-pointer (vector-location) to the entry or item in a standard JavaDoc Output Page - one could easily automate a build script to insert nicer, pretty-printed HTML-based explanations to further improve their code's documentation.




Stateless Class: This class neither contains any program-state, nor can it be instantiated.
The @StaticFunctional Annotation may also be called 'The Spaghetti Report'
  • 1 Constructor(s), 1 declared private, zero-argument constructor
  • 7 Method(s), 7 declared static
  • 0 Field(s)


    • Method Detail

      • name

        public static DotPair name​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor name vectorized-HTML.

        HTML Elements:
        1
        2
         <h4> [Class Name] </h4>
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Name' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, TagNodeFindInclusive, Details.constructorDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
         DetailsException.check(javaDocConstructorHTML);
         return TagNodeFindInclusive.first(javaDocConstructorHTML, "h4");
        
      • signature

        public static DotPair signature​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor signature vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <h4> [Class Name] </h4>
         <pre> ... </pre>
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Signature' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, TagNodeFindInclusive, Details.constructorDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
         DetailsException.check(javaDocConstructorHTML);
         return TagNodeFindInclusive.first(javaDocConstructorHTML, "pre");
        
      • description

        public static DotPair description​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor description vectorized-HTML.

        HTML Elements:
        1
        2
         <div class="block"> ... [Textual Description of Constructor] ... </div>
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Description' part.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        DetailsException, InnerTagFindInclusive, Details.constructorDetailsIterator(Vector)
        Code:
        Exact Method Body:
        1
        2
         DetailsException.check(javaDocConstructorHTML);
         return InnerTagFindInclusive.first(javaDocConstructorHTML, "div", "class", TextComparitor.C, "block");
        
      • parameters

        public static DotPair parameters​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor parameters vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <dt><span class="paramLabel">Parameters:</span></dt>
         <dd>...
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Parameters' part.

        Null will be returned if this HTML class description page for the Constructor that is passed does not contain a 'parameters' section.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        HELPER.getSpanSection(Vector, String)
        Code:
        Exact Method Body:
        1
         return HELPER.getSpanSection(javaDocConstructorHTML, "paramLabel");
        
      • throwing

        public static DotPair throwing​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor throws vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <dt><span class="throwsLabel">Throws:</span></dt>
         <dd>...
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Throws' part.

        Null will be returned if this HTML class description page for the Constructor that is passed does not contain a 'throws' section.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        HELPER.getSpanSection(Vector, String)
        Code:
        Exact Method Body:
        1
         return HELPER.getSpanSection(javaDocConstructorHTML, "throwsLabel");
        
      • see

        public static DotPair see​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor see also vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <dt><span class="seeLabel">See Also:</span></dt>
         <dd>...
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor See Also' part.

        Null will be returned if this HTML class description page for the Constructor that is passed does not contain a 'see also' section.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        HELPER.getSpanSection(Vector, String)
        Code:
        Exact Method Body:
        1
         return HELPER.getSpanSection(javaDocConstructorHTML, "seeLabel");
        
      • overrideSpecify

        public static DotPair overrideSpecify​
                    (java.util.Vector<HTMLNode> javaDocConstructorHTML)
        
        This method should be used in conjunction with Details.constructorDetailsIterator(javaDocPage);. The Iterator returned by that method will retrieve JavaDoc entries for the 'Constructor Details' in a JavaDoc generated vectorized-HTML web-page.

        This retrieves the constructor "Specified by" vectorized-HTML.

        HTML Elements:
        1
        2
        3
         <dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
         <dd>...
         
        
        Parameters:
        javaDocConstructorHTML - This should be the HTML sub-section of a JavaDoc '.html' page which describes the functionality of a single Constructor in a java class. It can be retrieved by a call to HNLIIterator.next() (after retrieving the HTML Inclusive Iterator for 'Constructor Details').
        Returns:
        DotPair pointing to HTML for the 'Constructor Specified By' part.

        Null will be returned if this HTML class description page for the Constructor that is passed does not contain a 'specified by' section.
        Throws:
        DetailsException - This does a quick check on each invocation to ensure that the vectorized-HTML parameter is actually a 'Constructor Details' section, retrieved via Details.constructorDetailsIterator(). The section may also be obtained manually (without using the Iterator), but the programmer must ensure the HTML start and end-points are the same as those returned by the Iterator.
        See Also:
        HELPER.getSpanSection(Vector, String)
        Code:
        Exact Method Body:
        1
         return HELPER.getSpanSection(javaDocConstructorHTML, "overrideSpecifyLabel");