Class ClassLocation

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.lang.String className  
      private java.lang.String classXmlName  
    • Constructor Summary

      Constructors 
      Constructor Description
      ClassLocation​(java.lang.String packageName, java.lang.String className, java.lang.String classXmlName)
      Creates a new ClassLocation with the supplied package and class names.
    • Field Detail

      • className

        private java.lang.String className
      • classXmlName

        private java.lang.String classXmlName
    • Constructor Detail

      • ClassLocation

        public ClassLocation​(java.lang.String packageName,
                             java.lang.String className,
                             java.lang.String classXmlName)
        Creates a new ClassLocation with the supplied package and class names.
        Parameters:
        packageName - The name of the package for a class potentially holding JavaDoc. Cannot be null.
        classXmlName - The name given as the XmlType.name() value of an annotation placed on the Class, or null if none is provided.
        className - The (simple) name of a class. Cannot be null or empty.
    • Method Detail

      • getClassName

        public java.lang.String getClassName()
        Retrieves the simple class name for the class potentially holding JavaDoc. Never null or empty.
        Returns:
        The simple class name for the class potentially holding JavaDoc. Never null or empty.
      • getPath

        public java.lang.String getPath()
        Always appends the effective className to the path from the superclass PackageLocation. If the getAnnotationRenamedTo() method returns a non-null value, that value is the effective className. Otherwise, the getClassName() method is used as the effective className. This is to handle renames such as provided in a XmlType annotation's XmlType.name() attribute value.
        Specified by:
        getPath in interface SortableLocation
        Overrides:
        getPath in class PackageLocation
        Returns:
        the path of the PackageLocation superclass, appended with the effective className.
        See Also:
        XmlType, XmlAttribute.name(), XmlElement.name()
      • getAnnotationRenamedTo

        public java.lang.String getAnnotationRenamedTo()
        Note: Packages cannot be renamed from a JAXB annotation. Retrieves the value of the name attribute provided by a JAXB annotation, implying that the XSD type should use another name than the default.
        Specified by:
        getAnnotationRenamedTo in interface SortableLocation
        Overrides:
        getAnnotationRenamedTo in class PackageLocation
        Returns:
        the value of the name attribute provided by a JAXB annotation relevant to this SortableLocation.
        See Also:
        XmlElement.name(), XmlAttribute.name(), XmlType.name()