pagedata.java

欢迎使用 FastJsp 开发框架! 编译说明： * 若要生成Api Javadoc文档

// Copyright 2005-2007 onetsoft.com
//
// Licensed 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.onetsoft.fastjsp.request;

import java.util.Map;
import java.util.Set;

/**
 * 页面请求数据
 * 注：为加快性能,对于一些特殊对象的可考虑直接作为IPage页面类属性
 *
 * @author <a href="mailto:[e-mail]">hgw</a>
 */
public interface PageData {

    /**
     * 取得action
     *
     * @return
     * @since 3.1
     */
    String getAction();

    /**
     * 取得参数 Map
     *
     * @since 3.0
     */
    Map getMap();

    /**
     * 设置参数集
     * 注：只放入非 null 值
     *
     * @param map
     * @since 3.0
     */
    void put(Map map);

    /**
     * 获取所有参数键
     *
     * @return
     * @since 3.0
     */
    Set keySet();

    /**
     * 保存页面数据
     * 不允许放入null值
     *
     * @param name
     * @param value
     */
    void put(Object name, Object value);


    /**
     * 置入映射数据
     * 一般用于在表单初始化是初始表单域数据
     *
     * @param bean 携带数据的类
     * @since 1.2
     */
    void put(Object bean);

    /**
     * 取得页面数据
     * 应注意区分是否为自行传入的参数对象
     *
     * @param name
     * @return 参数不存在，返回 null
     */
    Object get(Object name);

    /**
     * 取得数据映射对象
     * 一般用于取得表单映射类数据
     * 注：映射类须有共构造函数
     *
     * @param beanClass 映射类
     * @return 返回填充了数据的映射类
     * @since 1.2
     */
    Object get(Class beanClass);


    /**
     * 清除数据
     *
     * @param name
     */
    void remove(Object name);

    /**
     * 清除所有数据
     */
    void clear();


    /**
     * 返回指定上载文件
     * 若无对应文件，则返回null
     */

    public  UploadFile getFileUpload(String parameterName);

    /**
     * 取得所有上载文件
     *
     * @return
     */
    public  UploadFile[] getFileUploads();


    /**
     * 取得request的多值参数
     *
     * @param name
     * @return
     */
    String[] getParameterValues(String name);


    /**
     * 取得字符串
     * 缺省返回""
     *
     * @param name
     * @return
     */
    String getString(String name);

    /**
     * 取得字符串
     *
     * @param name
     * @param defaultValue
     * @return
     */
    String getString(String name, String defaultValue);

    /**
     * 设置字符串参数
     * @param name
     * @param value
     */
    void setString(String name, String value);


    /**
     * 检测顺序："1"， "true" ，"yes" ， "on"
     * 缺省返回false
     *
     * @param name
     * @return
     */
    boolean getBoolean(String name);

    /**
     * 取得boolean value
     * 检测顺序："1"， "true" ，"yes" ， "on"
     *
     * @param name
     * @param defaultValue
     * @return
     */
    boolean getBoolean(String name, boolean defaultValue);

    /**
     * 设置boolean参数
     * @param name
     * @param value
     */
    void setBoolean(String name, boolean value);

    /**
     * 缺省值：0D
     *
     * @param name
     * @return
     */
    double getDouble(String name);

    double getDouble(String name, double defaultValue);

    /**
     * 设置double参数
     * @param name
     * @param value
     */
    void setDouble(String name, double value);

    /**
     * 取得long参数
     * 缺省返回-1L
     *
     * @param name
     * @return
     */
    long getLong(String name);

    long getLong(String name, long defaultValue);

    /**
     * 设置long参数
     * @param name
     * @param value
     */
    void setLong(String name, long value);


    /**
     * 获取整数参数
     *
     * @param name
     * @param defaultValue 缺省参数
     * @return
     */
    int getInt(String name, int defaultValue);

    /**
     * 取得int值
     * 缺省返回0
     *
     * @param name
     * @return
     */
    int getInt(String name);

    /**
     * 设置int参数
     * @param name
     * @param value
     */
    void setInt(String name, int value);


}