org.tinygroup.weblayer.webcontext.parser.valueparser.impl

Class ParameterParserImpl

java.lang.Object

org.tinygroup.weblayer.webcontext.parser.valueparser.AbstractValueParser

org.tinygroup.weblayer.webcontext.parser.valueparser.impl.ParameterParserImpl

All Implemented Interfaces:

ParameterParser, ValueParser

public class ParameterParserImpl
extends AbstractValueParser
implements ParameterParser

用来解析HTTP请求中GET或POST的参数的接口ParameterParser的默认实现。

Author:

renhui

Field Summary

Fields inherited from class org.tinygroup.weblayer.webcontext.parser.valueparser.AbstractValueParser

converter, logger, parameterKeys, parameters, webContext

Constructor Summary

Constructors

Constructor and Description
ParameterParserImpl(ParserWebContext webContext, UploadService upload, boolean trimming, ParameterParserFilter[] filters, String htmlFieldSuffix) 从request中创建新的parameters，如果是multipart-form，则自动解析之。

Method Summary

Modifier and Type	Method and Description
void	add(String key, org.apache.commons.fileupload.FileItem value) 添加FileItem。
void	add(String key, Object value) 添加参数名/参数值。
protected String	getCharacterEncoding() 取得用于解析参数的编码字符集。不同的实现取得编码字符集的方法也不同，例如，对于ParameterParser， 此编码字符集是由request.getCharacterEncoding()决定的。
org.apache.commons.fileupload.FileItem[]	getFileItems() 获取所有文件上传内容
FileObject	getFileObject(String key) 取得指定名称的FileItem对象，如果不存在，则返回null。
FileObject[]	getFileObjects(String key) 取得指定名称的FileItem对象，如果不存在，则返回null。
void	parseUpload() 解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。
void	parseUpload(UploadParameters params) 解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。
String	toQueryString() 将parameters重新组装成query string。

Methods inherited from class org.tinygroup.weblayer.webcontext.parser.valueparser.AbstractValueParser

add, add, add, add, add, add, add, add, clear, containsKey, convert, get, getBoolean, getBoolean, getByte, getByte, getBytes, getChar, getChar, getDate, getDate, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getInts, getInts, getKeys, getLong, getLong, getLongs, getLongs, getObject, getObject, getObjectOfType, getObjectOfType, getObjects, getObjects, getShort, getShort, getString, getString, getStrings, getStrings, getTypeConverter, getValueList, isEmpty, keySet, remove, remove, setObject, setObjects, setProperties, setString, setStrings, size, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tinygroup.weblayer.webcontext.parser.valueparser.ValueParser

add, add, add, add, add, add, add, add, clear, containsKey, get, getBoolean, getBoolean, getByte, getByte, getBytes, getChar, getChar, getDate, getDate, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getInts, getInts, getKeys, getLong, getLong, getLongs, getLongs, getObject, getObject, getObjectOfType, getObjectOfType, getObjects, getObjects, getShort, getShort, getString, getString, getStrings, getStrings, getTypeConverter, isEmpty, keySet, remove, setObject, setObjects, setProperties, setString, setStrings, size

Constructor Detail

ParameterParserImpl

public ParameterParserImpl(ParserWebContext webContext,
                           UploadService upload,
                           boolean trimming,
                           ParameterParserFilter[] filters,
                           String htmlFieldSuffix)

从request中创建新的parameters，如果是multipart-form，则自动解析之。

Method Detail

getFileObject

public FileObject getFileObject(String key)

取得指定名称的FileItem对象，如果不存在，则返回null。

Specified by:

getFileObject in interface ParameterParser

Parameters:

key - 参数名

Returns:

FileItem对象

getFileObjects

public FileObject[] getFileObjects(String key)

取得指定名称的FileItem对象，如果不存在，则返回null。

Specified by:

getFileObjects in interface ParameterParser

Parameters:

key - 参数名

Returns:

FileItem对象的数组

add

public void add(String key,
                org.apache.commons.fileupload.FileItem value)

添加FileItem。

Specified by:

add in interface ParameterParser

Parameters:

key - 参数名

value - 参数值

add

public void add(String key,
                Object value)

添加参数名/参数值。

Specified by:

add in interface ValueParser

Overrides:

add in class AbstractValueParser

Parameters:

key - 参数名

value - 参数值

parseUpload

public void parseUpload()
                 throws UploadException

解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。

要执行此方法，须将UploadService.automatic配置参数设置成false。 此方法覆盖了service的默认设置，适合于在action或servlet中手工执行。

Specified by:

parseUpload in interface ParameterParser

Throws:

UploadException - 如果解析时出现异常

parseUpload

public void parseUpload(UploadParameters params)
                 throws UploadException

解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。

要执行此方法，须将UploadService.automatic配置参数设置成false。 此方法覆盖了service的默认设置，适合于在action或servlet中手工执行。

Specified by:

parseUpload in interface ParameterParser

Parameters:

sizeThreshold - 文件放在内存中的阈值，小于此值的文件被保存在内存中。如果此值小于0，则使用预设的值

sizeMax - HTTP请求的最大尺寸，超过此尺寸的请求将被抛弃。

repositoryPath - 暂存上载文件的绝对路径

Throws:

UploadException - 如果解析时出现异常

getCharacterEncoding

protected String getCharacterEncoding()

取得用于解析参数的编码字符集。不同的实现取得编码字符集的方法也不同，例如，对于ParameterParser， 此编码字符集是由request.getCharacterEncoding()决定的。

如果未指定，默认返回ISO-8859-1。

Overrides:

getCharacterEncoding in class AbstractValueParser

Returns:

编码字符集

toQueryString

public String toQueryString()

将parameters重新组装成query string。

Specified by:

toQueryString in interface ParameterParser

Returns:

query string，如果没有参数，则返回null

getFileItems

public org.apache.commons.fileupload.FileItem[] getFileItems()

Description copied from interface: ParameterParser

获取所有文件上传内容

Specified by:

getFileItems in interface ParameterParser

Returns: