Package org.apache.wiki.parser

Class MarkupParser

    • Constructor Detail

      • MarkupParser

        protected MarkupParser​(Context context,
                       java.io.Reader in)
        Constructs a MarkupParser. The subclass must call this constructor to set up the necessary bits and pieces.
        Parameters:
        context - The WikiContext.
        in - The reader from which we are reading the bytes from.

    • Method Detail

      • setInputReader

        public java.io.Reader setInputReader​(java.io.Reader in)
        Replaces the current input character stream with a new one.
        Parameters:
        in - New source for input. If null, this method does nothing.
        Returns:
        the old stream

      • addLinkTransmutator

        public void addLinkTransmutator​(StringTransmutator mutator)
        Adds a hook for processing link texts. This hook is called when the link text is written into the output stream, and you may use it to modify the text. It does not affect the actual link, only the user-visible text.
        Parameters:
        mutator - The hook to call. Null is safe.

      • addLocalLinkHook

        public void addLocalLinkHook​(StringTransmutator mutator)
        Adds a hook for processing local links. The engine transforms both non-existing and existing page links.
        Parameters:
        mutator - The hook to call. Null is safe.

      • addExternalLinkHook

        public void addExternalLinkHook​(StringTransmutator mutator)
        Adds a hook for processing external links. This includes all http:// ftp://, etc. links, including inlined images.
        Parameters:
        mutator - The hook to call. Null is safe.

      • addHeadingListener

        public void addHeadingListener​(HeadingListener listener)
        Adds a HeadingListener to the parser chain. It will be called whenever a parsed header is found.
        Parameters:
        listener - The listener to add.

      • enableImageInlining

        public void enableImageInlining​(boolean toggle)
        Use this to turn on or off image inlining.
        Parameters:
        toggle - If true, images are inlined (as per set in jspwiki.properties) If false, then images won't be inlined; instead, they will be treated as standard hyperlinks.
        Since:
        2.2.9

      • parse

        public abstract WikiDocument parse()
                            throws java.io.IOException
        Parses the document.
        Returns:
        the parsed document, as a WikiDocument
        Throws:
        java.io.IOException - If something goes wrong.

      • getPosition

        public int getPosition()
        Return the current position in the reader stream. The value will be -1 prior to reading.
        Returns:
        the reader position as an int.

      • nextToken

        protected final int nextToken()
                       throws java.io.IOException,
                              java.lang.NullPointerException
        Returns the next token in the stream. This is the most called method in the entire parser, so it needs to be lean and mean.
        Returns:
        The next token in the stream; or, if the stream is ended, -1.
        Throws:
        java.io.IOException - If something bad happens
        java.lang.NullPointerException - If you have not yet created an input document.

      • pushBack

        protected void pushBack​(int c)
                 throws java.io.IOException
        Push back any character to the current input. Does not push back a read EOF, though.
        Parameters:
        c - Character to push back.
        Throws:
        java.io.IOException - In case the character cannot be pushed back.

      • makeError

        public static org.jdom2.Element makeError​(java.lang.String error)
        Writes HTML for error message. Does not add it to the document, you have to do it yourself.
        Parameters:
        error - The error string.
        Returns:
        An Element containing the error.

      • cleanLink

        public static java.lang.String cleanLink​(java.lang.String link)
        Cleans a Wiki name. The functionality of this method was changed in 2.6 so that the list of allowed characters is much larger. Use wikifyLink(String) to get the legacy behaviour.

        [ This is a link ] -> This is a link

        Parameters:
        link - Link to be cleared. Null is safe, and causes this to return null.
        Returns:
        A cleaned link.
        Since:
        2.0

      • wikifyLink

        public static java.lang.String wikifyLink​(java.lang.String link)
        Cleans away extra legacy characters. This method functions exactly like pre-2.6 cleanLink()

        [ This is a link ] -> ThisIsALink

        Parameters:
        link - Link to be cleared. Null is safe, and causes this to return null.
        Returns:
        A cleaned link.
        Since:
        2.6