org.apache.wiki.plugin
Class InsertPage

java.lang.Object
  org.apache.wiki.plugin.InsertPage

All Implemented Interfaces:

WikiPlugin

public class InsertPage
extends Object
implements WikiPlugin

Inserts page contents. Muchos thanks to Scott Hurlbert for the initial code.

Parameters :

• page - the name of the page to be inserted
• style - the style to use
• maxlength - the maximum length of the page to be inserted (page contents)
• class - the class to use
• section - the section of the page that has to be inserted (separated by "----"
• default - the text to insert if the requested page does not exist

Since:

2.1.37

Field Summary

static String	ATTR_RECURSE This attribute is stashed in the WikiContext to make sure that we don't have circular references.
static String	PARAM_CLASS Parameter name for setting the class.
static String	PARAM_DEFAULT Parameter name for setting the default.
static String	PARAM_MAXLENGTH Parameter name for setting the maxlength.
static String	PARAM_PAGENAME Parameter name for setting the page.
static String	PARAM_SECTION Parameter name for setting the section.
static String	PARAM_STYLE Parameter name for setting the style.

Fields inherited from interface org.apache.wiki.api.plugin.WikiPlugin

CORE_PLUGINS_RESOURCEBUNDLE

Constructor Summary

InsertPage()

Method Summary

String

execute(WikiContext context, Map<String,String> params) This is the main entry point for any plugin.

Methods inherited from class java.lang.Object

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

Field Detail

PARAM_PAGENAME

public static final String PARAM_PAGENAME

Parameter name for setting the page. Value is "page".

See Also:

Constant Field Values

PARAM_STYLE

public static final String PARAM_STYLE

Parameter name for setting the style. Value is "style".

See Also:

Constant Field Values

PARAM_MAXLENGTH

public static final String PARAM_MAXLENGTH

Parameter name for setting the maxlength. Value is "maxlength".

See Also:

Constant Field Values

PARAM_CLASS

public static final String PARAM_CLASS

Parameter name for setting the class. Value is "class".

See Also:

Constant Field Values

PARAM_SECTION

public static final String PARAM_SECTION

Parameter name for setting the section. Value is "section".

See Also:

Constant Field Values

PARAM_DEFAULT

public static final String PARAM_DEFAULT

Parameter name for setting the default. Value is "default".

See Also:

Constant Field Values

ATTR_RECURSE

public static final String ATTR_RECURSE

This attribute is stashed in the WikiContext to make sure that we don't have circular references.

See Also:

Constant Field Values

Constructor Detail

InsertPage

public InsertPage()

Method Detail

execute

public String execute(WikiContext context,
                      Map<String,String> params)
               throws PluginException

This is the main entry point for any plugin. The parameters are parsed, and a special parameter called "_body" signifies the name of the plugin body, i.e. the part of the plugin that is not a parameter of the form "key=value". This has been separated using an empty line.

Note that it is preferred that the plugin returns XHTML-compliant HTML (i.e. close all tags, use <br /> instead of <br>, etc.

Specified by:

execute in interface WikiPlugin

Parameters:

context - The current WikiContext.

params - A Map which contains key-value pairs. Any parameter that the user has specified on the wiki page will contain String-String parameters, but it is possible that at some future date, JSPWiki will give you other things that are not Strings.

Returns:

HTML, ready to be included into the rendered page.

Throws:

PluginException - In case anything goes wrong.