/**
 * 實現存放頁面中獲取值的接口
 */
package com.gd.mvc.io;

import java.io.Serializable;
import java.util.Enumeration;
import java.util.List;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * @author gc
 * 本接口中其中的一些方法模仿HttpServletRequest中的方法
 * 一些方法模仿Map中的方法
 */
public interface InfoInAndOut extends Serializable {
	/**
     * 同Map的get(Object obj)用法
     * @param obj   Object
     * @return Object
     */
    public Object get(Object obj);
	
    /**
     * 同Map的put(Object key, Object value)用法
     * 將value存入key的map中
     * @param Object key
     * @param Object value
     * 
     */
    public void put(Object key, Object value);

    /**
     * 同HttpServletRequest的getParameter(String fieldName)方法
     * @param fieldName     頁面中元素名稱
     * @return  返回頁面中元素名稱的value
     */
    public String getParameter(String fieldName);

    /**
     * 同HttpServletRequest的getParameterNames方法
     * @return  返回頁面中所有元素的名稱
     */
    public Enumeration getParameterNames();

    /**
     * 同HttpServletRequest的getParameterValues(String fieldName)方法
     * @param fieldName     頁面中元素名稱
     * @return  返回頁面中所有元素名稱的所有值，以數組的方式存放。
     */
    public String[] getParameterValues(String fieldName);

    /**
     * 同HttpServletRequest的getQueryString()方法
     * @return  請求網址的QueryString
     */
    public String getQueryString();
    
    /**
     * 根據xml中path中指定的valueObject的id，將頁面上所有以
     * valueObject的id的結尾的元素的值轉換成為VO.
     * @return  Object
     */
	public Object getVO() throws Exception;
    
	/**
     * 根據xml中path中指定的valueObject的id，將頁面上所有以
     * valueObject的id的結尾的元素的值轉換成為VO.
     * @return  Object
     */
	public Object getVO(String voId) throws Exception;

    /**
     * 根據指定的復選框名稱checkFieldName，將選中的元素的值轉換成為VO，存入List中返回
     * @return  Object
     */
    public List getVOs(String checkFieldName) throws Exception;

    /**
     * 根據指定的復選框名稱checkFieldName，將選中的元素的值轉換成為VO，存入List中返回
     * @return  Object
     */
    public List getVOs(String voId, String checkFieldName) throws Exception;

    /**
     * 得到HttpServletRequest對象
     * @return HttpServletRequest對象
     * @throws Exception
     */
    public HttpServletRequest getHttpServletRequest() throws Exception;

    /**
     * 得到HttpServletResponse對象
     * @return HttpServletResponse對象
     * @throws Exception
     */
    public HttpServletResponse getHttpServletReponse() throws Exception;
}