如果你想开发一个应用(1-8)

虽然现在进入了一年之中最冷的季节，但这篇博客却开始讲述春天的故事。
在TodoServlet这个类中，doGet和doPost重载了模板类HttpServlet类的对应方法，是一个典型的模板方法模式，这种当然是一个很好的模式，经过了千锤百炼，但是，这样真的好吗？我们编写的代码，不应该是专注于业务逻辑么？并且很明显，在TodoServlet这个类中，doGet和doPost中的代码都是各种逻辑纠缠在一起，毫无伸缩性扩展性可言。这时候，就轮到一些MVC框架登场了
MVC是一种架构模式，当前在Web领域毕竟流行的MVC框架有很多种，比如Struts，SpringMVC等，这里主要使用SpringMVC。
SpringMVC是Spring框架的一个模块，Spring是一个通过AOP和DI技术进行简化Java开发的一个开源框架，对于DI(依赖注入)和AOP(面向切片编程)等令人望而生畏的词汇可以之后再理解，现在暂时先了解SpringMVC的一些工作方式。在这里，我们依然使用注解这种零配置文件的方式来实现。

引入Spring

使用Spring，第一步当然是在Maven配置文件中进行配置，由于Maven的依赖树功能，即引入一个依赖就可以引入此依赖所依赖的其他依赖。所以，此时可引入SpringMVC依赖即可：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.0.0.RELEASE</version>
</dependency>

查看模块的引入情况：

可以看到，除了webmvc模块外，还自动引入了webmvc所依赖的各种模块，包括所有功能所必须的Core，Aop，Beans等等。

配置DispatcherServlet

DispatcherServlet是SpringMVC的核心，他是一个繁忙的家伙，所有请求的第一站都是DispatcherServlet，他是一个单实例的Servlet，负责将请求发送给SpringMVC控制器，控制器是一个处理请求的组件，一般应用程序都会有很多歌控制器，所以DispatcherServlet就需要知道要将请求发送给哪一个控制器，所以需要有一个处理器映射来确定下一站是哪里，而决定映射值的，就是处理器所携带的url，是时候祭出一张神图了：

这张图清晰的说明了一个请求在SpringMVC中的数据流向：

1. 一个浏览器(客户端)发出了一个携带客户端的请求，进入DispatcherServlet。
2. DispatcherServlet通过请求的url查询Handler Mapping
3. 根据查询接口，将信息发送至合适的Controller
4. Controller对数据进行处理，并根据情况将结果的数据模型和逻辑上的视图名称打包发回到DispatcherServlet。
5. DispatcherServlet根据ViewResolver(视图解析器)来为逻辑视图名匹配一个特定的视图实现
6. 将数据的模型交给视图实现(可能是jsp)，然后发送客户端

至此，一个请求处理完成。
看上去貌似很复杂，但好在这些步骤都是在Spring框架内实现的，而我们，只要关注如何对DispatcherServlet进行配置就可以了。
对于一个零xml的配置方法来说，需要继承一个名字超级长的类，长到我这个英语渣都没有勇气背下来他的名字：

public class JTodosWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[0];
    }
    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[0];
    }
    @Override
    protected String[] getServletMappings() {
        return new String[0];
    }
}

这几个重写的方法很明显都是默认实现，没有任何意义，接下来就实现这三个方法。

首先完成的方法我选择了getServletMappings(),这个方法用于配置一个或多个进入到DispatcherServlet的路径，是的，你没有看错，可以配置多个，用于为大型项目配置不同的处理方式，这里的项目没有必要，我们只配置一个即可。

@Override
protected String[] getServletMappings() {
    return new String[]{"/"};
}

即任何路径都进入到这个DispatcherServlet中。

接下来需要实现getServletConfigClasses()方法，这个方法需要返回一个类的数组。即在DispatcherServlet启动时所需要加载的Servlet的配置中的Bean,如控制器，视图解析器等等，这些既可以在一个类中进行配置，也可以拆分为多个，下面为一个基本最简的配置：

@Configuration
@EnableWebMvc
@ComponentScan("com.niufennan.jtodos.controller")
public class WebConfig implements WebMvcConfigurer {

}

是的,仅仅是一个空类，但依然能够运气起来，可以进行一些最基本的工作，但这样又许多缺点，比如一个最基本的，任何请求都会DispatcherServlet执行，包括图片，js，css等，显然这样是不好的。所以我们还是需要进行一下基本的配置：

@Configuration
@EnableWebMvc
@ComponentScan("com.niufennan.jtodos.controller")
public class WebConfig implements WebMvcConfigurer {
    @Bean
    public ViewResolver viewResolver(){
        InternalResourceViewResolver viewResolver=new InternalResourceViewResolver();
        viewResolver.setPrefix("/WEB-INF/views/");//对视图进行统一管理
        viewResolver.setSuffix(".jsp");//统一使用jsp文件作为视图
        viewResolver.setExposeContextBeansAsAttributes(true);//设置可直接访问上下文bena
        return  viewResolver;
    }
    
public void  configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer){
        configurer.enable();;//配置静态资源的处理
    }
}

