forminfo.java

jspwiki source code,jspwiki source code

/* 
    JSPWiki - a JSP-based WikiWiki clone.

    Licensed to the Apache Software Foundation (ASF) under one
    or more contributor license agreements.  See the NOTICE file
    distributed with this work for additional information
    regarding copyright ownership.  The ASF licenses this file
    to you under the Apache License, Version 2.0 (the
    "License"); you may not use this file except in compliance
    with the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing,
    software distributed under the License is distributed on an
    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
    KIND, either express or implied.  See the License for the
    specific language governing permissions and limitations
    under the License.  
 */
package com.ecyrd.jspwiki.forms;

import java.io.Serializable;
import java.util.HashMap;
import java.util.Map;

/**
 * Container for carrying HTTP FORM information between
 * WikiPlugin invocations in the Session.
 *
 *  @author ebu
 */
public class FormInfo
    implements Serializable
{
    private static final long serialVersionUID = 0L;

    /** State: Form is executed. */
    public static final int EXECUTED =  1;
    
    /** State: Form is OK. */
    public static final int OK       =  0;
    
    /** State: There was an error. */
    public static final int ERROR    = -1;

    private int    m_status;
    private boolean m_hide;
    private String m_action;
    private String m_name;
    private String m_handler;
    private String m_result;
    private String m_error;
    private Map<?, ?> m_submission;

    /**
     *  Creates a new FormInfo with status == OK.
     *
     */
    public FormInfo()
    {
        m_status = OK;
    }

    /**
     *  Set the status of the Form processing.
     *  
     *  @param val EXECUTED, OK or ERROR.
     */
    public void setStatus( int val )
    {
        m_status = val;
    }

    /**
     *  Return the status.
     *  
     *  @return The status.
     */
    public int getStatus()
    {
        return m_status;
    }

    /**
     *  Set the hide parameter.
     *  
     *  @param val True or false.
     */
    public void setHide( boolean val )
    {
        m_hide = val;
    }

    /**
     *  Returns true, if the form is supposed to be hidden.
     *  
     *  @return True or false.
     */
    public boolean hide()
    {
        return m_hide;
    }

    /**
     *  Set the value of the action parameter.
     *  
     *  @param val A value parameter.
     */
    public void setAction( String val )
    {
        m_action = val;
    }

    /**
     *  Get the action set in {@link #setAction(String)}.
     *  
     *  @return An Action.
     */
    public String getAction()
    {
        return m_action;
    }

    /**
     *  Sets the name of the form.
     *  
     *  @param val The name of the form.
     */
    public void setName( String val )
    {
        m_name = val;
    }

    /**
     *  Return the name of the form.
     *  
     *  @return The name of the form.
     */
    public String getName()
    {
        return m_name;
    }

    /**
     *  Set the name of the handler class.
     *  
     *  @param val The name of the class.
     */
    public void setHandler( String val )
    {
        m_handler = val;
    }

    /**
     *  Return the name of the handler class.
     *  
     *  @return The name of the class.
     */
    public String getHandler()
    {
        return m_handler;
    }

    /**
     *  Set the result.
     *  
     *  @param val The result.
     */
    public void setResult( String val )
    {
        m_result = val;
    }

    /**
     *  Return the result.
     *  
     *  @return The result.
     */
    public String getResult()
    {
        return m_result;
    }

    /**
     *  Set an error string.
     *  
     *  @param val An error string.
     */
    public void setError( String val )
    {
        m_error = val;
    }

    /**
     *  Return the error.
     *  
     *  @return The error.
     */
    public String getError()
    {
        return m_error;
    }

    /**
     * Copies the given values into the handler parameter map using Map.putAll().
     * @param val parameter name-value pairs for a Form handler WikiPlugin
     */
    @SuppressWarnings("unchecked")
    public void setSubmission( Map val )
    {
        m_submission = new HashMap();
        m_submission.putAll( val );
    }

    /**
     * Adds the given values into the handler parameter map.
     * @param val parameter name-value pairs for a Form handler WikiPlugin
     */
    @SuppressWarnings("unchecked")
    public void addSubmission( Map val )
    {
        if( m_submission == null )
            m_submission = new HashMap();
        m_submission.putAll( val );
    }

    /**
     * Returns parameter name-value pairs for a Form handler WikiPlugin.
     * The names are those of Form input fields, and the values whatever
     * the user selected in the form. The FormSet plugin can also be used
     * to provide initial values.
     *
     * @return Handler parameter name-value pairs.
     */
    public Map getSubmission()
    {
        return m_submission;
    }
}