Package org.jdom

Class DocType

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Cloneable

    public class DocType
    extends Content
    An XML DOCTYPE declaration. Method allow the user to get and set the root element name, public id, and system id.
    Version:
    $Revision: 1.32 $, $Date: 2007/11/10 05:28:58 $
    Author:
    Brett McLaughlin, Jason Hunter
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected java.lang.String elementName
      The element being constrained
      protected java.lang.String internalSubset
      The internal subset of the DOCTYPE
      protected java.lang.String publicID
      The public ID of the DOCTYPE
      protected java.lang.String systemID
      The system ID of the DOCTYPE
    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      protected DocType()
      Default, no-args constructor for implementations to use if needed.
        DocType​(java.lang.String elementName)
      This will create the DocType with the specified element name
        DocType​(java.lang.String elementName, java.lang.String systemID)
      This will create the DocType with the specified element name and reference to an external DTD.
        DocType​(java.lang.String elementName, java.lang.String publicID, java.lang.String systemID)
      This will create the DocType with the specified element name and a reference to an external DTD.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getElementName()
      This will retrieve the element name being constrained.
      java.lang.String getInternalSubset()
      This returns the data for the internal subset.
      java.lang.String getPublicID()
      This will retrieve the public ID of an externally referenced DTD, or an empty String if none is referenced.
      java.lang.String getSystemID()
      This will retrieve the system ID of an externally referenced DTD, or an empty String if none is referenced.
      java.lang.String getValue()
      Returns the empty string since doctypes don't have an XPath 1.0 string value.
      DocType setElementName​(java.lang.String elementName)
      This will set the root element name declared by this DOCTYPE declaration.
      void setInternalSubset​(java.lang.String newData)
      This sets the data for the internal subset.
      DocType setPublicID​(java.lang.String publicID)
      This will set the public ID of an externally referenced DTD.
      DocType setSystemID​(java.lang.String systemID)
      This will set the system ID of an externally referenced DTD.
      java.lang.String toString()
      This returns a String representation of the DocType, suitable for debugging.
      • Methods inherited from class java.lang.Object

        finalize, getClass, notify, notifyAll, wait, wait, wait
    • Field Detail

      • elementName

        protected java.lang.String elementName
        The element being constrained
      • publicID

        protected java.lang.String publicID
        The public ID of the DOCTYPE
      • systemID

        protected java.lang.String systemID
        The system ID of the DOCTYPE
      • internalSubset

        protected java.lang.String internalSubset
        The internal subset of the DOCTYPE
    • Constructor Detail

      • DocType

        protected DocType()
        Default, no-args constructor for implementations to use if needed.
      • DocType

        public DocType​(java.lang.String elementName,
                       java.lang.String publicID,
                       java.lang.String systemID)
        This will create the DocType with the specified element name and a reference to an external DTD.
        Parameters:
        elementName - String name of element being constrained.
        publicID - String public ID of referenced DTD
        systemID - String system ID of referenced DTD
        Throws:
        IllegalDataException - if the given system ID is not a legal system literal or the public ID is not a legal public ID.
        IllegalNameException - if the given root element name is not a legal XML element name.
      • DocType

        public DocType​(java.lang.String elementName,
                       java.lang.String systemID)
        This will create the DocType with the specified element name and reference to an external DTD.
        Parameters:
        elementName - String name of element being constrained.
        systemID - String system ID of referenced DTD
        Throws:
        IllegalDataException - if the given system ID is not a legal system literal.
        IllegalNameException - if the given root element name is not a legal XML element name.
      • DocType

        public DocType​(java.lang.String elementName)
        This will create the DocType with the specified element name
        Parameters:
        elementName - String name of element being constrained.
        Throws:
        IllegalNameException - if the given root element name is not a legal XML element name.
    • Method Detail

      • getElementName

        public java.lang.String getElementName()
        This will retrieve the element name being constrained.
        Returns:
        String - element name for DOCTYPE
      • setElementName

        public DocType setElementName​(java.lang.String elementName)
        This will set the root element name declared by this DOCTYPE declaration.
        Parameters:
        elementName - String name of root element being constrained.
        Returns:
        DocType DocType this DocType object
        Throws:
        IllegalNameException - if the given root element name is not a legal XML element name.
      • getPublicID

        public java.lang.String getPublicID()
        This will retrieve the public ID of an externally referenced DTD, or an empty String if none is referenced.
        Returns:
        String - public ID of referenced DTD.
      • setPublicID

        public DocType setPublicID​(java.lang.String publicID)
        This will set the public ID of an externally referenced DTD.
        Parameters:
        publicID - id to set
        Returns:
        DocType DocType this DocType object
        Throws:
        IllegalDataException - if the given public ID is not a legal public ID.
      • getSystemID

        public java.lang.String getSystemID()
        This will retrieve the system ID of an externally referenced DTD, or an empty String if none is referenced.
        Returns:
        String - system ID of referenced DTD.
      • setSystemID

        public DocType setSystemID​(java.lang.String systemID)
        This will set the system ID of an externally referenced DTD.
        Parameters:
        systemID - id to set
        Returns:
        systemID String system ID of referenced DTD.
        Throws:
        IllegalDataException - if the given system ID is not a legal system literal.
      • getValue

        public java.lang.String getValue()
        Returns the empty string since doctypes don't have an XPath 1.0 string value.
        Specified by:
        getValue in class Content
        Returns:
        the empty string
      • setInternalSubset

        public void setInternalSubset​(java.lang.String newData)
        This sets the data for the internal subset.
        Parameters:
        newData - data for the internal subset, as a String.
      • getInternalSubset

        public java.lang.String getInternalSubset()
        This returns the data for the internal subset.
        Returns:
        String - the internal subset
      • toString

        public java.lang.String toString()
        This returns a String representation of the DocType, suitable for debugging.
        Overrides:
        toString in class java.lang.Object
        Returns:
        String - information about the DocType