FormOpen (Apache JSPWiki 2.12.2 API)

java.lang.Object
- org.apache.wiki.forms.FormElement
- - org.apache.wiki.forms.FormOpen

All Implemented Interfaces:

Plugin
```
public class FormOpen
extends FormElement
```
Opens a WikiForm. Builds the HTML code for opening a FORM.
Since we're only providing an opening FORM tag, we can't use the ECS utilities. A Form plugin line that produces one looks like this:
```
   [{FormOpen name='formname' handler='pluginname'
          submit='submitservlet'
          show='always'
   }]
 
```
Mandatory parameters:
The name field identifies this particular form to the Form plugin across pages.
The handler field is a WikiPlugin name; it will be invoked with the form field values.
Optional parameters:
The submitservlet is the name of a JSP/servlet capable of handling the input from this form. It is optional; the default value is the current page (which can handle the input by using this Plugin.)
The hide parameter affects the visibility of this form. If left out, the form is always shown. If set to 'onsuccess', the form is not shown if it was submitted successfully. (Note that a reload of the page would cause the context to reset, and the form would be shown again. This may be a useless option.)

Field Summary

Fields
Modifier and Type Field Description

static java.lang.String PARAM_METHOD
Parameter name for setting the method (GET or POST).
- Fields inherited from class org.apache.wiki.forms.FormElement
  FORM_VALUES_CARRIER, HANDLERPARAM_PREFIX, HIDE_SUCCESS, PARAM_ELEMENT, PARAM_FORM, PARAM_FORMNAMEHIDDEN, PARAM_HANDLER, PARAM_HIDEFORM, PARAM_INPUTNAME, PARAM_POPULATE, PARAM_SUBMITHANDLER, PARAM_VALUE
- Fields inherited from interface org.apache.wiki.api.plugin.Plugin
  CORE_PLUGINS_RESOURCEBUNDLE

Constructor Summary

Constructors
Constructor Description

FormOpen()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`java.lang.String`	`execute(Context ctx, java.util.Map<java.lang.String,java.lang.String> params)`	This is the main entry point for any plugin.

Methods inherited from class org.apache.wiki.forms.FormElement
getFormInfo, storeFormInfo

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

- Field Detail
  - PARAM_METHOD
```
public static final java.lang.String PARAM_METHOD
```
    Parameter name for setting the method (GET or POST). Value is "method".
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - FormOpen
```
public FormOpen()
```
- Method Detail
  - execute
```
public java.lang.String execute(Context ctx,
                                java.util.Map<java.lang.String,java.lang.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.
    
    Parameters:
    
    ctx - 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.