org.xwiki.rendering.internal.macro.wikibridge
Class DefaultWikiMacroManager

java.lang.Object
  org.xwiki.rendering.internal.macro.wikibridge.DefaultWikiMacroManager

All Implemented Interfaces:

WikiMacroManager

@Component
public class DefaultWikiMacroManager
extends java.lang.Object
implements WikiMacroManager

Default implementation of WikiMacroManager.

Since:

2.0M2

Version:

$Id$

Constructor Summary

DefaultWikiMacroManager()

Method Summary

boolean	hasWikiMacro(DocumentReference documentReference) Utility method for querying WikiMacroManager to see if there is a WikiMacro already registered for the given document.
void	registerWikiMacro(DocumentReference documentReference, WikiMacro wikiMacro) Registers the given WikiMacro against the ComponentManager matching the Wiki Macro visibility defined (Current User, Current Wiki, Global).
void	unregisterWikiMacro(DocumentReference documentReference) Unregisters the wiki macro defined on the given document (if there is one).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultWikiMacroManager

public DefaultWikiMacroManager()

Method Detail

hasWikiMacro

public boolean hasWikiMacro(DocumentReference documentReference)

Utility method for querying WikiMacroManager to see if there is a WikiMacro already registered for the given document.

Specified by:

hasWikiMacro in interface WikiMacroManager

Parameters:

documentReference - the name of the document which contains the wiki macro

Returns:

true if there is already a macro registered under the given document name

Since:

2.2M1

See Also:

WikiMacroManager.hasWikiMacro(org.xwiki.model.reference.DocumentReference)

registerWikiMacro

public void registerWikiMacro(DocumentReference documentReference,
                              WikiMacro wikiMacro)
                       throws InsufficientPrivilegesException,
                              WikiMacroException

Registers the given WikiMacro against the ComponentManager matching the Wiki Macro visibility defined (Current User, Current Wiki, Global). For example Macros defined with a "Current User" visibility are registered against the User Component Manager so that they are only visible from that Component Manager and not from other Component Manager.

Note that the Execution Context must be set properly (the current user or the current wiki must be set) prior to calling this API.

Specified by:

registerWikiMacro in interface WikiMacroManager

Parameters:

documentReference - the name of the document which contains the wiki macro

wikiMacro - the WikiMacro instance

Throws:

InsufficientPrivilegesException - if asked visibility is not allowed

WikiMacroException - if a problem happened when registering the macro (document doesn't exist, etc.)

Since:

2.2M1

See Also:

WikiMacroManager.registerWikiMacro(org.xwiki.model.reference.DocumentReference , WikiMacro)

unregisterWikiMacro

public void unregisterWikiMacro(DocumentReference documentReference)
                         throws WikiMacroException

Unregisters the wiki macro defined on the given document (if there is one).

Specified by:

unregisterWikiMacro in interface WikiMacroManager

Parameters:

documentReference - the name of the document which contains the wiki macro

Throws:

WikiMacroException - if a problem happened when registering the macro (document doesn't exist, etc)

Since:

2.2M1

See Also:

WikiMacroManager.unregisterWikiMacro(org.xwiki.model.reference.DocumentReference)