注意很有意思的一点，即在SpringMVC4.版本中，需要的是继承WebMvcConfigurerAdapter类
这是一个WebMvcConfigurer接口的默认适配器，是一个标准的缺省适配器模式的例子，而到了SpringMVC5.后，则可以直接对接口WebMvcConfigurer进行实现，因为SpringMVC5是基于java8开发，java8提供了接口默认实现的功能，具体可以看一段源码：

public interface WebMvcConfigurer {
    default void configurePathMatch(PathMatchConfigurer configurer) {
    }

    default void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
    }

    default void configureAsyncSupport(AsyncSupportConfigurer configurer) {
    }
	......
}

然后还需要至少一个跟配置类，跟配置及多个DispatcherServlet共享的信息，目前只需一个空类即可：

@Configuration
@ComponentScan(basePackages = "com.niufennan.jtodos",excludeFilters = {
        @ComponentScan.Filter(type = FilterType.ANNOTATION,value = EnableWebMvc.class)
})
public class RootConfig {
}

即扫描除了EnableWebMvc注解类之外的所有类

然后，最终DispatcherServlet配置类如下：

public class JTodosWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[]{RootConfig.class};
    }
    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{WebConfig.class};
    }
    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

Controller

接下来，既然在WebConfig类中已经说明了要控制器的所在包，下面就在那个包中创建一个控制器并写出基本方法以实现TodoServlet中的功能：

@Controller
public class TodoController {
    @RequestMapping(value ="/todos/{name}" ,method = RequestMethod.GET)
    public String home(@PathVariable String name, HttpServletRequest request){
        UserDao userDao =new UserDao();
        User user=null;
        //获取用户
        user=userDao.getUserByName(name);
        if(null==user){
            //新用户
            user=new User();
            user.setName(name);
            user.setId(userDao.save(user));
        }
        //获取todo列表
        TodoDao todoDao=new TodoDao();
        List<Todo> list=todoDao.getTodoByUserId(user.getId());
        //将list和name存入request以备jsp页面使用
        request.setAttribute("todos",list);
        request.setAttribute("userid",user.getId());
        return "todos";
    }
    @RequestMapping(value ="/todos" ,method = RequestMethod.POST)
    public String home(HttpServletResponse response, Todo todo) throws IOException {
        TodoDao todoDao=new TodoDao();
        todoDao.save(todo);
        //获取user
        UserDao userDao=new UserDao();
        User user=userDao.get(todo.getUserId());
        //页面跳转
        return "redirect:/todos/"+user.getName();
    }
}

即使大概一看，从代码行数上来说，也比Servlet方式少了不少，但还有一个最大的缺点，就是控制器中仍掺杂了业务逻辑，这个点稍后解决。下面解释一下这些代码：

1. @Controller注解声明了这是一个控制器，而通过WebConfig的配置，来决定从哪里来查找控制器，这里的配置为com.niufennan.jtodos.controller包内的所有带Controller注解的类
2. @RequestMapping(value ="/todos/{name}" ,method = RequestMethod.GET)注解决定执行的路径及方法，header等信息，这里配置的是Get方法，路径为/todos/*
3. @PathVariable代表了一个Path上的参数，这里为String类型，name为名字
4. return "todos"返回值表示寻找/WEB-INF/views/todos.jsp的视图模板
5. return "redirect:/todos/"+user.getName()表示跳转到/todos/username的路径

这里还需要对原有代码进行一些修改：

public class Todo {
    private int id;
    private String item;
    private Date createTime=new Date();
    ......
}

给createTime字段设置一个默认值

还有todos.jsp的内容：

<form action="/todos" method="post"  class="ui fluid action input">
    <input type="text" name="item" placeholder="请输入一个备忘录项目"/>
    <input type="hidden" name="userId" value="${userid}"/>
    <button type="submit" class="ui button">OK</button>
</form>

对表单进行写修改 以适应todo的模型类

最后，为了防止干扰，将之前所写的代码全部删除，最终的目录结构如下：

这时候运行，输入几条记录，啊哦，乱码又回来了(注意，我故意把过滤器删除的)：

这里可以使用Spring框架自带的一个过滤器CharacterEncodingFilter，添加在初始化的时候：

public class JTodosWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
	......  	
    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        super.onStartup(servletContext);
        servletContext.addFilter("name", new CharacterEncodingFilter("UTF-8", true))
                .addMappingForUrlPatterns(null, false, "/*");
    }
}

再次进行测试,显示结果：

问题解决。

再说一点

在一个项目中，一般规范Controller层要尽可能的薄，而现在的代码很明显不符合这一点。至少要把业务逻辑进行移除，接下来的文章中，会在Spring框架的帮助下一点点的实现这些。

谢谢观看