org.tinygroup.weblayer.webcontext.parser.impl

Class UploadServiceImpl

java.lang.Object

org.tinygroup.support.BeanSupport

org.tinygroup.weblayer.webcontext.parser.impl.UploadServiceImpl

All Implemented Interfaces:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.InitializingBean, UploadConfiguration, UploadService

public class UploadServiceImpl
extends BeanSupport
implements UploadService

这个service可以处理multipart/form-data格式的HTTP POST请求，并将它们转换成form字段或是文件。

Author:

renhui

Field Summary

Fields inherited from interface org.tinygroup.weblayer.webcontext.parser.upload.UploadConfiguration

FILE_SIZE_MAX_DEFAULT, SIZE_MAX_DEFAULT, SIZE_THRESHOLD_DEFAULT

Constructor Summary

Constructors

Constructor and Description
UploadServiceImpl()

Method Summary

Modifier and Type	Method and Description
String[]	getFileNameKey() 标准的上传文件请求中，包含这样的内容： Content-Disposition: attachment; filename=xxx.txt 。然而有些不规范的应用，会取fname=xxx.txt。此变量为兼容这种情况而设。
HumanReadableSize	getFileSizeMax() 取得单个文件允许的最大尺寸，超过此尺寸的文件将被抛弃。单位：字节，值-1表示没有限制。
String	getItemStorageBeanName()
FileUploadReName	getRename()
File	getRepository() 取得暂存文件的目录。
HumanReadableSize	getSizeMax() 取得HTTP请求的最大尺寸，超过此尺寸的请求将被抛弃。单位：字节，值-1表示没有限制。
HumanReadableSize	getSizeThreshold() 取得将文件放在内存中的阈值，小于此值的文件被保存在内存中。单位：字节。
protected void	init() 初始化bean。
boolean	isDiskItemFactory()
boolean	isKeepFormFieldInMemory() 是否将普通的form field保持在内存里？当sizeThreshold值为0 的时候，该值自动为true。
boolean	isMultipartContent(javax.servlet.http.HttpServletRequest request) 判断是否是符合RFC 1867标准的 multipart/form-data类型的HTTP请求。
boolean	isSaveInFile()
boolean	isTemporary() 是否是临时目录，true：认为是临时文件，请求完毕会删除此临时文件。
org.apache.commons.fileupload.FileItem[]	parseRequest(javax.servlet.http.HttpServletRequest request) 解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。
org.apache.commons.fileupload.FileItem[]	parseRequest(javax.servlet.http.HttpServletRequest request, UploadParameters params) 解析符合RFC 1867标准的 multipart/form-data类型的HTTP请求。
void	setDiskItemFactory(boolean isDiskItemFactory)
void	setFileNameKey(String[] fileNameKey)
void	setFileSizeMax(HumanReadableSize fileSizeMax)
void	setItemStorageBeanName(String itemStorageBeanName)
void	setKeepFormFieldInMemory(boolean keepFormFieldInMemory)
void	setRename(FileUploadReName rename)
void	setRepository(File repository)
void	setSaveInFile(boolean saveInFile)
void	setSizeMax(HumanReadableSize sizeMax)
void	setSizeThreshold(HumanReadableSize sizeThreshold)
void	setTemporary(boolean isTemporary)

Methods inherited from class org.tinygroup.support.BeanSupport

afterPropertiesSet, assertInitialized, destroy, dispose, getBeanDescription, getBeanDescription, getBeanInterface, getBeanName, isInitialized, postDispose, postInit, preDispose, preInit, resolveBeanInterface, setBeanName, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

UploadServiceImpl

public UploadServiceImpl()

Method Detail

getRename

public FileUploadReName getRename()

setRename

public void setRename(FileUploadReName rename)

getRepository

public File getRepository()

Description copied from interface: UploadConfiguration

取得暂存文件的目录。

Specified by:

getRepository in interface UploadConfiguration

setRepository

public void setRepository(File repository)

getSizeMax

public HumanReadableSize getSizeMax()

Description copied from interface: UploadConfiguration

取得HTTP请求的最大尺寸，超过此尺寸的请求将被抛弃。单位：字节，值-1表示没有限制。

Specified by:

getSizeMax in interface UploadConfiguration

setSizeMax

public void setSizeMax(HumanReadableSize sizeMax)

getFileSizeMax

public HumanReadableSize getFileSizeMax()

Description copied from interface: UploadConfiguration

取得单个文件允许的最大尺寸，超过此尺寸的文件将被抛弃。单位：字节，值-1表示没有限制。

Specified by:

getFileSizeMax in interface UploadConfiguration

setFileSizeMax

public void setFileSizeMax(HumanReadableSize fileSizeMax)

getSizeThreshold

public HumanReadableSize getSizeThreshold()

Description copied from interface: UploadConfiguration

取得将文件放在内存中的阈值，小于此值的文件被保存在内存中。单位：字节。

Specified by:

getSizeThreshold in interface UploadConfiguration

setSizeThreshold

public void setSizeThreshold(HumanReadableSize sizeThreshold)

isKeepFormFieldInMemory

public boolean isKeepFormFieldInMemory()

Description copied from interface: UploadConfiguration

是否将普通的form field保持在内存里？当sizeThreshold值为0 的时候，该值自动为true。

Specified by:

isKeepFormFieldInMemory in interface UploadConfiguration

setKeepFormFieldInMemory

public void setKeepFormFieldInMemory(boolean keepFormFieldInMemory)

isSaveInFile

public boolean isSaveInFile()

Specified by:

isSaveInFile in interface UploadConfiguration

setSaveInFile

public void setSaveInFile(boolean saveInFile)

isDiskItemFactory

public boolean isDiskItemFactory()

Specified by:

isDiskItemFactory in interface UploadConfiguration

setDiskItemFactory

public void setDiskItemFactory(boolean isDiskItemFactory)

getItemStorageBeanName

public String getItemStorageBeanName()

Specified by:

getItemStorageBeanName in interface UploadConfiguration

setItemStorageBeanName

public void setItemStorageBeanName(String itemStorageBeanName)

getFileNameKey

public String[] getFileNameKey()

Description copied from interface: UploadConfiguration

标准的上传文件请求中，包含这样的内容： Content-Disposition: attachment; filename=xxx.txt 。然而有些不规范的应用，会取fname=xxx.txt。此变量为兼容这种情况而设。

Specified by:

getFileNameKey in interface UploadConfiguration

setFileNameKey

public void setFileNameKey(String[] fileNameKey)

isTemporary

public boolean isTemporary()

Description copied from interface: UploadConfiguration

是否是临时目录，true：认为是临时文件，请求完毕会删除此临时文件。

Specified by:

isTemporary in interface UploadConfiguration

Returns:

setTemporary

public void setTemporary(boolean isTemporary)

init

protected void init()

Description copied from class: BeanSupport

初始化bean。

Overrides:

init in class BeanSupport

isMultipartContent

public boolean isMultipartContent(javax.servlet.http.HttpServletRequest request)

判断是否是符合RFC 1867标准的 multipart/form-data类型的HTTP请求。

Specified by:

isMultipartContent in interface UploadService

Parameters:

request - HTTP请求

Returns:

如果是，则返回true

parseRequest

public org.apache.commons.fileupload.FileItem[] parseRequest(javax.servlet.http.HttpServletRequest request)

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

Specified by:

parseRequest in interface UploadService

Parameters:

request - HTTP请求

Returns:

FileItem的列表，按其输入的顺序罗列

Throws:

UploadException - 如果解析时出现异常

parseRequest

public org.apache.commons.fileupload.FileItem[] parseRequest(javax.servlet.http.HttpServletRequest request,
                                                             UploadParameters params)

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

此方法覆盖了service的默认设置，适合于在action或servlet中手工执行。

Specified by:

parseRequest in interface UploadService

Parameters:

request - HTTP请求

params - upload参数

Returns:

FileItem的列表，按其输入的顺序罗列

Throws:

UploadException - 如果解析时出现异常