Package org.jdom2

Interface JDOMFactory

All Known Implementing Classes:
DefaultJDOMFactory, LocatedJDOMFactory, SlimJDOMFactory, UncheckedJDOMFactory

public interface JDOMFactory
An interface to be used by builders when constructing JDOM objects. The DefaultJDOMFactory creates the standard top-level JDOM classes (Element, Document, Comment, etc). Another implementation of this factory could be used to create custom classes.
Author:
Ken Rune Holland, Phil Nelson, Bradley S. Huffman, Rolf Lear
  • Method Details

    • attribute

      Attribute attribute(String name, String value, Namespace namespace)

      This will create a new Attribute with the specified (local) name and value, and in the provided Namespace.

      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      namespace - Namespace of the new Attribute
      Returns:
      the created Attribute instance
    • attribute

      @Deprecated Attribute attribute(String name, String value, int type, Namespace namespace)
      This will create a new Attribute with the specified (local) name, value, and type, and in the provided Namespace.
      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      type - int type for new attribute.
      namespace - Namespace namespace for new attribute.
      Returns:
      the created Attribute instance
    • attribute

      Attribute attribute(String name, String value, AttributeType type, Namespace namespace)
      This will create a new Attribute with the specified (local) name, value, and type, and in the provided Namespace.
      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      type - AttributeType type for new attribute.
      namespace - Namespace namespace for new attribute.
      Returns:
      the created Attribute instance
    • attribute

      Attribute attribute(String name, String value)
      This will create a new Attribute with the specified (local) name and value, and does not place the attribute in a Namespace.

      Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).

      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      Returns:
      the created Attribute instance
    • attribute

      @Deprecated Attribute attribute(String name, String value, int type)
      This will create a new Attribute with the specified (local) name, value and type, and does not place the attribute in a Namespace.

      Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).

      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      type - int type for new attribute.
      Returns:
      the created Attribute instance
    • attribute

      Attribute attribute(String name, String value, AttributeType type)
      This will create a new Attribute with the specified (local) name, value and type, and does not place the attribute in a Namespace.

      Note: This actually explicitly puts the Attribute in the "empty" Namespace (Namespace.NO_NAMESPACE).

      Parameters:
      name - String name of Attribute.
      value - String value for new attribute.
      type - AttributeType type for new attribute.
      Returns:
      the created Attribute instance
    • cdata

      CDATA cdata(String str)
      This creates the CDATA with the supplied text.
      Parameters:
      str - String content of CDATA.
      Returns:
      the created CDATA instance
    • cdata

      CDATA cdata(int line, int col, String str)
      This creates the CDATA with the supplied text.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      str - String content of CDATA.
      Returns:
      the created CDATA instance
      Since:
      JDOM2
    • text

      Text text(int line, int col, String str)
      This creates the Text with the supplied text.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      str - String content of Text.
      Returns:
      the created Text instance
      Since:
      JDOM2
    • text

      Text text(String str)
      This creates the Text with the supplied text.
      Parameters:
      str - String content of Text.
      Returns:
      the created Text instance
    • comment

      Comment comment(String text)
      This creates the comment with the supplied text.
      Parameters:
      text - String content of comment.
      Returns:
      the created Comment instance
    • comment

      Comment comment(int line, int col, String text)
      This creates the comment with the supplied text.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      text - String content of comment.
      Returns:
      the created Comment instance
      Since:
      JDOM2
    • docType

      DocType docType(String elementName, String publicID, 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
      Returns:
      the created DocType instance
    • docType

      DocType docType(String elementName, 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
      Returns:
      the created DocType instance
    • docType

      DocType docType(String elementName)
      This will create the DocType with the specified element name
      Parameters:
      elementName - String name of element being constrained.
      Returns:
      the created DocType instance
    • docType

      DocType docType(int line, int col, String elementName, String publicID, String systemID)
      This will create the DocType with the specified element name and a reference to an external DTD.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      elementName - String name of element being constrained.
      publicID - String public ID of referenced DTD
      systemID - String system ID of referenced DTD
      Returns:
      the created DocType instance
      Since:
      JDOM2
    • docType

      DocType docType(int line, int col, String elementName, String systemID)
      This will create the DocType with the specified element name and reference to an external DTD.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      elementName - String name of element being constrained.
      systemID - String system ID of referenced DTD
      Returns:
      the created DocType instance
      Since:
      JDOM2
    • docType

      DocType docType(int line, int col, String elementName)
      This will create the DocType with the specified element name
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      elementName - String name of element being constrained.
      Returns:
      the created DocType instance
      Since:
      JDOM2
    • document

      Document document(Element rootElement, DocType docType)
      This will create a new Document, with the supplied Element as the root element and the supplied DocType declaration.
      Parameters:
      rootElement - Element for document root.
      docType - DocType declaration.
      Returns:
      the created Document instance
    • document

      Document document(Element rootElement, DocType docType, String baseURI)
      This will create a new Document, with the supplied Element as the root element and the supplied DocType declaration.
      Parameters:
      rootElement - Element for document root.
      docType - DocType declaration.
      baseURI - the URI from which this document was loaded.
      Returns:
      the created Document instance
    • document

      Document document(Element rootElement)
      This will create a new Document, with the supplied Element as the root element, and no DocType declaration.
      Parameters:
      rootElement - Element for document root
      Returns:
      the created Document instance
    • element

      Element element(String name, Namespace namespace)
      This will create a new Element with the supplied (local) name, and define the Namespace to be used.
      Parameters:
      name - String name of element.
      namespace - Namespace to put element in.
      Returns:
      the created Element instance
    • element

      Element element(String name)
      This will create an Element in no Namespace.
      Parameters:
      name - String name of element.
      Returns:
      the created Element instance
    • element

      Element element(String name, String uri)
      This will create a new Element with the supplied (local) name, and specifies the URI of the Namespace the Element should be in, resulting it being unprefixed (in the default namespace).
      Parameters:
      name - String name of element.
      uri - String URI for Namespace element should be in.
      Returns:
      the created Element instance
    • element

      Element element(String name, String prefix, String uri)
      This will create a new Element with the supplied (local) name, and specifies the prefix and URI of the Namespace the Element should be in.
      Parameters:
      name - String name of element.
      prefix - the NamespacePrefic to use for this Element
      uri - String URI for Namespace element should be in.
      Returns:
      the created Element instance
    • element

      Element element(int line, int col, String name, Namespace namespace)
      This will create a new Element with the supplied (local) name, and define the Namespace to be used.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      namespace - Namespace to put element in.
      Returns:
      the created Element instance
      Since:
      JDOM2
    • element

      Element element(int line, int col, String name)
      This will create an Element in no Namespace.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      Returns:
      the created Element instance
      Since:
      JDOM2
    • element

      Element element(int line, int col, String name, String uri)
      This will create a new Element with the supplied (local) name, and specifies the URI of the Namespace the Element should be in, resulting it being unprefixed (in the default namespace).
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      uri - String URI for Namespace element should be in.
      Returns:
      the created Element instance
      Since:
      JDOM2
    • element

      Element element(int line, int col, String name, String prefix, String uri)
      This will create a new Element with the supplied (local) name, and specifies the prefix and URI of the Namespace the Element should be in.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      prefix - the NamespacePrefic to use for this Element
      uri - String URI for Namespace element should be in.
      Returns:
      the created Element instance
      Since:
      JDOM2
    • processingInstruction

      ProcessingInstruction processingInstruction(String target, Map<String,String> data)
      This will create a new ProcessingInstruction with the specified target and data.
      Parameters:
      target - String target of PI.
      data - Map data for PI, in name/value pairs
      Returns:
      the created ProcessingInstruction instance
    • processingInstruction

      ProcessingInstruction processingInstruction(String target, String data)
      This will create a new ProcessingInstruction with the specified target and data.
      Parameters:
      target - String target of PI.
      data - String data for PI.
      Returns:
      the created ProcessingInstruction instance
    • processingInstruction

      ProcessingInstruction processingInstruction(String target)
      This will create a new ProcessingInstruction with the specified target and no data.
      Parameters:
      target - String target of PI.
      Returns:
      the created ProcessingInstruction instance
    • processingInstruction

      ProcessingInstruction processingInstruction(int line, int col, String target, Map<String,String> data)
      This will create a new ProcessingInstruction with the specified target and data.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      target - String target of PI.
      data - Map data for PI, in name/value pairs
      Returns:
      the created ProcessingInstruction instance
      Since:
      JDOM2
    • processingInstruction

      ProcessingInstruction processingInstruction(int line, int col, String target, String data)
      This will create a new ProcessingInstruction with the specified target and data.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      target - String target of PI.
      data - String data for PI.
      Returns:
      the created ProcessingInstruction instance
      Since:
      JDOM2
    • processingInstruction

      ProcessingInstruction processingInstruction(int line, int col, String target)
      This will create a new ProcessingInstruction with the specified target and no data.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      target - String target of PI.
      Returns:
      the created ProcessingInstruction instance
      Since:
      JDOM2
    • entityRef

      EntityRef entityRef(String name)
      This will create a new EntityRef with the supplied name.
      Parameters:
      name - String name of element.
      Returns:
      the created EntityRef instance
    • entityRef

      EntityRef entityRef(String name, String publicID, String systemID)
      This will create a new EntityRef with the supplied name, public ID, and system ID.
      Parameters:
      name - String name of element.
      publicID - String public ID of element.
      systemID - String system ID of element.
      Returns:
      the created EntityRef instance
    • entityRef

      EntityRef entityRef(String name, String systemID)
      This will create a new EntityRef with the supplied name and system ID.
      Parameters:
      name - String name of element.
      systemID - String system ID of element.
      Returns:
      the created EntityRef instance
    • entityRef

      EntityRef entityRef(int line, int col, String name)
      This will create a new EntityRef with the supplied name.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      Returns:
      the created EntityRef instance
      Since:
      JDOM2
    • entityRef

      EntityRef entityRef(int line, int col, String name, String publicID, String systemID)
      This will create a new EntityRef with the supplied name, public ID, and system ID.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      publicID - String public ID of element.
      systemID - String system ID of element.
      Returns:
      the created EntityRef instance
      Since:
      JDOM2
    • entityRef

      EntityRef entityRef(int line, int col, String name, String systemID)
      This will create a new EntityRef with the supplied name and system ID.
      Parameters:
      line - The line on which this content begins.
      col - The column on the line at which this content begins.
      name - String name of element.
      systemID - String system ID of element.
      Returns:
      the created EntityRef instance
      Since:
      JDOM2
    • addContent

      void addContent(Parent parent, Content content)
      This will add the specified content to the specified parent instance
      Parameters:
      parent - The Parent to add the content to.
      content - The Content to add
    • setAttribute

      void setAttribute(Element element, Attribute a)
      Sets a specific Attribute on an Element
      Parameters:
      element - The Element to set the Attribute on
      a - The Attribute to set
    • addNamespaceDeclaration

      void addNamespaceDeclaration(Element element, Namespace additional)
      Adds a namespace declaration to an Element
      Parameters:
      element - The Element to add the Namespace to
      additional - The Namespace to add.
    • setRoot

      void setRoot(Document doc, Element root)
      Sets the 'root' Element for a Document.
      Parameters:
      doc - The Document to set the Root Element of.
      root - The Element to set as the root.