Fastupload 0.5.3发布

相对于以往的版本，fastupload 0.5.3做出了明显的增强和修改。此版本中，“融合“了磁盘解析方式和内存解析方式，磁盘解析方式也支持非文件类型输入的解析，减少了磁盘解析模式中 UploadChunk对象的创建，提升了解析性能，改进了字符编码转换，API更加简明。

 

基本API使用

默认情况下，fastupload建议使用内存解析模式，因为这种模式下解析的性能是最好的，而且，解析出的数据是在内存中，很容易处理。其API使用如下，

 

FastUploadParser fastUploadParser = new FastUploadParser(request); 
  List<MultiPart> list = fastUploadParser.parseList();
  for (MultiPart e: list){
      if (e.isFile()){
          System.out.format("input field name: %s, file name:%s%n", e.getFieldName(), e.getFileName());
          e.toFile( /file/ ) ;  //write data to a file where you want to place
      }
      else {
          System.out.format("input field name: %s, value:%s%n", e.getFieldName(), e.getString());
      }
 }

但是在某些特定的情况下，比如对内存的使用限制要求强烈的场合，或者上传的文件非常大，可以使用磁盘解析模式，这种模式下，API的使用与内存模式基本相 同，只不过需要创建FileFactory对象，并把这个对象作为FastUploadParser构造函数的第二个参数。

 

FileFactory fileFactory = FileFactory.getInstance();
fileFactory.setRepository(System.getProperty("user.home")+"/fastupload");
FastUploadParser fastUploadParser = new FastUploadParser(request, fileFactory);
List<MultiPart> list = fastUploadParser.parseList();
for (MultiPart e: list){
   if (e.isFile()){
	System.out.format("input field name: %s, file name:%s%n", e.getFieldName(), e.getFileName());
  		e.toFile( /target/ ) ;  //move temporary file to where you want to place
  	}
  	else {
 		System.out.format("input field name: %s, value:%s%n", e.getFieldName(), e.getString());
   }
}

在这种模式下，当从multipart/form-data输入流中发现有上传的文件时，会在FileFactory指定的目录内创建一个临时文件，每次 写入不超过8k的数据，此文件的数据分析完后，关闭文件。因此，要使用e.toFile(...) 函数把这个临时文件移至你所想要的地方，对于非文件类型的输入，e.getString()输出其内容。

 

高级特性

有时候，需要限制客户端上传的文件，不同于其他的文件解析组建，Fastupload采用预先特性匹配机制，在解析过程中，一旦发现头信息与设定的模式不匹配时，会自动跳过此部分。API使用如下

 

FileFactory fileFactory = FileFactory.getInstance();
fileFactory.setAllowedTypes("image/jpeg");
fileFactory.setAllowedExtensions(".jpg, .png");

当然，文件大小的限制，也是必须要支持的，下面的第一行代码是设定每个文件不超过200000字节，第二行代码是设定multipart输入流的总大小不超过2000000字节，注意，这里的总数是包含一些HTML的代码在内的

fileFactory.setThreshold(200000);
fileFactory.setMaxContentLength(2000000);

如果想知道解析的进度，可以创建一个ProgressListener对象

ProgressListener listener = new ProgressListener(fastUploadParser);
listener.progress();

 

字符编码

java语言本身是支持unicode的，并且，在各种unicode之间进行转换是很容易 的，但是比较杯具的是，在Servlet规范中，没有规定检测传输的数据所采用的编码方法，在服端编程时，没有调用 ServletRequest.setCharsetEncoding(...) 函数时，ServletRequest.getCharsetEncoding(...) 函数永远返回null，在程序里，很难知道客户端发送过来的数据流是采用以什么字符集进行编码的。不仅如此，即使知道了数据流编码所采用的字符集，可能和 运行着的Servlet容器所使用的字符集不一样，可能和操作系统所使用的字符集也不一样，因此对数据流进行适当的字符集转换，并按照Servlet容器 所使用的字符保存到文件系统，对于防范由字符编码引起的问题。

在unicode环境中，首先要告诉ServletRequest，客户端发 送数据时编码所采用的字符集，給FileFactory设置目标字符集，如果不想显式初始化带有编码的FileFactory对象，可以在启动JVM时加 上 -Dfile.encoding="UTF-8"参数，FileFactory会取这个默认的字符集。

 

request.setCharsetEncoding(“gbk");
FileFactory fileFactory = FileFactory.getInstance("utf-8");
// ... 以下省略解析代码

对于磁盘解析方式，正确的设定了ServletRequest编码字符集和目标字符集后，文本文件可以进行正确的转码。有一点需要注意的是，即使是文本文 件，浏览器按照二进制流的形式把其内容“灌入”到HTTP流中，当对其文件名却按照浏览器当前的字符集进行编码，假如文本文件保存的时候，编码是gbk， 用浏览器上传文件时选用了utf8，这样，fastupload就不能正确的进行转码工作。因此在磁盘解析模式下，有必要让浏览器采用和操作系统同样的编 码。

而对于内存解析方式，API使用者代码可以直接访问到二进制的流，可以随心所欲的进行编码转换工作。

 

1, MultiPart part ...;
2, part.getString();
3, part.getString("gbk");

这个代码片段中，第二行是对解析到的流按照系统默认的字符集转换成String，第三行是按照指定的字符集对字节流进行编码，转换成String。

 

Maven依赖坐标

 

@仪山湖

 

项目地址：https://sourceforge.net/projects/fastupload/

项目wiki: https://sourceforge.net/p/fastupload/wiki/Fastupload%20Home/