SpringMVC基础(二)_文件上传、异常处理、拦截器

实现文件上传

实现文件上传，需要借助以下两个第三方 jar 包对上传的二进制文件进行解析：

form表单的 enctype 取值必须为：multipart/form-data（默认为：application/x-www-form-urlencoded）；enctype为表单请求正文的类型；method 属性必须取值为 post 方式；提供一个文件选择域： <input type="file"/> ；

<form action="fileUpload/fileUploadOld" method="post" enctype="multipart/form-data">

    <input type="file" name="fileUpload"/><br/>

    <input type="submit" value="上传"/>

</form>

1、传统文件上传方式

@RequestMapping(value = "/fileUploadOld", method = RequestMethod.POST)

public String fileUploadOld(HttpServletRequest request) throws Exception {

    //获取上传文件存放位置：绝对路径

    String path = request.getServletContext().getRealPath("/uploads/");

    //判断文件是否存在

    File file = new File(path);

    if (!file.exists()) {

        file.mkdirs();//不存在则创建文件

    }

    //解析request对象，获取文件上传项

    DiskFileItemFactory factory = new DiskFileItemFactory();

    ServletFileUpload upload = new ServletFileUpload(factory);

    List<FileItem> items = upload.parseRequest(request);

    //遍历

    for (FileItem item : items) {

        //判断item对象是否表单项

        if (item.isFormField()) {

            //true，表明是普通表单

        } else {

            //false，表明是上传文件项

            //获取上传文件名称

            String fileName = item.getName();

            //把文件名称设置为唯一值

            String uuid = UUID.randomUUID().toString().replace("-", "");

            fileName = uuid + "_" + fileName;

            request.setAttribute("fileName", fileName);

            //完成文件上传

            item.write(new File(path, fileName));

            //删除临时文件

            item.delete();

        }

    }

    return "succeed";

}

2、Spring MVC 文件上传

原理：文件上传请求发送到前端控制器时，会转给文件解析器并返回文件上传项，然后前端控制器将文件上传项发送到控制器方法，最后完成上传操作；

注意：

控制器方法中使用 MultipartFile 对象；
MultipartFile 对象名称必须要与请求参数名称一致；
配置文件解析器 CommonsMultipartResolver 时，ID值必须为 multipartResolver；

代码实现

@RequestMapping(value = "/fileUploadMvc", method = RequestMethod.POST)

public String fileUploadMvc(HttpServletRequest request, MultipartFile fileUpload) {

    //获取上传文件存放位置：绝对路径

    String path = request.getServletContext().getRealPath("/uploads/");

    //判断文件是否存在

    File file = new File(path);

    if (!file.exists()) {

        file.mkdirs();//不存在则创建文件

    }

    //获取上传文件名

    String filename = fileUpload.getOriginalFilename();

    //把文件名称设置为唯一值

    String uuid = UUID.randomUUID().toString().replace("-", "");

    filename = uuid + "_" + filename;

    //上传文件

    try {

        fileUpload.transferTo(new File(path, filename));

    } catch (IOException e) {

        e.printStackTrace();

    }

    return "succeed";

}

Spring MVC配置文件中配置 CommonsMultipartResolver

<!--配置文件解析器-->

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

    <!--设置最大上传文件的大小:10M-->

    <property name="maxUploadSize" value="10485760"/>

</bean>

3、跨服务器实现文件上传

分服务器的目的：让服务器各司其职，从而提高项目的运行效率；在实际开发中，会有很多处理不同功能的服务器。例如：

应用服务器：负责部署我们的应用；
数据库服务器：运行我们的数据库；
缓存和消息服务器：负责处理大并发访问的缓存和消息；
文件服务器：负责存储用户上传文件的服务器；

部署多台服务器的操作

部署两台服务器，并创建一个用于存放图片的 Web 工程；

配置存放图片的服务器可以支持写入操作；

<servlet>

    <servlet-name>default</servlet-name>

    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>

    <init-param>

        <param-name>debug</param-name>

        <param-value>0</param-value>

    </init-param>

    <init-param>

        <param-name>readonly</param-name>

        <param-value>false</param-value>

    </init-param>

    <init-param>

        <param-name>listings</param-name>

        <param-value>false</param-value>

    </init-param>

    <load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

    <servlet-name>default</servlet-name>

    <url-pattern>/</url-pattern>

</servlet-mapping>

实现跨服务器文件上传

@RequestMapping(value = "/fileUploadMultiServer", method = RequestMethod.POST)

public String fileUploadMultiServer(MultipartFile fileUpload) {

    //定义上传文件存放服务器位置：绝对路径

    String path = "服务器域名/URI";

    //声明上传文件项

    //获取上传文件名称

    String filename = fileUpload.getOriginalFilename();

    //把文件名称设置为唯一值

    String uuid = UUID.randomUUID().toString().replace("-", "");

    filename = uuid + "_" + filename;

    /*

        完成文件上传，跨服务器上传

            （1）创建客户端对象；

            （2）和FileServer服务器进行连接；

            （3）上传文件

     */

    //创建 sun 公司提供的 jersey 包中的 Client 对象

    Client client= Client.create();

    //指定上传文件的地址，该地址是 web 路径

    WebResource webResource = client.resource(path + filename);

    try {

        webResource.put(fileUpload.getBytes());

    } catch (IOException e) {

        e.printStackTrace();

    }

    return "succeed";

}

Spring MVC配置文件中配置 CommonsMultipartResolver

<!--配置文件解析器-->

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

    <!--设置最大上传文件的大小:10M-->

    <property name="maxUploadSize" value="10485760"/>

</bean>

注意

图片上传不能包含特殊字符和中文；会报400或IllegalArgumentException错误；
Spring MVC实现跨服务器文件上传可能出现的问题

异常处理

1、异常处理的思路

系统中异常包括两类：预期异常和运行时异常 RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试手段减少运行时异常的发生；

Spring MVC项目中的 dao、service、controller 出现的异常都通过 throws Exception 向上抛出，最后，要么由浏览器输出异常信息，要么在前端控制器中通过异常解析器进行异常处理；

2、异常解析器处理异常步骤

自定义异常类；

package spitter.exception;

/**

 * 自定义异常类

 */

public class SystemException extends Exception{

    //存储异常信息

    private String massage;

    public SystemException(String massage) {

        this.massage = massage;

    }

    public String getMassage() {

        return massage;

    }

    public void setMassage(String massage) {

        this.massage = massage;

    }

}

定义异常处理器：该类实现HandlerExceptionResolver，并重写resolveException方法；

package spitter.exception;

import org.springframework.web.servlet.HandlerExceptionResolver;

import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

/**

 * 自定义异常处理器

 */

public class SystemExceptionResolver implements HandlerExceptionResolver {

    @Override

    public ModelAndView resolveException(

        HttpServletRequest httpServletRequest,

        HttpServletResponse httpServletResponse,

        Object handler,

        Exception ex

    ) {

        //获取异常对象

        SystemException se=null;

        if (e instanceof SystemException){

            se= (SystemException) ex;

        }else {

            se=new SystemException("系统正在维护...");

        }

        ModelAndView mav=new ModelAndView();

        mav.addObject("error",se.getMassage());

        mav.setViewName("error");

        return mav;

    }

}

Spring MVC配置文件中配置异常处理器；

<!--装配异常处理器-->

<bean id="systemExceptionResolver" class="spitter.exception.SystemExceptionResolver"/>

3、resolveException 方法

HttpServletRequest：当前请求的请求对象；
HttpServletResponse：当前请求的响应对象；
Object：当前处理器的对象；
Exception：当前抛出的异常对象；
返回值：ModelAndView 对象；可以进行数据传输和页面跳转；

拦截器

Spring MVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。用户可以自己定义一些拦截器来实现特定的功能；

拦截器链（Interceptor Chain）：拦截器链就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用；

拦截器和过滤器的区别

过滤器：是 servlet 规范中的一部分，任何java web工程都可以使用；拦截器是 SpringMVC 框架独有，只有 SpringMVC 框架的工程才能使用；
过滤器：在 url-pattern 中配置了/*之后，可以对所有要访问的资源拦截；拦截器它是只会拦截访问的控制器方法，不拦截静态资源的访问（jsp,html,css等）；

自定义拦截器步骤

自定义拦截器类，该类实现HandlerInterceptor接口；

preHandle()：访问控制器前执行。返回true，访问控制器；false则不访问，此时，可使用请求对象和响应对象通过请求转发或重定向进行页面跳转；
postHandle()：访问控制器后执行。如果此处进行页面跳转，则控制器返回的视图名失效；
afterCompletion()：页面加载后执行；

package spitter.interceptor;

import org.springframework.web.servlet.HandlerInterceptor;

import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

/**

 * 自定义拦截器

 */

public class MyInterceptor implements HandlerInterceptor {

    @Override

    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {

        System.out.println("拦截器前置方法执行...");

        return true;

    }

    @Override

    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {

        System.out.println("拦截器后置方法执行...");

    }

    @Override

    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {

        System.out.println("页面加载完成，拦截器方法执行...");

    }

}

配置拦截器：；配置元素： <mvc:interceptors>

<!--配置拦截器-->

<mvc:interceptors>

    <mvc:interceptor>

        <!--指定拦截的 URL-->

        <mvc:mapping path="/interceptor/myInterceptor"/>

        <!--指定不拦截的 URL

            <mvc:exclude-mapping path=""/>-->

        <!--配置拦截器对象-->

        <bean class="spitter.interceptor.MyInterceptor"/>

    </mvc:interceptor>

</mvc:interceptors>

拦截器可配多个，执行顺序从上到下

此上，Spring MVC基础学习已经完成。