SpringMVC(三) RESTful架构和文件上传下载

RESTful架构

REST全名为：Representational State Transfer。资源表现层状态转化。是目前最流行的一种互联网软件架构。

它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。

资源(Resources)

　　网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的 URI 。要获取这个资源,访问它的URI就可以,因此 URI 即为每一个资源的独一无二的识别符。

表现层(Representation)

　　把资源具体呈现出来的形式,叫做它的表现层(Representation)。比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。

状态转化(State Transfer)

　　每发出一个请求,就代表了客户端和服务器的一次交互过程。HTTP协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生“状态转化”(State Transfer)。而这种转化是建立在表现层之上的,所以就是 “表现层状态转化”。

特点：

1.url更加简洁，将参数通过url传到服务端。

普通的url：地址栏/queryUserById?id=1

REST的url风格：地址栏/queryUserById/1

2.有利于不同系统之间的资源共享，只需要遵守规范，不需要做其他的配置就能达到资源共享。

Restful具体来讲就是四种表现形式，分别对应四种基本操作:

GET：用来获取资源,

POST：用来新建资源,

PUT：用来修改资源,

DELETE：用来删除资源。

但是，form表单只支持 GET与 POST 请求,不支持DELETE、PUT，因此可以使用ajax的方式

<script type="text/javascript" src="js/jquery-1.8.3.min.js"></script>
<script type="text/javascript">
    $(function(){
        $("#get").click(function(){
            var id = $("#get_id").val();
            $.ajax({
                url:"httpGet/"+id,
                type:"get",
                dataType:"json",
                success:function(data){
                    if(data == null){
                        alert("该用户不存在");
                    }else{
                        alert(data.id+"---"+data.name+"---"+data.age);
                    }
                }
            })
        });

        $("#post").click(function(){
            var id = $("#post_id").val();
            var name = $("#post_name").val();
            var age = $("#post_age").val();
            $.ajax({
                url:"httpPost/"+id+"/"+name+"/"+age,
                type:"post",
                dataType:"json",
                success:function(data){
                    alert(data.id+"---"+data.name+"---"+data.age);
                }
            })
        });

        $("#put").click(function(){
            var id = $("#put_id").val();
            var name = $("#put_name").val();
            var age = $("#put_age").val();
            $.ajax({
                url:"httpPut/"+id+"/"+name+"/"+age,
                type:"put",
                dataType:"json",
                success:function(data){
                    alert(data.id+"---"+data.name+"---"+data.age);
                }
            })
        });

        $("#delete").click(function(){
            var id = $("#delete_id").val();
            $.ajax({
                url:"httpDelete/"+id,
                type:"delete",
                dataType:"text",
                success:function(data){
                    alert(data);
                }
            })
        });
    })
</script>

Java层的代码

@Controller
public class RestfulHandler {

    private static Map<Integer,Student> students;

    static{
        students = new HashMap<Integer,Student>();
        students.put(1, new Student(1,"zhangsan",22));
    }

    @RequestMapping(value="/httpGet/{id}",method=RequestMethod.GET)
    @ResponseBody
    public Student httpGet(@PathVariable(value="id")int id){
        return students.get(id);
    }

    @RequestMapping(value="/httpPost/{id}/{name}/{age}",method=RequestMethod.POST)
    @ResponseBody
    public Student httpPost(@PathVariable(value="id")int id,@PathVariable(value="name")String name,@PathVariable(value="age")int age){
        Student student = new Student(id,name,age);
        students.put(student.getId(), student);
        return student;
    }

    @RequestMapping(value="/httpDelete/{id}",method=RequestMethod.DELETE)
    @ResponseBody
    public String httpDelete(@PathVariable(value="id")int id){
        students.remove(id);
        return "delete-ok";
    }

    @RequestMapping(value="/httpPut/{id}/{name}/{age}",method=RequestMethod.PUT)
    @ResponseBody
    public Student httpPut(@PathVariable(value="id")int id,@PathVariable(value="name")String name,@PathVariable(value="age")int age){
        Student student = new Student(id,name,age);
        students.put(student.getId(), student);
        return student;
    }
}

注意：后台返回json数据需要修改xml文件，增加Jackson的包。

文件上传/下载

Web项目中，文件上传功能几乎是必不可少的，实现的技术有很多，甚至在WEB层以及有封装好的。

单文件上传

1.底层还是Apache fileupload组件完成上传，SpringMVC只是进行了封装，需要引入fileupload的包。

2.springmvc.xml配置CommonsMultipartResolver。

    <!-- id必须是multipartResolver -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 处理文件名中文乱码 -->
        <property name="defaultEncoding" value="utf-8"/>
        <!-- 设置多文件上传，总大小上限，不设置默认没有限制，单位为字节，1M=1*1024*1024 -->
        <property name="maxUploadSize" value="1048576"/>
        <!-- 设置每个上传文件的大小上限 -->
        <property name="maxUploadSizePerFile" value="1048576"/>
    </bean>

3.JSP页面的input的type设置为file。form表单的method设置为post，并且enctype设置为multipart/form-data。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%
    String path = request.getContextPath();
    String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <form action="upload" method="post" enctype="multipart/form-data">
        <input type="file" name="img">
        <input type="submit" name="提交">
    </form><br />
    <c:if test="${filePath!=null }">
        <h1>上传的图片</h1><br />
        <img width="300px" src="<%=basePath %>${filePath}"/>
    </c:if>
</body>
</html>

4.Java方法，使用MultipartFile对象作为参数，接收前端发送过来的文件，并完成上传操作。

   @RequestMapping(value="/upload", method = RequestMethod.POST)
   public String upload(@RequestParam(value="img")MultipartFile img, HttpServletRequest request)
           throws Exception {
       //getSize()方法获取文件的大小来判断是否有上传文件
       if (img.getSize() > 0) {
          //获取保存上传文件的file文件夹绝对路径
          String path = request.getSession().getServletContext().getRealPath("file");
          //获取上传文件名
          String fileName = img.getOriginalFilename();
          File file = new File(path, fileName);
          img.transferTo(file);
          //保存上传之后的文件路径
          request.setAttribute("filePath", "file/"+fileName);
          return "upload";
        }
      return "error";
  }

多文件上传

   //和单文件上传类似，input的name属性要一致，接收的参数需要是数组类型
   @RequestMapping(value="/uploads", method = RequestMethod.POST)
   public String uploads(@RequestParam MultipartFile[] imgs, HttpServletRequest request)
           throws Exception {
       //创建集合，保存上传后的文件路径
       List<String> filePaths = new ArrayList<String>();
       for (MultipartFile img : imgs) {
           if (img.getSize() > 0) {
              String path = request.getSession().getServletContext().getRealPath("file");
              String fileName = img.getOriginalFilename();
              File file = new File(path, fileName);
              filePaths.add("file/"+fileName);
              img.transferTo(file);
            }
       }
       request.setAttribute("filePaths", filePaths);
       return "uploads";
   }

文件下载

1.在JSP使用超链接的方式进行文件下载，也可以使用按钮方式。

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <a href="download?fileName=aaa.jpg">下载图片</a>
</body>
</html>

2.JAVA方法。

  @RequestMapping("/download")
  public void downloadFile(String fileName,HttpServletRequest request,
       HttpServletResponse response){
     if(fileName!=null){
       //获取file绝对路径
       String realPath = request.getServletContext().getRealPath("file/");
       File file = new File(realPath,fileName);
       OutputStream out = null;
       if(file.exists()){
          //设置下载类型，具体百度
          response.setContentType("application/force-download");
          //设置文件名
          response.setHeader("Content-Disposition", "attachment;filename="+fileName);
          try {
             out = response.getOutputStream();
               //写入前台页面
             out.write(FileUtils.readFileToByteArray(file));
             out.flush();
          } catch (IOException e) {
             // TODO Auto-generated catch block
             e.printStackTrace();
          }finally{
              if(out != null){
                  try {
                     out.close();
                 } catch (IOException e) {
                     // TODO Auto-generated catch block
                     e.printStackTrace();
                 }
             }
          }
       }
    }
 }