org.nutz.mvc.upload

类 UploadAdaptor

java.lang.Object

org.nutz.mvc.adaptor.AbstractAdaptor

org.nutz.mvc.adaptor.PairAdaptor

org.nutz.mvc.upload.UploadAdaptor

所有已实现的接口:

HttpAdaptor

public class UploadAdaptor
extends PairAdaptor

本适配器专门处理 HTTP 文件上传(1.b.44及之后的版本,兼容Html5的流式上传)。 它支持多文件，多参数上传。具体的做法是将 HTTP 上传的所有内容 包括文件以及名值对都预先缓存下来。其中，文件缓存在磁盘上，名值对缓存在内存中。

因此，本适配器构造的时候，需要四个参数：

1. 临时文件存放的目录
2. 数据缓冲区大小,建议设置为8192
3. HTTP 请求的编码方式。
4. 临时文件的最大数量

本适配器提供了四个构造函数，最简单的一个只有一个参数，需要你提供一个临时文件目录,缓冲区大小默认为8192, 临时文件数目默认的为 "2000"，HTTP 请求的编码方式为 "UTF-8",

为了能让入口函数了解 HTTP 请求的更多信息，本适配器入口函数声明更多的参数类型：

• java.io.File : 指向已上传至临时目录的文件对象
• org.nutz.mvc.upload.FieldMeta : 描述了一个上传参数的更多属性
• org.nutz.mvc.upload.TempFile : 组合了 File 和 FieldMeta

当然，这三种参数，都是需要你在入口函数的参数列表里声明 '@Param' 注解，用来告诉本适配器，你的参数 具体取自请求中的哪一个参数。

Html5流式上传(实验性)的注意事项: 参数名默认是filedata,除非req.getHeader("Content-Disposition")中有描述另外的name

从以下版本开始:

1.r.55开始使用与servlet 3.0+一致的Part接口,原方法标记为弃用.

作者:

zozoh(zozohtnt@gmail.com), wendal(wendal1985@gmail.com)

另请参阅:

Param

字段概要

从类继承的字段 org.nutz.mvc.adaptor.AbstractAdaptor

argTypes, defaultValues, injs, method, ParamDefailtTag

构造器概要

构造器

构造器和说明
UploadAdaptor()
UploadAdaptor(String path)
UploadAdaptor(String path, int buffer)
UploadAdaptor(String path, int buffer, String charset)
UploadAdaptor(String path, int buffer, String charset, int poolSize)
UploadAdaptor(String path, int buffer, String charset, int poolSize, int maxFileSize)
UploadAdaptor(UploadingContext context)

方法概要

限定符和类型	方法和说明
Object[]	adapt(javax.servlet.ServletContext sc, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse resp, String[] pathArgs) 你的适配器需要根据传入的 request 和 response 生成函数的调用参数
protected ParamInjector	evalInjectorBy(Type type, Param param) 子类实现这个方法根据自己具体的逻辑来生产一个参数注入器
UploadingContext	getContext()
Map<String,Object>	getReferObject(javax.servlet.ServletContext sc, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, String[] pathArgs)
void	init(Method method) 这个函数将在你的适配器生命周期内，这个函数将只被调用一次。

从类继承的方法 org.nutz.mvc.adaptor.PairAdaptor

getNameInjector

从类继承的方法 org.nutz.mvc.adaptor.AbstractAdaptor

evalInjector, paramNameInject

从类继承的方法 java.lang.Object

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

构造器详细资料

UploadAdaptor

public UploadAdaptor()
              throws IOException

抛出:

IOException

UploadAdaptor

public UploadAdaptor(UploadingContext context)

UploadAdaptor

public UploadAdaptor(String path)

UploadAdaptor

public UploadAdaptor(String path,
                     int buffer)

UploadAdaptor

public UploadAdaptor(String path,
                     int buffer,
                     String charset)

UploadAdaptor

public UploadAdaptor(String path,
                     int buffer,
                     String charset,
                     int poolSize)

UploadAdaptor

public UploadAdaptor(String path,
                     int buffer,
                     String charset,
                     int poolSize,
                     int maxFileSize)

方法详细资料

getContext

public UploadingContext getContext()

adapt

public Object[] adapt(javax.servlet.ServletContext sc,
                      javax.servlet.http.HttpServletRequest req,
                      javax.servlet.http.HttpServletResponse resp,
                      String[] pathArgs)

从接口复制的说明: HttpAdaptor

你的适配器需要根据传入的 request 和 response 生成函数的调用参数

指定者:

adapt 在接口中 HttpAdaptor

覆盖:

adapt 在类中 AbstractAdaptor

参数:

sc - Servlet 上下文对象

req - 请求对象

resp - 响应对象

pathArgs - 字符串数组，路径参数。详情请参看 路径参数

返回:

调用参数数组

evalInjectorBy

protected ParamInjector evalInjectorBy(Type type,
                                       Param param)

从类复制的说明: AbstractAdaptor

子类实现这个方法根据自己具体的逻辑来生产一个参数注入器

覆盖:

evalInjectorBy 在类中 PairAdaptor

参数:

type - 参数类型

param - 参数的注解

返回:

一个新的参数注入器实例

getReferObject

public Map<String,Object> getReferObject(javax.servlet.ServletContext sc,
                                         javax.servlet.http.HttpServletRequest request,
                                         javax.servlet.http.HttpServletResponse response,
                                         String[] pathArgs)

覆盖:

getReferObject 在类中 AbstractAdaptor

init

public void init(Method method)

从接口复制的说明: HttpAdaptor

这个函数将在你的适配器生命周期内，这个函数将只被调用一次。它用来告诉你的适配器，你需要适配什么方法。

指定者:

init 在接口中 HttpAdaptor

覆盖:

init 在类中 AbstractAdaptor

参数:

method - 你需要适配的方法