Summercool-Web框架简介 （四）
?
简介：轻量封装Spring MVC
? ? ? ? ?因为本人在国内最大的电子商务公司工作期间，深感一个好的Web框架可以大大提高工作效率，而一个不好的Web框架，又可以大大的降低开发效率。所以，在根据笔者在从事电子商务开发的这几年中，对各个应用场景而开发的一个轻量封装Spring MVC的一个Web框架。
? ? ? ? ?笔者工作的这几年之中，总结并开发了如下几个框架： summercool-web（Web框架，已经应用于某国内大型网络公司的等重要应用）、summercool-hsf（基于Netty实现的RPC框架，已经应用国内某移动互联网公司）、summercool-ddl（基于Mybaits的分表分库框架，已经应用国内某移动互联网公司）；相继缓存方案、和消息系统解决方案也会慢慢开源。summercool框架做为笔者的第一个开源框架
?
?
框架地址：http://summercool.googlecode.com/svn/trunk/summercool-web?
应用地址：http://summercool.googlecode.com/svn/trunk/summercool-petstore?
工具地址：http://summercool.googlecode.com/svn/trunk/summercool-tools
说明：此框架要用到spring-tools文件夹中的security文件夹中的文件，使用此框架的人员请将security文件夹的内容替换到JDK中的security文件夹中
?
一、web.xml配置
?
<?xml version="1.0" encoding="UTF-8"?><web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"id="WebApp_ID" version="2.5"><display-name>summercool-petstore</display-name><!-- Encoding Filter --><filter><filter-name>Set Character Encoding</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param></filter><filter-mapping><filter-name>Set Character Encoding</filter-name><url-pattern>/*</url-pattern></filter-mapping><filter><filter-name>summercool</filter-name><filter-class>org.summercool.web.servlet.DispatcherFilter</filter-class></filter><filter-mapping><filter-name>summercool</filter-name><url-pattern>/*</url-pattern></filter-mapping><welcome-file-list><welcome-file>index.htm</welcome-file></welcome-file-list></web-app>
?说明：
? ? ? ? ? ?1.?Set Character Encoding：字符编码过滤器
? ? ? ? ? ?2.?summercool：summercool框架过滤器
? ? ? ? ? ?3. 只要配置上面两个filter即完成了应用框架的启动配置
?
二、summercool相关配置文件加载及说明
1. 笔者在设计框架的时候，想到了OSGI，但是一直也没有学习明白OSGI的好处或是说优势能给框架带来的什么提升。但是，笔者想实现一种不需要Spring配置文件的注入就可以动态扫描相关的配置文件，实现Spring相关功能类加载。
2. 因为上述的考虑，所以笔者用一种没有技术含又自认为比较方便的方式实现上述功能，如summercool框架会自动扫描：/summercool/spring/*.xml文件夹下面的所有的Spring配置文件。
说明：上图中的/summercool/spring文件夹下面的Spring配置文件全部都会自动加载，包括依赖的项目或是jar里包括的/summercool/spring的文夹下面的配置文件。
3. 在petstore应用里面，笔者一共预先建立了下面几个配置文件：
? ? 1) applicationContext.xml
? ? 2) cache-init-config.xml
? ? 3) cookie-configurer.xml
? ? 4) exception-configurer.xml
? ? 5) monitor-configurer.xml
? ? 6) petstore-configurer.xml
? ? 7) url-configurer.xml
? ? 说明：在上面几个配置文件中，要想要petstore应用跑里面，上面1) applicationContext.xml和6) petstore-configurer.xml这两个配置文件是不可缺少的。
? ? ? ? ? ? ? ?A. applicationContextml里面配置的是petstore页面模版信息和一些Spring MVC框架的配置信息。
? ? ? ? ? ? ? ?B. petstore-configurer.xml里面配置的是信息是summercool的一些请求映射信息等。是整个summercool框架的核心配置文件之一；下面会详细讲解。
?
三、核心配置文件讲解
1. applicationContext.xml配置文件说明
?
<?xml version="1.0" encoding="UTF-8" ?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context" xmlns:util="http://www.springframework.org/schema/util"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans-3.0.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-3.0.xsdhttp://www.springframework.org/schema/utilhttp://www.springframework.org/schema/util/spring-util-3.0.xsd"><bean id="propertyConfigurer" value="UTF-8" /><property name="maxUploadSize" value="20000000" /><property name="maxInMemorySize" value="30720" /></bean><!-- 设置 HandlerExceptionResolver --><bean id="handlerExceptionResolver" value="/petstore/views/error" /><property name="defaultStatusCode" value="500" /></bean><!-- #################################### --><!-- 设置 ViewResolver --><bean name="defaultResourceLoader" /><bean name="springTemplateLoader" ref="defaultResourceLoader" /><constructor-arg index="1" value="${org.summercool.petstore.template.templateLoaderPath}" /></bean><bean id="freemarkerConfiguration" value="${org.summercool.petstore.template.templateLoaderPath}" /><property name="postTemplateLoaders"><array><ref bean="springTemplateLoader"></ref></array></property><property name="freemarkerSettings"><props><prop key="default_encoding">UTF-8</prop><prop key="number_format">#</prop><prop key="template_update_delay">${org.summercool.petstore.template.update.delay}</prop><prop key="classic_compatible">true</prop><prop key="auto_import">/macro/macros.ftl as spring</prop><prop key="url_escaping_charset">UTF-8</prop></props></property></bean><bean id="freemarkerConfigurer" ref="freemarkerConfiguration" /></bean><!-- Spring MVC页面层FreeMarker的处理类 --><util:map id="uriModuleConstants"></util:map><bean id="freemarkerResolver" value="" /><property name="suffix" value=".ftl" /><property name="contentType" value="text/html; charset=UTF-8" /><property name="attributes" ref="uriModuleConstants" /></bean><!-- #################################### --></beans>说明：
? ? ? ? 1. propertyConfigurer：该配置是用来配置Spring注入的一些变量信息。目前里面只是有FreeMarker的模版路径和模版缓存时间。
? ? ? ? 2.?MultipartResolver：如果你的Spring MVC中需要使用到文件上传的功能，则需要配置这个类。默认Spring MVC是不支持文件上传的，只有配了这个类才会支持多文件上传；否则不起到作用。具体的用法，有时间笔者会给出例子，因为是标准的Spring MVC多文件上传，在这里不多作说明。
? ? ? ? 3. HandlerExceptionResolver：全局错误处理器；在Spring MVC在系统发生异常的情况，会交给这个统一错误处理类来处理。比如说，上面配置中“defaultErrorView”属性可以告诉如果系统发生异常，则要显示的默认处理页面（注：支持【 redirect: 】等这样的Spring MVC框架中View对象的语法）。
? ? ? ? ? ? 补充：笔者其实是比较喜欢这个设计的，但是在真正的使用的时候，发现有些需求的情况是无法解决的。比如说，UserException中有一个errorCode属性，不同的errorCode属性会有不同的错误异常类型；可以跟据不同的errorCode可以跳转到不同的业页等。再比如，HandlerExceptionResolver处理类无法拦截“页面层次的异常”。所以，笔者才设计出了ExceptionPipeline接口，该接口的具体使用，笔记会在summercool-petstore应用中给出示例说明。
? ? ? ? 4.?freemarkerConfiguration：设置的是Spring MVC中freemarker页面模版的信息。在这里作者做了一点更改，支持classpath:下面的freemarker模版的加载，别的没有做任何的变动。具体的freemarker模版设置网上有很多的资类可以参数，笔都在这里不多做介绍了。
? ? ? ? ? ? 补充：为什么要做一个freemarker的classpath下面的模版加载类呢，是因为有时候在不同的jar包或是项目中，支持把模版文件以工程模块划分，所以支持放在classpath来解决这个需求。
? ? ? ? ? ? ? ? ? ? ?笔者认为上面的这些配置信息已经足够，一般不需要更多的配置了。具本上面每个配置的含义，大家可以网上查查，笔者也会有时间会在summercool-petstore应用中补充进去的。
? ? ? ? 5.?uriModuleConstants：这个配置比较关键，是配置freemarker页面中的全局参数的一个map。比如说，我想让freemarker页面加入一个全局变量"AppName : Petstore"，则可以配置在此map中。使用的时候只要在freemarker的任何页面中使用${AppName}即可显示。同理，如果想在freemarker中加入全局的内置函数，当然也是通过此方法实现。
? ? ? ? 6.?freemarkerResolver：Spring MVC中真正使用的freemarker页面处理类，具体的实现和使用其实全部都是通过此类完成，具体该类的细节笔者在此不做细的讲解。
?
2. petstore-module.xml配置文件说明
?
<?xml version="1.0" encoding="UTF-8" ?><beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context" xmlns:util="http://www.springframework.org/schema/util"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans-3.0.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context-3.0.xsdhttp://www.springframework.org/schema/utilhttp://www.springframework.org/schema/util/spring-util-3.0.xsd"><bean name="petstore" value="petstore" /><property name="uriExtension" value=".htm" /><property name="moduleBasePackage" value="org.summercool.platform.web.module" /><property name="context" value="/" /><property name="contextPackage" value="/petstore/" /></bean><bean --> /index.htm 或 context = "petstore" --> /petstore/index.htm? ? ? ? ? ? 5)?contextPackage：扫描该模块对应的模块目录。
? ? ? ? ? ? ? ? moduleBasePackage + contextPackage = 完整的该应用模块的招扫描路径
? ? ? ? ? ? ? ? 扫描该完整包路径下面的：controllers和widgets文件夹
? ? ? ? ? ? ? ? controllers文件夹的扫描规则是：/controllers/IndexController.java --> /context/index.htm
? ? ? ? ? ? ? ? 如果是按照上面的这个配置，则真实的规则是：/controllers/IndexController.java --> /index.htm （因为context = "/"）
? ? ? ? ? ? 6) 模块配置类可以允许配置多个，也就是说可以配置多个应和模块，只要context不冲突即可。
? ? ? ? 3.?org.summercool.web.module.WebModuleUriExtensionConfigurer：summercool应用只允许有一个该配置类。该配置类主要是配置哪些过来的后缀名的url请求会允许交给summercool应用处理。
?
重要：到目前为止，所有的配置即已经完成了，可以运行应用。
? ? ? ? ?下一篇，笔者会就如何使用框架进行Controller及Widget开发展开讨论。
? ? ? ? ?再下一篇，笔者会就如何使用Pipeline开发展开讨论。
?
?
?
?
?
?