Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.jdom
Class DocType

    java.lang.Object
      org.jdom.Content
          org.jdom.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.

See Also:
  Serialized Form

Field Summary
`private static java.lang.String` | `CVS_ID`
`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

Fields inherited from class org.jdom.Content
`parent`

Constructor Summary
`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
`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 org.jdom.Content
`clone, detach, equals, getDocument, getParent, getParentElement, hashCode, setParent`

Methods inherited from class java.lang.Object
`finalize, getClass, notify, notifyAll, wait, wait, wait`

Field Detail

### CVS_ID

    private static final java.lang.String CVS_ID

See Also:
  Constant Field Values

### 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`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD