对commons fileupload组件的简单封装

对commons fileupload组件的简单封装

在上一篇文章《利用Jakarta commons fileupload组件实现多文件上传》中，我介绍了commons fileupload组件的基本原理和实现方法。但是在实际操作中，我们需要分析每个FileItem，然后从该FileItem中读取该控件的name和value，显然这不符合我们的习惯。比如我们在页面上有个text文本框：

<inputtype="text"name="possess">

我们要取得possess传过来的value，一般我们是这么写的：

Stringpossess=request.getParameter("possess")

但是在commons fileupload中我们却需要这么处理：

DiskFileItemFactoryfactory=newDiskFileItemFactory();
//Createanewfileuploadhandler
ServletFileUploadupload=newServletFileUpload(factory);
Stringpossess="";
try...{
Listitems=upload.parseRequest(request);
Iteratoriterator=items.iterator();
while(iterator.hasNext())...{
FileItemitem=(FileItem)iterator.next();
if(item.isFormField())...{
StringfieldName=item.getFieldName();
Stringvalue=item.getString();
if(fieldName.equals("possess"))...{
possess=value;
}
}
}
}catch(FileUploadExceptione)...{
e.printStackTrace();
}

按照上面处理的话，很是不爽，因此我想包装一下，使得使用起来符合我们的习惯。
总体设计思想：

1.我们可以像以前那样，传入控件的name，就可以取得该控件的value，因此我想可以遍历所有FileItem，然后把他们存入一个Map中(key中存入fieldname，value中存入该控件的value)，这样就可以达到以上目的了。
2.在该包装类中，我们还要可以设置一些值，从而我们可以更改commons fileupload中的一些配置。

具体实现：
根据以上要求，我写出了一个MutiFileUpload类，代码如下，稍后再做详细解释。

packagechb.commons.fileupload.web;

importjava.util.HashMap;

importjava.util.Iterator;

importjava.util.List;

importjava.util.Map;

importjavax.servlet.http.HttpServlet;

importjavax.servlet.http.HttpServletRequest;


importorg.apache.commons.fileupload.FileItem;

importorg.apache.commons.fileupload.FileUploadException;

importorg.apache.commons.fileupload.disk.DiskFileItemFactory;

importorg.apache.commons.fileupload.servlet.ServletFileUpload;



/***//**

*@authorchb

*

*/

publicclassMutiFileUploadextendsHttpServlet...{

privatestaticfinallongserialVersionUID=670829239023754119L;



protectedMap<String,String>parameters;//保存普通form表单域

protectedMap<String,FileItem>files;//保存上传的文件



/***//**

*Thedirectoryinwhichuploadedfileswillbestored,ifstoredondisk.

*/

privateintsizeThreshold=DiskFileItemFactory.DEFAULT_SIZE_THRESHOLD;



/***//**

*Themaximumsizepermittedforthecompleterequest,asopposedto

*{@link#fileSizeMax}.Avalueof-1indicatesnomaximum.

*/

privatelongsizeMax=-1;



privateStringencoding="utf-8";//字符编码，当读取上传表单的各部分时会用到该encoding



publicStringgetEncoding()...{

returnencoding;

}

publicvoidsetEncoding(Stringencoding)...{

this.encoding=encoding;

}

publiclonggetSizeMax()...{

returnsizeMax;

}

publicvoidsetSizeMax(longsizeMax)...{

this.sizeMax=sizeMax;

}

publicintgetSizeThreshold()...{

returnsizeThreshold;

}

publicvoidsetSizeThreshold(intsizeThreshold)...{

this.sizeThreshold=sizeThreshold;

}

publicvoidparse(HttpServletRequestrequest)...{

parameters=newHashMap<String,String>();

files=newHashMap<String,FileItem>();

//Createafactoryfordisk-basedfileitems

DiskFileItemFactoryfactory=newDiskFileItemFactory();



//Setfactoryconstraints

factory.setSizeThreshold(sizeThreshold);

//factory.setRepository(repository);



//Createanewfileuploadhandler

ServletFileUploadupload=newServletFileUpload(factory);



//Setoverallrequestsizeconstraint

upload.setSizeMax(sizeMax);

upload.setHeaderEncoding(encoding);



try...{

Listitems=upload.parseRequest(request);

Iteratoriterator=items.iterator();

while(iterator.hasNext())...{

FileItemitem=(FileItem)iterator.next();

if(item.isFormField())...{

StringfieldName=item.getFieldName();

Stringvalue=item.getString();

parameters.put(fieldName,value);

}else...{

StringfieldName=item.getFieldName();

files.put(fieldName,item);

}

}

}catch(FileUploadExceptione)...{

e.printStackTrace();

}

}

/***//**得到上传文件的文件名

*@paramitem

*@return

*/

publicStringgetFileName(FileItemitem)...{

StringfileName=item.getName();

fileName=replace(fileName,"/","/");

fileName=fileName.substring(fileName.lastIndexOf("/")+1);

returnfileName;

}

/***//**字符串替换

*@paramsource

*@paramoldString

*@paramnewString

*@return

*/

publicstaticStringreplace(Stringsource,StringoldString,StringnewString)...{

StringBufferoutput=newStringBuffer();



intlengthOfSource=source.length();

intlengthOfOld=oldString.length();

intposStart=0;

intpos;



while((pos=source.indexOf(oldString,posStart))>=0)...{

output.append(source.substring(posStart,pos));

output.append(newString);

posStart=pos+lengthOfOld;

}

if(posStart<lengthOfSource)...{

output.append(source.substring(posStart));

}

returnoutput.toString();

}



}

