Class DocumentRenderingContext


  • public class DocumentRenderingContext
    extends java.lang.Object
    The rendering context of a document. If not rendered from a Doxia markup source, parserId and extension will be null.
    Since:
    1.5 (was since 1.1 in o.a.m.d.sink.render)
    Author:
    Jason van Zyl
    • Constructor Summary

      Constructors 
      Constructor Description
      DocumentRenderingContext​(java.io.File basedir, java.lang.String document, java.lang.String generator)
      Constructor for rendering context when document is not rendered from a Doxia markup source.
      DocumentRenderingContext​(java.io.File basedir, java.lang.String basedirRelativePath, java.lang.String document, java.lang.String parserId, java.lang.String extension, boolean editable)  
      DocumentRenderingContext​(java.io.File basedir, java.lang.String basedirRelativePath, java.lang.String document, java.lang.String parserId, java.lang.String extension, boolean editable, java.lang.String generator)
      Constructor for document rendering context.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      java.lang.String getAttribute​(java.lang.String key)
      getAttribute.
      java.io.File getBasedir()
      Getter for the field basedir.
      java.lang.String getBasedirRelativePath()
      Get the relative path of basedir (when a Doxia source)
      java.lang.String getDoxiaSourcePath()
      Get the relative path to Doxia source from build root.
      java.lang.String getDoxiaSourcePath​(java.lang.String base)
      Get url of the Doxia source calculate from given base url.
      java.lang.String getExtension()
      Get the source document filename extension (when a Doxia source)
      java.lang.String getGenerator()
      What is the generator (if any)?
      java.lang.String getInputName()
      Deprecated.
      Method name does not properly reflect its purpose.
      java.lang.String getInputPath()
      Getter for the field inputPath.
      java.lang.String getOutputName()
      Deprecated.
      Method name does not properly reflect its purpose.
      java.lang.String getOutputPath()
      Get html output path, relative to site root.
      java.lang.String getParserId()
      Get the parserId when document comes from a Doxia source.
      java.lang.String getRelativePath()
      Get the relative path to site root.
      boolean isDoxiaSource()
      Is the document rendered from a Doxia source?
      boolean isEditable()
      Is the source document editable?
      void setAttribute​(java.lang.String key, java.lang.String value)
      setAttribute.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • DocumentRenderingContext

        public DocumentRenderingContext​(java.io.File basedir,
                                        java.lang.String document,
                                        java.lang.String generator)

        Constructor for rendering context when document is not rendered from a Doxia markup source.

        Parameters:
        basedir - the pseudo-source base directory.
        document - the pseudo-source document path: will be used to compute output path (same path with extension replaced with .html).
        generator - the generator (in general a reporting goal: groupId:artifactId:version:goal)
        Since:
        1.8
      • DocumentRenderingContext

        public DocumentRenderingContext​(java.io.File basedir,
                                        java.lang.String basedirRelativePath,
                                        java.lang.String document,
                                        java.lang.String parserId,
                                        java.lang.String extension,
                                        boolean editable)
      • DocumentRenderingContext

        public DocumentRenderingContext​(java.io.File basedir,
                                        java.lang.String basedirRelativePath,
                                        java.lang.String document,
                                        java.lang.String parserId,
                                        java.lang.String extension,
                                        boolean editable,
                                        java.lang.String generator)

        Constructor for document rendering context.

        Parameters:
        basedir - the source base directory (not null, pseudo value when not a Doxia source).
        basedirRelativePath - the relative path from root (null if not Doxia source)
        document - the source document path.
        parserId - the Doxia module parser id associated to this document, may be null if document not rendered from a Doxia source.
        extension - the source document filename extension, may be null if document not rendered from a Doxia source.
        editable - is the document editable as source, i.e. not generated?
        generator - the generator (in general a reporting goal: groupId:artifactId:version:goal)
        Since:
        1.8
    • Method Detail

      • getBasedir

        public java.io.File getBasedir()

        Getter for the field basedir.

        Returns:
        a File object.
      • getInputPath

        public java.lang.String getInputPath()

        Getter for the field inputPath.

        Returns:
        a String object.
      • getInputName

        @Deprecated
        public java.lang.String getInputName()
        Deprecated.
        Method name does not properly reflect its purpose. Use getInputPath() instead.
      • getOutputPath

        public java.lang.String getOutputPath()
        Get html output path, relative to site root.
        Returns:
        html output path
        See Also:
        PathTool.getRelativePath(String)
      • getOutputName

        @Deprecated
        public java.lang.String getOutputName()
        Deprecated.
        Method name does not properly reflect its purpose. Use getOutputPath() instead.
      • getParserId

        public java.lang.String getParserId()
        Get the parserId when document comes from a Doxia source.
        Returns:
        parser id, or null if not froma DOxia source.
      • getRelativePath

        public java.lang.String getRelativePath()
        Get the relative path to site root.
        Returns:
        the relative path to site root
      • setAttribute

        public void setAttribute​(java.lang.String key,
                                 java.lang.String value)

        setAttribute.

        Parameters:
        key - a String object.
        value - a String object.
      • getAttribute

        public java.lang.String getAttribute​(java.lang.String key)

        getAttribute.

        Parameters:
        key - a String object.
        Returns:
        a String object.
      • getExtension

        public java.lang.String getExtension()
        Get the source document filename extension (when a Doxia source)
        Returns:
        the source document filename extension when a Doxia source, or null if not a Doxia source
      • isEditable

        public boolean isEditable()
        Is the source document editable?
        Returns:
        true if comes from an editable Doxia source (not generated one).
        Since:
        1.8
      • isDoxiaSource

        public boolean isDoxiaSource()
        Is the document rendered from a Doxia source?
        Returns:
        true if comes from a Doxia source.
        Since:
        1.8
      • getGenerator

        public java.lang.String getGenerator()
        What is the generator (if any)?
        Returns:
        null if no known generator
        Since:
        1.8
      • getBasedirRelativePath

        public java.lang.String getBasedirRelativePath()
        Get the relative path of basedir (when a Doxia source)
        Returns:
        the relative path of basedir when a Doxia source, or null if not a Doxia source
        Since:
        1.8
      • getDoxiaSourcePath

        public java.lang.String getDoxiaSourcePath()
        Get the relative path to Doxia source from build root.
        Returns:
        the relative path to Doxia source from build root, or null if not a Doxia source
        Since:
        1.8
      • getDoxiaSourcePath

        public java.lang.String getDoxiaSourcePath​(java.lang.String base)
        Get url of the Doxia source calculate from given base url.
        Parameters:
        base - the base url to use
        Returns:
        the resulting url
        Since:
        1.8