Class DocumentFormatter

java.lang.Object
org.jibx.schema.generator.DocumentFormatter
All Implemented Interfaces:
IDocumentFormatter

public class DocumentFormatter extends Object implements IDocumentFormatter
Formatter for JavaDoc conversion to XML documentation components.
  • Field Details

    • m_document

      private final Document m_document
      Document used for constructing DOM components.
  • Constructor Details

    • DocumentFormatter

      public DocumentFormatter()
      Constructor.
  • Method Details

    • reformDocSegment

      protected Node reformDocSegment(String jdoc)
      Reformat a segment of JavaDoc text as either a CDATA section (if it contains embedded HTML tags) or a simple text node. This also replaces line breaks with single spaces, so that the output format will not use indenting based on the original supplied text.
      Parameters:
      jdoc - raw JavaDoc text
      Returns:
      formatted text
    • docToNodes

      public List docToNodes(String jdoc)
      Convert JavaDoc text to a list of formatted nodes.
      Specified by:
      docToNodes in interface IDocumentFormatter
      Parameters:
      jdoc - JavaDoc text (may be null)
      Returns:
      formatted representation (may be null)
    • getClassDocumentation

      public List getClassDocumentation(IClass info)
      Get formatted documentation from class, in the form of a list of org.w3c.dom.Node instances.
      Specified by:
      getClassDocumentation in interface IDocumentFormatter
      Parameters:
      info - class information
      Returns:
      formatted documentation (null if none)
    • getItemDocumentation

      public List getItemDocumentation(IClassItem info)
      Get formatted documentation from class item, in the form of a list of org.w3c.dom.Node instances.
      Specified by:
      getItemDocumentation in interface IDocumentFormatter
      Parameters:
      info - item information
      Returns:
      formatted documentation (null if none)