以上代码很简单，看过commons FileUpload组件API的程序员，应该都能看明白。值得注意一下的是：编码问题（setHeaderEncoding），这个方法是从FileUploadBase类里继承的，根据其说明，当读取上传表单的各部分时会用到该encoding，如果没有指定encoding则使用系统缺省的encoding。建议在这里设置成utf-8，并把jsp的charset也设置成utf-8，否则可能会出现乱码。
测试demo
好了，下面我就写个简单的demo吧，说明一下MutiFileUpload的用法。
1.新建一个jsp页面，注意设置form表单的enctype，如下：

<formid="form1"method="post"action="../servlet/UploadServlet"enctype="multipart/form-data">

<tr>
<tdwidth="25%"align="right">上传图片：</td>
<td>
<inputid="file1"type="file"NAME="file1"style="width:300px;">
</td>
</tr>
<tr>
<tdwidth="25%"align="right">上传音频：</td>
<td>
<inputid="file2"type="file"NAME="file2"style="width:300px;">
</td>
</tr>
<tralign="center"valign="middle">
<tdheight="60"colspan="2">
<inputtype="submit"id="BtnOK"value="确认上传">&nbsp;&nbsp;&nbsp;&nbsp;
<buttononclick="javascript:window.opener==null;window.close();">取消上传</button></td>
</tr>
<tralign="center"valign="middle">
<tdheight="60"colspan="2">
<inputtype="text"name="possess"value="private">
</td>
</tr>
</form>

2.新建一个UploadServlet并继承自MutiFileUpload，如下：

publicclassUploadServletextendsMutiFileUpload...{
}

3.然后在post方法中如下处理：

publicvoiddoPost(HttpServletRequestrequest,HttpServletResponseresponse)
throwsServletException,IOException...{

parse(request);
System.out.println(parameters.get("possess"));
Iteratoriterator=files.values().iterator();
while(iterator.hasNext())...{
FileItemitem=(FileItem)iterator.next();
StringfileName=getFileName(item);
Filefile=newFile("/root/upload/"+fileName);
try...{
item.write(file);
}catch(Exceptione)...{
e.printStackTrace();
}
}
}

选择上传文件，然后我们就可以在/root/upload下看到我们上传的文件了。
好了，先写到这里吧，具体应用时，我们可能需要很多变通，比如集成到spring,hibernate中，关键是给出一个想法，我们可以对他进行包装变更，使其更适合我们的系统。