WrappingListener (XWiki Rendering - Api 6.3-milestone-1 API)

java.lang.Object
- org.xwiki.rendering.listener.WrappingListener

All Implemented Interfaces:

ImageListener, LinkListener, Listener

Direct Known Subclasses:

InlineFilterListener
```
public class WrappingListener
extends Object
implements Listener
```
A Listener wrapping another Listener.

Version:

$Id: 0016999b8eefacfc0cf06c98c3f53d9ea8dd8129 $

Field Summary
- Fields inherited from interface org.xwiki.rendering.listener.Listener
  EMPTY_PARAMETERS

Constructor Summary

Constructors
Constructor and Description

WrappingListener()

Constructors
Constructor and Description
`WrappingListener()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`beginDefinitionDescription()` Start of a definition list description.
`void`	`beginDefinitionList(Map<String,String> parameters)` Start of a definition list.
`void`	`beginDefinitionTerm()` Start of a definition list term.
`void`	`beginDocument(MetaData metaData)` Start of the document.
`void`	`beginFormat(Format format, Map<String,String> parameters)` End of a text formatting block.
`void`	`beginGroup(Map<String,String> parameters)` Start a group of elements.
`void`	`beginHeader(HeaderLevel level, String id, Map<String,String> parameters)` Start of a header.
`void`	`beginLink(ResourceReference reference, boolean isFreeStandingURI, Map<String,String> parameters)` Start of a link.
`void`	`beginList(ListType listType, Map<String,String> parameters)` Start of a list.
`void`	`beginListItem()` Start of a list item.
`void`	`beginMacroMarker(String name, Map<String,String> parameters, String content, boolean isInline)` Start of marker containing a macro definition.
`void`	`beginMetaData(MetaData metadata)` Start of MetaData (eg saving source from where the content is coming from).
`void`	`beginParagraph(Map<String,String> parameters)` Start of a paragraph.
`void`	`beginQuotation(Map<String,String> parameters)` Start of a quotation.
`void`	`beginQuotationLine()` Start of a quotation line.
`void`	`beginSection(Map<String,String> parameters)` Start of a section.
`void`	`beginTable(Map<String,String> parameters)` Start of a table.
`void`	`beginTableCell(Map<String,String> parameters)` Start of a table cell.
`void`	`beginTableHeadCell(Map<String,String> parameters)` Start of a table head cell.
`void`	`beginTableRow(Map<String,String> parameters)` Start of a table row.
`void`	`endDefinitionDescription()` End of a definition list description.
`void`	`endDefinitionList(Map<String,String> parameters)` End of a definition list.
`void`	`endDefinitionTerm()` End of a definition list term.
`void`	`endDocument(MetaData metaData)` End of the document.
`void`	`endFormat(Format format, Map<String,String> parameters)` End of a text formatting block.
`void`	`endGroup(Map<String,String> parameters)` End of the group.
`void`	`endHeader(HeaderLevel level, String id, Map<String,String> parameters)` End of a header.
`void`	`endLink(ResourceReference reference, boolean isFreeStandingURI, Map<String,String> parameters)` End of a link.
`void`	`endList(ListType listType, Map<String,String> parameters)` End of a list.
`void`	`endListItem()` End of a list item.
`void`	`endMacroMarker(String name, Map<String,String> parameters, String content, boolean isInline)` End of marker containing a macro definition.
`void`	`endMetaData(MetaData metadata)` End of MetaData.
`void`	`endParagraph(Map<String,String> parameters)` End of a paragraph.
`void`	`endQuotation(Map<String,String> parameters)` End of a quotation.
`void`	`endQuotationLine()` End of a quotation line.
`void`	`endSection(Map<String,String> parameters)` End of a section.
`void`	`endTable(Map<String,String> parameters)` End of a table.
`void`	`endTableCell(Map<String,String> parameters)` End of a table cell.
`void`	`endTableHeadCell(Map<String,String> parameters)` End of a table head cell.
`void`	`endTableRow(Map<String,String> parameters)` End of a table row.
`Listener`	`getWrappedListener()`
`void`	`onEmptyLines(int count)` Represents an empty line between 2 standalone Blocks.
`void`	`onHorizontalLine(Map<String,String> parameters)` Represents an horizontal line.
`void`	`onId(String name)` A reference/location in a page.
`void`	`onImage(ResourceReference reference, boolean isFreeStandingURI, Map<String,String> parameters)` An image.
`void`	`onMacro(String id, Map<String,String> parameters, String content, boolean isInline)` A Macro.
`void`	`onNewLine()` A new line or line break (it's up to the renderers to decide if it should be outputted as a new line or as a line break in the given syntax).
`void`	`onRawText(String text, Syntax syntax)` Some text to inject directly into the listener output without parsing it.
`void`	`onSpace()` A space.
`void`	`onSpecialSymbol(char symbol)` A special symbol ("*", "<", ">", "=", quote, etc).
`void`	`onVerbatim(String protectedString, boolean isInline, Map<String,String> parameters)` A portion of text.
`void`	`onWord(String word)` A word.
`void`	`setWrappedListener(Listener listener)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - WrappingListener
```
public WrappingListener()
```
- Method Detail
  - setWrappedListener
