Class Constructor

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<Constructor>
    public class Constructor
extends Callable
implements java.io.Serializable, java.lang.Comparable<Constructor>, java.lang.Cloneable
    Similar to java.lang.reflect
    This class is heavily used internally, and can be used (if needed) to modify Java Doc Web-Pages, programmatically.

    HTML Processors that sort the Web-Page "Summary-Tables" will provide instances of this class to your Summary-Sorter Handler methods. Summary-Sorter handlers usually implement the SummarySorterHelper interface; please review that class for more about sorting Java-Doc Page Summary Tables.

    The HTML Processors that upgrade Web-Page "Detail Elements" also rely heavily on this class. Please review the class: ReflHTML for more information about Java-Doc Web-Page Detail Sections.
    Reflection Class:
    Holds all information extracted from '.java' Source-Files about Constructor's identified in that file.

    Instances of this Class are Obtained From: ReflHTML & SummaryTableHTML

    Use of the Reflection-HTML API is *NOT REQUIRED* to perform a standard Java Doc HTML File Upgrade. This "extra API" allows for programmatic modification of Java Doc HTML. This class contains quite a bit of reflected information, and furthermore, here there is a hook to the Native Java Parser Reflection Class.
    Class class Constructor allows for storing the name, definition, modifiers list, etc... of a constructor.
    See Also:
    Serialized Form


    • Field Detail

      • serialVersionUID

        🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public static final long serialVersionUID
        This fulfils the SerialVersion UID requirement for all classes that implement Java's interface java.io.Serializable. Using the Serializable Implementation offered by java is very easy, and can make saving program state when debugging a lot easier. It can also be used in place of more complicated systems like "hibernate" to store data as well.
        See Also:
        Constant Field Values
        Code:
        Exact Field Declaration Expression:
         public static final long serialVersionUID = 1;

      • methodTree

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public final transient com.sun.source.tree.MethodTree methodTree

        Hook Reference to Sun/Oracle Parser-Refletion Class

        Though this class offers a streamlined set of reflection features, the Native Oracle Library Reflection-Classes offer a detailed AST interface into the standard Java Compiler. If you would like to use these Tree's to provide further code analysis on your Java-Doc Pages, this field is provided as a convenience for such purposes.
        If a user decides to make use of the native Sun/Oracle MethodTree instance that was used to build this Constructor instance, it may be retrieved from this transient field.

        MethodTree Note:
        The package com.sun.source.tree "reuses" or "overloads" the MethodTree class. com.sun.source.tree.MethodTree can actually represent either a Method, or a Constructor.

        When a MethodTree instance is actually representing a constructor, the name that it uses for the instance will be Java-String '<init>', rather than an actual Method-Name.
        Code:
        Exact Field Declaration Expression:
         public final transient MethodTree methodTree;

    • Method Detail

      • toString

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public java.lang.String toString()
        Generates a string of this constructor, with most information included.

        Reduced Information:
        This 'toString' will not return every piece of information contained by this class. For example, both the constructor body, and any possible JavaDoc Comments are not included. For a more enhanced toString() method version, invoke the toString(PrintFlags) method which accepts Print-Flags.
        Overrides:
        toString in class Callable
        Returns:
        A printable string of this field.
        See Also:
        PF, toString(int)
        Code:
        Exact Method Body:
         return
     "Name:            [" + name + "]\n" +
     "Signature:       [" + StrPrint.abbrevEndRDSF(signature, MAX_STR_LEN, true) + "]\n" +
     "Modifiers:       [" + StrCSV.toCSV(modifiers, true, true, null) + "]\n" +
     printedParameterNamesTS() +
     printedParameterTypesTS() +
     printedExceptionsTS() +

     // This will **NEVER** be null - unless 'this' instance was built from an HTML File,
     // rather than a source-code file.  Instances like that are only used temporarily, and
     // are garbage collected instantly.  Do this check anyway (just in case).

     "Location:        " + ((this.location == null)
         ? "null" 
         : ('[' + this.location.quickSummary() + ']'));

      • toString

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public java.lang.String toString​(int flags)
        This method accepts a 'flags' parameter which has been constructed using the Bit-Masks provided by the PF class. Please view the Static-Constants which are provided by class PF for more information about modifying the return-value of this toString(int) method.
        Overrides:
        toString in class Callable
        Parameters:
        flags - These are defined in the Print-Flags class
        Returns:
        A printable String of this Constructor.
        See Also:
        toString(), PF
        Code:
        Exact Method Body:
         boolean color = (flags & UNIX_COLORS) > 0;

 return
     printedName("Constructor", 20, color) + 
     printedSignature(20, color) +
     printedModifiers(20) +
     printedParamNames() + 
     printedParamTypes(jowFlags(flags)) +
     printedExceptions() +
     printedLocation(20, color, (flags & BRIEF_LOCATION) > 0) +

     // The previous method does not add a '\n' end to the end of the returned string
     // These are both optional, they add a '\n' AT THE BEGINNING if one of them is included

     printedComments(20, color, (flags & JAVADOC_COMMENTS) > 0) +
     printedCallableBody(flags);

      • compareTo

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public int compareTo​(Constructor c)
        Java's interface Comparable<T> requirements. This looks at the number of parameters, and parameter types in making a sort-decision.
        Specified by:
        compareTo in interface java.lang.Comparable<Constructor>
        Parameters:
        c - Any other Constructor to be compared to 'this' Constructor
        Returns:
        An integer that fulfills Java's Comparable<Constructor> interface requirements.
        Code:
        Exact Method Body:
         if (this == c) return 0;

 int ret = this.numParameters() - c.numParameters();
 if (ret != 0) return ret;

 if (this.parameterTypesJOW != null)

     for (int i=0; i < this.parameterTypesJOW.size(); i++)
     {
         ret = this.parameterTypesJOW.get(i).compareTo(c.parameterTypesJOW.get(i));
         if (ret != 0) return ret;
     }

 return 0;

      • equals

        🡅  🡇  ⇈  ⮫ 🗕  🗗  🗖 
        public boolean equals​(Constructor other)
        This should be called an "atypical version" of the usual equals(Object other) constructor. This version of equals merely compares the name and parameters-list of the constructor. The presumption here is that the definition of a 'constructor' only has meaning - at all - inside the context of a class or enumerated-type where that constructor is defined. Since inside any '.java' source-code file, there may only be one constructor with a given parameter-list, this shall return TRUE whenever the constructor being compared has the same parameter types as 'this' does.
        Parameters:
        other - This may be any other constructor. It is strongly suggested that this be a constructor defined in the same '.java' source-code file as 'this' constructor.
        Returns:
        This method returns TRUE when 'this' instance of Constructor has the same parameter-list as 'other'.
        Code:
        Exact Method Body:
         // If the number of parameters in the 'other' instance of Constructor differ from the
 // number of parameters in 'this' Constructor, then return FALSE immediately.  It cannot be
 // a match

 if (this.numParameters() != other.numParameters()) return false;

 // If there are no parameters (for either of them), then return true immediately
 if (this.numParameters() == 0) return true;

 // If any of the parameter-names are different, break immediately and return false;
 for (int i=0; i < this.parameterNames.size(); i++)
     if (! this.parameterNames.get(i).equals(other.parameterNames.get(i)))
         return false;

    
 // If the parameter-types listed by the javadoc '.html' file differ from parameter-types
 // listed in the original '.java' source-code file, then break immediately.
 //
 // NOTE: The "package-information" for the FULL CLASS OR INTERFACE NAME is not always
 // available.

 for (int i=0; i < this.parameterTypes.size(); i++)
     if (! this.parameterTypesJOW.get(i).equals(other.parameterTypesJOW.get(i)))
         return false;

 // ALL TESTS PASSED
 return true;

      • getTokenStreams

        🡅  ⇈  ⮫ 🗕  🗗  🗖 
        public ReadOnlyList<ReadOnlyList<java.lang.String>> getTokenStreams()
        Description copied from class: Declaration
        Chat-GPT and me wrote a Token-Stream Generator-Method that can be used for creating the List-Data that needs to be sent to the Embeddings-Generator for creating an Embeddings-RAG using my Reflection-Classes.
        Specified by:
        getTokenStreams in class Declaration
        Returns:
        A proper list of "Chunked Tokens" that may be sent to the Open-AI REST-API to generate an Embeddings-Vector
        Code:
        Exact Method Body:
         final ROArrayListBuilder<ReadOnlyList<String>>  tokens  = new ROArrayListBuilder<>();
 ROArrayListBuilder<String>                      b       = new ROArrayListBuilder<>();

 tokens.add(ReadOnlyList.of("SECTION", "entity", "constructor"));
 tokens.add(ReadOnlyList.of("SECTION", "signature", this.signature));

 if ((this.parameterNames != null) && (this.parameterNames.size() > 0))
 {
     b.add("SECTION");
     b.add("parameters");
     for (int i = 0; i < this.parameterNames.size(); i++)
         b.add(this.parameterTypesJOW.get(i) + " " + this.parameterNames.get(i));
     tokens.add(b.build());
 }

 if ((this.modifiers != null) && (modifiers.size() > 0))
 {
     b = new ROArrayListBuilder<>();
     b.add("SECTION");
     b.add("modifiers");
     for (String m : this.modifiers) b.add(m);
     tokens.add(b.build());
 }

 if ((this.exceptions != null) && (this.exceptions.size() > 0))
 {
     b = new ROArrayListBuilder<>();
     b.add("SECTION");
     b.add("throws");
     for (String exn : this.exceptions) b.add(exn);
     tokens.add(b.build());
 }

 if ((this.annotations != null) && (annotations.size() > 0))
 {
     b = new ROArrayListBuilder<>();
     b.add("SECTION");
     b.add("annotations");
     for (String a : this.annotations) b.add(a);
     tokens.add(b.build());
 }

 return tokens.build();