在开发Web应用程序时比较常见的功能之一,就是允许用户利用multipart请求将本地文件上传到服务器,而这正是Grails的坚固基石——spring MVC其中的一个优势。Spring通过对Servlet API的HttpServletRequest接口进行扩展,使其能够很好地处理文件上传。扩展后的接口名为org.springframework.web.multipart.MultipartHttpServletRequest,其内容如清单7-31所示。

清单7-31  org.springframework.web.multipart.MultipartHttpServletRequest接口

interface MultipartHttpServletRequest extends HttpServletRequest {

public MultipartFile getFile(String name);

public Map getFileMap();

public Iterator getFileNames();

}

如清单所示,MultipartHttpServletRequest接口简单地扩展了默认的HttpServletRequest接口,并提供一些用来处理请求文件的方法。

7.10.1  使用multipart请求

实际上只要发现一个multipart请求,就表明在控制器实例中存在一个实现Multipart HttpServletRequest接口的request对象。我们可以通过清单7-31所示的方法来访问multipart请求中的上传文件,不过在处理上传文件之前,先来看一下上传表单的内容,如清单7-32所示。

清单7-32  上传表单示例

<form action="upload" enctype="multipart/form-data">

<input type="file" name="myFile" />

<input type="submit" value="Upload! " />

</form>

粗体显示的是需要注意的部分,实际上一个上传表单只需要满足如下两点。

l  enctype属性的属性值设为multipart/form-data。

l  input的type属性的属性值设为file。

在前面的示例中,<input>标签中属性type的值为file,且name属性的值为myFile,之所以需要name属性值,是因为在使用接口MultipartHttpServletRequest的getFile方法时需要使用name属性的值。例如在清单7-33中,代码中的upload操作会从请求中读取上传文件。

清单7-33  读取上传文件

def upload = {

def file = request.getFile(\'myFile\')

// 处理该文件

}

注意getFile方法不会返回一个Java.io.File的实例,而是返回org.springframework.web. multipart.MultipartFile的一个实例,关于org.springframework.web.multipart.MultipartFile的详细信息,请参考清单7-34。如果在请求中没有找到文件则getFile方法返回null。

清单7-34  org.springframework.web.multipart.MultipartFile接口

interface MultipartFile {

public byte[] getBytes();

public String getContentType();

public java.io.InputStream getInputStream();

public String getName();

public String getOriginalFilename();

public long getSize();

public boolean isEmpty();

public void transferTo(java.io.File dest);

}

在MultipartFile接口中定义了如下很多有用的方法。

l  使用getSize()方法获得文件长度,以此决定允许上传的文件大小。

l  使用isEmpty()方法判断上传文件是否为空文件,以此决定是否拒绝空文件。

l  使用getInputStream()方法将文件读取为java.io.InputStream流对象。

l  使用getContentType()方法获得文件类型,以此决定允许上传的文件类型。

l  使用transferTo(dest)方法将上传文件写到服务器上指定的文件。

例如,如果上传的文件不为空并且大小不小于1024字节,那么可以按照清单7-35中的代码来实现。

清单7-35  文件上传示例

def upload = {

def file = request.getFile(\'myFile\')

if(file && !file.empty && file.size < 1024) {

file.transferTo( new java.io.File( "/local/server/path/${file.name}" ) )

}

}

直接使用MultipartHttpServletRequest实例可以用来管理文件上传,但实际应用常常需要读取文件内容。

但如果有多个文件同时上传,则要用多功能上传了

@RequestMapping("/stadium/addPic.json")
@ResponseBody
public void addPicStadium(HttpServletRequest request,
HttpServletResponse response){
Map<String, Object> messages = new HashMap<String, Object>();
String imgurl = ""; 
//创建一个通用的多部分解析器    
CommonsMultipartResolver multipartResolver = new CommonsMultipartResolver(request.getSession().getServletContext());    
//设置编码方式
multipartResolver.setDefaultEncoding("utf-8");
//判断 request 是否有文件上传,即多部分请求    
if(multipartResolver.isMultipart(request)){    
try{
//转换成多部分request      
MultipartHttpServletRequest multiRequest = (MultipartHttpServletRequest)request;    
//MultipartHttpServletRequest multiRequest = multipartResolver.resolveMultipart(request);
//取得request中的所有文件名   
List<MultipartFile> files =  multiRequest.getFiles("fileUpload");
int len = files.size();
//限制图片上传的个数
if(len > 6){
messages.put("success", false);
messages.put("msg", "上传图片失败,一次只能上传6张及以下的图片!");
toJson(response, messages);
return;
}
//Iterator<String> iter = multiRequest.getFileNames(); 

int i=0;
Map<String, String> map = new HashMap<String, String>();
//while(iter.hasNext()){ 
JSONArray ja = new JSONArray();
for(MultipartFile multiparfile:files){

//记录上传过程起始时的时间,用来计算上传时间    
int pre = (int) System.currentTimeMillis();    
//取得上传文件    
//MultipartFile file = multiRequest.getFile(iter.next());

//获取上传文件的名称
String clientName = multiparfile.getOriginalFilename();
//System.out.println(clientName);
//if(file != null){    
//取得当前上传文件的文件名称    
//String myFileName = file.getOriginalFilename();    
//如果名称不为“”,说明该文件存在,否则说明该文件不存在    
//if(myFileName.trim() !=""){   
if(!clientName.equals("")){

String fileName = multiparfile.getOriginalFilename();
int lastNum = fileName.lastIndexOf(".");
String houzhui = fileName.substring(lastNum, fileName.length());
//重命名上传后的文件名    
SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
String fileNewName = sdf.format(new Date())+System.currentTimeMillis()+houzhui;

String fileUpdateName = fileName.replace(fileName, fileNewName);
//System.out.println(fileUpdateName);

//定义上传路径    
String path = request.getSession().getServletContext().getRealPath("upload");
imgurl += "upload/"+fileUpdateName+",";
File localFile = new File(path,fileUpdateName);    
multiparfile.transferTo(localFile); 
//System.out.println("fileName:"+fileName);
//System.out.println("imgurl:"+imgurl);
JSONObject jo = new JSONObject();
try {
jo.put("fileName", fileUpdateName);
jo.put("imgurll", imgurl);
} catch (JSONException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

ja.put(jo);

map.put(fileName, imgurl);
}    
}    
//}
messages.put("success", true);
messages.put("msg", "上传图片成功!");
messages.put("imgMap", ja);
messages.put("length", len);
}catch(IllegalStateException e){
e.printStackTrace();
messages.put("success", false);
messages.put("msg", "上传图片失败!");
}catch(IOException e){
e.printStackTrace();
messages.put("success", false);
messages.put("msg", "上传图片失败!");
}
}
toJson(response, messages);
}