```
public void setWrappedListener(Listener listener)
```
    Parameters:
    listener - the Listener to wrap
  - getWrappedListener
```
public Listener getWrappedListener()
```
    Returns:
    the Listener to wrap
  - beginDocument
```
public void beginDocument(MetaData metaData)
```
    Description copied from interface: Listener
    
    Start of the document.
    
    Specified by:
    
    beginDocument in interface Listener
    
    Parameters:
    metaData - the meta data to associate to the following events, see MetaData
  - endDocument
```
public void endDocument(MetaData metaData)
```
    Description copied from interface: Listener
    
    End of the document.
    
    Specified by:
    
    endDocument in interface Listener
    
    Parameters:
    metaData - the meta data associated with the previous events, see MetaData
  - beginGroup
```
public void beginGroup(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start a group of elements. Groups are used to allow using standalone elements in list items, table cells, etc. They can also be used to set parameters on a group of standalone elements.
    
    Specified by:
    
    beginGroup in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - endGroup
```
public void endGroup(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of the group.
    
    Specified by:
    
    endGroup in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - beginFormat
```
public void beginFormat(Format format,
               Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a text formatting block.
    
    Specified by:
    
    beginFormat in interface Listener
    
    Parameters:
    format - the formatting type (bold, italic, etc)
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    Format
  - beginList
```
public void beginList(ListType listType,
             Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a list.
    
    Specified by:
    
    beginList in interface Listener
    
    Parameters:
    listType - the type of list (bulleted, numbered, etc)
    parameters - a generic list of parameters for the list. Example: "style"/"background-color: blue"
    See Also:
    ListType
  - beginListItem
```
public void beginListItem()
```
    Description copied from interface: Listener
    
    Start of a list item.
    
    Specified by:
    
    beginListItem in interface Listener
  - beginMacroMarker
```
public void beginMacroMarker(String name,
                    Map<String,String> parameters,
                    String content,
                    boolean isInline)
```
    Description copied from interface: Listener
    
    Start of marker containing a macro definition. This is a special that Macro Blocks emits when they are executed so that it's possible to reconstruct the initial macro syntax even after Macros have been executed. This is used for exemple by the WYSIWYG editor to let use see the result of executing a macro and still let them modify the macro definition.
    
    Specified by:
    
    beginMacroMarker in interface Listener
    
    Parameters:
    name - the macro name
    parameters - the macro parameters
    content - the macro content
    isInline - if true the macro is located in a inline content (like paragraph, etc.)
    See Also:
    Listener.onMacro(String, java.util.Map, String, boolean)
  - beginParagraph
```
public void beginParagraph(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a paragraph.
    
    Specified by:
    
    beginParagraph in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - beginSection
```
public void beginSection(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a section.
    
    Specified by:
    
    beginSection in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    HeaderLevel
  - beginHeader
```
public void beginHeader(HeaderLevel level,
               String id,
               Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a header.
    
    Specified by:
    
    beginHeader in interface Listener
    
    Parameters:
    level - the header level (1, 2, 3, etc)
    id - the header unique identifier
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    HeaderLevel
  - endFormat
```
public void endFormat(Format format,
             Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a text formatting block.
    
    Specified by:
    
    endFormat in interface Listener
    
    Parameters:
    format - the formatting type (bold, italic, etc)
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    Format
  - endList
```
public void endList(ListType listType,
           Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a list.
    
    Specified by:
    
    endList in interface Listener
    
    Parameters:
    listType - the type of list (bulleted, numbered, etc)
    parameters - a generic list of parameters for the list. Example: "style"/"background-color: blue"
    See Also:
    ListType
  - endListItem
```
public void endListItem()
```
    Description copied from interface: Listener
    
    End of a list item.
    
    Specified by:
    
    endListItem in interface Listener
  - endMacroMarker
```
public void endMacroMarker(String name,
                  Map<String,String> parameters,
                  String content,
                  boolean isInline)
```
    Description copied from interface: Listener
    
    End of marker containing a macro definition.
    
    Specified by:
    
    endMacroMarker in interface Listener
    
    Parameters:
    name - the macro name
    parameters - the macro parameters
    content - the macro content
    isInline - if true the macro is located in a inline content (like paragraph, etc.)
    See Also:
    Listener.beginMacroMarker(String, java.util.Map, String, boolean)
  - endParagraph
```
public void endParagraph(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a paragraph.
    
    Specified by:
    
    endParagraph in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - endSection
```
public void endSection(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a section.
    
    Specified by:
    
    endSection in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    HeaderLevel
  - endHeader
```
public void endHeader(HeaderLevel level,
             String id,
             Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a header.
    
    Specified by:
    
    endHeader in interface Listener
    
    Parameters:
    level - the header level (1, 2, 3, etc)
    id - the header unique identifier
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    HeaderLevel
  - beginLink
```
public void beginLink(ResourceReference reference,
             boolean isFreeStandingURI,
             Map<String,String> parameters)
```
    Description copied from interface: LinkListener
    
    Start of a link.
    
    Specified by:
    
    beginLink in interface LinkListener
    
    Parameters:
    reference - the link reference
    isFreeStandingURI - if true then the link is a free standing URI directly in the text
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    ResourceReference
  - endLink
```
public void endLink(ResourceReference reference,
           boolean isFreeStandingURI,
           Map<String,String> parameters)
```
    Description copied from interface: LinkListener
    
    End of a link.
    
    Specified by:
    
    endLink in interface LinkListener
    
    Parameters:
    reference - the link reference
    isFreeStandingURI - if true then the link is a free standing URI directly in the text
    parameters - a generic list of parameters. Example: style="background-color: blue"
    See Also:
    ResourceReference
  - onMacro
```
public void onMacro(String id,
           Map<String,String> parameters,
           String content,
           boolean isInline)
```
    Description copied from interface: Listener
    
    A Macro.
    
    Specified by:
    
    onMacro in interface Listener
    
    Parameters:
    id - the macro id (eg "toc" for the TOC macro)
    parameters - the macro parameters
    content - the macro content
    isInline - if true the macro is located in a inline content (like paragraph, etc.)
  - onNewLine
```
public void onNewLine()
```
    Description copied from interface: Listener
    
    A new line or line break (it's up to the renderers to decide if it should be outputted as a new line or as a line break in the given syntax).
    
    Specified by:
    
    onNewLine in interface Listener
  - onSpace
```
public void onSpace()
```
    Description copied from interface: Listener
    
    A space.
    
    Specified by:
    
    onSpace in interface Listener
  - onSpecialSymbol
```
public void onSpecialSymbol(char symbol)
```
    Description copied from interface: Listener
    
    A special symbol ("*", "<", ">", "=", quote, etc). Any non alpha numeric character is a special symbol.
    
    Specified by:
    
    onSpecialSymbol in interface Listener
    
    Parameters:
    symbol - the symbol encountered
  - onWord
```
public void onWord(String word)
```
    Description copied from interface: Listener
    
    A word. Note that sentences ar broken into different events: word events, special symbols events, space events, etc. This allows fine-grained actions for listeners.
    
    Specified by:
    
    onWord in interface Listener
    
    Parameters:
    word - the word encountered
  - onId
```
public void onId(String name)
```
    Description copied from interface: Listener
    
    A reference/location in a page. In HTML for example this is called an Anchor. It allows pointing to that location, for example in links. Note that there is no wiki syntax for this in general and it's often generated by Macros (such as the TOC Macro).
    
    Specified by:
    
    onId in interface Listener
    
    Parameters:
    name - the location name.
  - onHorizontalLine
```
public void onHorizontalLine(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Represents an horizontal line.
    
    Specified by:
    
    onHorizontalLine in interface Listener
    
    Parameters:
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - onEmptyLines
```
public void onEmptyLines(int count)
```
    Description copied from interface: Listener
    
    Represents an empty line between 2 standalone Blocks. A standalone block is block that is not included in another block. Standalone blocks are Paragraph, Standalone Macro, Lists, Table, etc.
    
    Specified by:
    
    onEmptyLines in interface Listener
    
    Parameters:
    count - the number of empty lines between 2 standalone Blocks
  - onVerbatim
```
public void onVerbatim(String protectedString,
              boolean isInline,
              Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    A portion of text.
    
    Specified by:
    
    onVerbatim in interface Listener
    
    Parameters:
    protectedString - the string to protected from rendering
    isInline - if true the text content is located in a inline content (like paragraph, etc.)
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - onRawText
```
public void onRawText(String text,
             Syntax syntax)
```
    Description copied from interface: Listener
    
    Some text to inject directly into the listener output without parsing it. For example a HTML macro could inject directly some HTML entered by the user into the rendered HTML output. Note that it's not recommended to use this event in most cases since it can lead to invalid content being generated and in addition most listener implementations will not understand the injected text and will just ignore it.
    
    Specified by:
    
    onRawText in interface Listener
    
    Parameters:
    text - the text to inject
    syntax - the syntax in which the text is written. This is useful so that listener implementations can decide whether they can handle direct inject for that syntax
  - beginDefinitionList
```
public void beginDefinitionList(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a definition list. For example in HTML this is the equivalent of <dl>.
    
    Specified by:
    
    beginDefinitionList in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the list. Example: "style"/"background-color: blue"
  - endDefinitionList
```
public void endDefinitionList(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a definition list. For example in HTML this is the equivalent of </dl>.
    
    Specified by:
    
    endDefinitionList in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the list. Example: "style"/"background-color: blue"
  - beginDefinitionTerm
```
public void beginDefinitionTerm()
```
    Description copied from interface: Listener
    
    Start of a definition list term. For example in HTML this is the equivalent of <dt>.
    
    Specified by:
    
    beginDefinitionTerm in interface Listener
  - beginDefinitionDescription
```
public void beginDefinitionDescription()
```
    Description copied from interface: Listener
    
    Start of a definition list description. For example in HTML this is the equivalent of <dd>.
    
    Specified by:
    
    beginDefinitionDescription in interface Listener
  - endDefinitionTerm
```
public void endDefinitionTerm()
```
    Description copied from interface: Listener
    
    End of a definition list term. For example in HTML this is the equivalent of </dt>.
    
    Specified by:
    
    endDefinitionTerm in interface Listener
  - endDefinitionDescription
```
public void endDefinitionDescription()
```
    Description copied from interface: Listener
    
    End of a definition list description. For example in HTML this is the equivalent of </dd>.
    
    Specified by:
    
    endDefinitionDescription in interface Listener
  - beginQuotation
```
public void beginQuotation(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a quotation. There are one or several quotation lines inside a quotation block.
    
    Specified by:
    
    beginQuotation in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the quotation. Example: "style"/"background-color: blue"
  - endQuotation
```
public void endQuotation(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a quotation.
    
    Specified by:
    
    endQuotation in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the quotation. Example: "style"/"background-color: blue"
  - beginQuotationLine
```
public void beginQuotationLine()
```
    Description copied from interface: Listener
    
    Start of a quotation line. There can be several quotation lines in a quotation block.
    
    Specified by:
    
    beginQuotationLine in interface Listener
  - endQuotationLine
```
public void endQuotationLine()
```
    Description copied from interface: Listener
    
    End of a quotation line.
    
    Specified by:
    
    endQuotationLine in interface Listener
  - beginTable
```
public void beginTable(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a table.
    
    Specified by:
    
    beginTable in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table.
  - beginTableCell
```
public void beginTableCell(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a table cell.
    
    Specified by:
    
    beginTableCell in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table cell.
  - beginTableHeadCell
```
public void beginTableHeadCell(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a table head cell.
    
    Specified by:
    
    beginTableHeadCell in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table head cell.
  - beginTableRow
```
public void beginTableRow(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    Start of a table row.
    
    Specified by:
    
    beginTableRow in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table row.
  - endTable
```
public void endTable(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a table.
    
    Specified by:
    
    endTable in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table.
  - endTableCell
```
public void endTableCell(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a table cell.
    
    Specified by:
    
    endTableCell in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table cell.
  - endTableHeadCell
```
public void endTableHeadCell(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a table head cell.
    
    Specified by:
    
    endTableHeadCell in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table head cell.
  - endTableRow
```
public void endTableRow(Map<String,String> parameters)
```
    Description copied from interface: Listener
    
    End of a table row.
    
    Specified by:
    
    endTableRow in interface Listener
    
    Parameters:
    parameters - a generic list of parameters for the table row.
  - onImage
```
public void onImage(ResourceReference reference,
           boolean isFreeStandingURI,
           Map<String,String> parameters)
```
    Description copied from interface: ImageListener
    
    An image.
    
    Specified by:
    
    onImage in interface ImageListener
    
    Parameters:
    reference - the image reference
    isFreeStandingURI - if true then the image is defined directly as a URI in the text
    parameters - a generic list of parameters. Example: style="background-color: blue"
  - beginMetaData
```
public void beginMetaData(MetaData metadata)
```
    Description copied from interface: Listener
    
    Start of MetaData (eg saving source from where the content is coming from).
    
    Specified by:
    
    beginMetaData in interface Listener
    
    Parameters:
    metadata - the metadata
  - endMetaData
```
public void endMetaData(MetaData metadata)
```
    Description copied from interface: Listener
    
    End of MetaData.
    
    Specified by:
    
    endMetaData in interface Listener
    
    Parameters:
    metadata - the metadata

Class WrappingListener

Field Summary

Fields inherited from interface org.xwiki.rendering.listener.Listener

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

WrappingListener

Method Detail

setWrappedListener

getWrappedListener

beginDocument

endDocument

beginGroup

endGroup

beginFormat

beginList

beginListItem

beginMacroMarker

beginParagraph

beginSection

beginHeader

endFormat

endList

endListItem

endMacroMarker

endParagraph

endSection

endHeader

beginLink

endLink

onMacro

onNewLine

onSpace

onSpecialSymbol

onWord

onId

onHorizontalLine

onEmptyLines

onVerbatim

onRawText

beginDefinitionList

endDefinitionList

beginDefinitionTerm

beginDefinitionDescription

endDefinitionTerm

endDefinitionDescription

beginQuotation

endQuotation

beginQuotationLine

endQuotationLine

beginTable

beginTableCell

beginTableHeadCell

beginTableRow

endTable

endTableCell

endTableHeadCell

endTableRow

onImage

beginMetaData

endMetaData