? ? ? ??摘要：“约定优于配置”这是一个相当棒的经验，SOAP服务性能差、基于配置、紧耦合，restful服务性能好、基于约定、松耦合，现在我就把使用Spring MVC发布restful服务的过程同大家分享。代码之优雅、过程之简单、编码之愉快，不是发布SOAP服务所能匹敌的。
? ? ? ? 关键字：java, rest,?webservice, spring mvc
? ? ? ??前提：IntelliJ IDEA （13.1.5?版本）,?apache maven?（3.2.3?版本）,?Tomcat（7.0.56版本）, Spring（3.2.4版本）
?
? ? ? ??
“约定优于配置”这是一个相当棒的经验，对于我来说，恐怕是自“面向对象”以来对我最大冲击的理念了吧。首先，SOAP服务可以说是基于配置的，它在HTTP的基础上使用XML配置表达服务与数据，为了实现远程访问，它生成的服务信息尤其复杂，无论是C#客户端还是JAVA客户端，甚至可以通过WSDL服务描述来自动生成一整套代码，这样基于配置的服务的缺点就在于服务端与客户端有着较强的编码耦合性，服务端接口修改后，需要对客户端的服务依赖代码重新生成。而restful服务是基于约定的，是http的get、delete、post还是put都约定好了不同的含义，我们依照约定来进行http请求便可以实现各式的操作。更不用说SOAP服务的性能之差、与restful服务不是一个数量级之缺点了。基于约定，我们可以实现代码间的松耦合。虽然Hessian性能略优于restful服务、其实是一个数量级、restful编解码做好了就性能差不多，但Hessian也还是基于代码的紧耦合了。
?
? ? ? ??首先，我们先在IDEA中新建一个名为dp-parent的Project，作为所有工程的父节点，其<packaging>pom</packaging>。然后，我们在dp-parent下新建一个名为dp-restfulservice的Module，其<packaging>war</packaging>，并在其pom.xml中添加其所需的spring依赖。如：
?
<dependency>
? ? ? ? ? ? <groupId>org.springframework</groupId>
? ? ? ? ? ? <artifactId>spring-context</artifactId>
? ? ? ? ? ? <version>3.2.4.RELEASE</version>
</dependency>
? ? ? ??
? ? ? ? 其次，我们在src/main目录下创建名为webapp的目录，为什么要叫这个名字呢？这其实也是一个约定。并且，我们在webapp目录下创建名为WEB-INF的目录（为什么要叫这个名字呢？这其实也是一个约定）。在WEB-INF目录下创建名为web.xml的文件（为什么要叫这个名字呢？这其实也是一个约定，这句话我说了太多遍了，“约定优于配置”此理念真是百试不爽）。下面是web.xml的主要内容。
?
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
? ? ? ? ?xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
? ? ? ? ?xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
? ? ? ? ?version="3.1">
? ? <servlet>
? ? ? ? <servlet-name>restful</servlet-name>
? ? ? ? <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
? ? ? ? <load-on-startup>1</load-on-startup>
? ? </servlet>
? ? <servlet-mapping>
? ? ? ? <servlet-name>restful</servlet-name>
? ? ? ? <url-pattern>/</url-pattern>
? ? </servlet-mapping>
</web-app>
?
? ? ? ? 然后，我们要在WEB-INF目录下创建一个名为restful-servlet.xml的文件（为什么要叫这个名字呢？这其实也是一个约定，在web.xml中规定的servlet-name加上-servlet约定为servlet配置文件名）。restful-servlet.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:mvc="http://www.springframework.org/schema/mvc"
? ? ? ?xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
? ? <context:component-scan base-package="com.jsc.dp.controllers"></context:component-scan>
? ? <mvc:resources mapping="/resources/**" location="/WEB-INF/resources/"></mvc:resources>
? ? <mvc:annotation-driven/>
? ? <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
? ? ? ? <property name="prefix" value="/WEB-INF/views/"/>
? ? ? ? <property name="suffix" value=".jsp"/>
? ? ? ? <!-- 如果 .jsp 文件中含有 jstl，需要这一行 -->
? ? ? ? <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
? ? </bean>
</beans>
?
? ? ? ??下面是要编写代码spring mvc中的C（Controller）了。在main/java中创建名为com.jac.dp.controllers的包，在此包下新建一个名为AbcController的类，其通过@Controller注解注入进spring框架中。具体的restful代码如下图所示。从图中可以看到，其实现了一个名为getAbcs的方法，使用get用以对get式的?http://localhost:8088/restfulservice/abcs? 请求进行响应。还实现了一个名为getAbc的方法，使用get以对get式的?http://localhost:8088/restfulservice/abcs/3? 请求进行响应，来获取某一对象，返回给前端的是一Json字符串：{"myInt":3,"myString":"myString"}。名为putAbc的方法，其使用put以对put式的?http://localhost:8088/restfulservice/abcs/3??请求进行响应，来更新某一对象。下图中也展示了，使用工具REST Client来进行http put请求测试的过程与结果，在这里，返回的是一个对象转成的Json字符串，在IDEA中可以看到其Response是：{"myInt":-1,"myString":"post true"}，与预想中的一样；同样的post和get也可以如此测试，测试get请求也可以直接使用浏览器执行。?
?
?
?
? ? ? ? 代码编写完成后，需要进行服务发布了，我们使用Tomcat作为服务容器。在IDEA中如何进行Tomcat配置就不多说了，这里提一下Run/Debug Configurations。在Application context中配置成restfulservice才有上面的效果哦。
?
?
?
? ? ? ?
有时候一个理念让人茅塞顿开、醍醐灌顶。“约定优于配置”就是这样的理念。感谢教给我这个理念的人，王某连云港人。
?
获取【下载地址】? ?QQ: 313596790
A 代码生成器(开发利器);??
? ?增删改查的处理类，service层，mybatis的xml，SQL( mysql? ?和oracle)脚本,? ?jsp页面 都生成
? ?就不用写搬砖的代码了,生成的放到项目里，可以直接运行
B 阿里巴巴数据库连接池druid;
??数据库连接池??阿里巴巴的 druid。Druid在监控、可扩展性、稳定性和性能方面都有明显的优势
C 安全权限框架shiro ;
??Shiro 是一个用 Java 语言实现的框架，通过一个简单易用的 API 提供身份验证和授权，更安全，更可靠
D ehcache 自定义二级缓存;
??是一个纯Java的进程内缓存框架，具有快速、精干等特点
??是一种广泛使用的开源Java分布式缓存。
E 微信接口开发(2.5版本新增)（后续会加入Activiti5 工作流 ）
-------------------------------------------------------------------------------------------------------------------------
1. 模块化、服务化，流程化，耦合度低、扩展性好，灵活度高，工具类封装完整，干净利索，调用简单方便
2. 提供Rest服务，支持APP手机应用(android和ios)接口、php、.net、易语言、VB等第三方接口调用
3. 全新高大尚HTML5+css3.0+bootstrap响应式开发界面UI，( 手机 PC 平板 截图在下面)、前沿.??spring restful 风格
4. 框架搭建完善成熟，在此基础上做过很多项目，系统具有并发处理、分布式、稳定性。
5. 系统功能完善，此为框架平台，文档、注释齐全，提供技术支持，专门供二次开发
6. 在此基础上可二次开发(OA、ERP、CRM ,医疗管理、金融、网站后台、APP后台、电子商务、商城(赠送UI)等等
7.我们这边是公司，主要业务是定制开发,??此系统为我们平时给客户做项目用的，经过很多项目实战考验
??-------------------------------------------------------------------------------------------------------------------------系统模块
1. 组织管理：角色管理，分角色组和成员，有组权限和成员权限。
2. 系统用户：对各个基本的组会员增删改查，单发、群发邮件短信，导入导出excel表格，批量删除
3. 会员管理：对前台用户管理，分配会员级别，到期时间，状态，联系信息等资料
4. 菜单管理：增删改查菜单 ztree（自定义菜单）业务菜单和系统菜单分离
5. 数据字典：无限级别，支持多级别无限分类。内设编号，排序等
6. 系统设置：修改系统名称，邮件服务器配置，短信账号设置，图片水印配置，微信配置
7. 代码生成：打开代码生成器模块? ???
8. 图库管理：对批量上传的图片统一管理
9. 性能监控：监控整个系统的性能，SQL监控，SQL防火墙，URL监控，SPRING监控，SESSION监控等
10. 接口测试：POST or GET 方式检测系统接口，参数加密，json返回结果，计算服务器响应时间
11. 发送邮件：单发，群发邮件? ?
12. 置二维码：生成 or??解析二维码? ???
13.地图工具：经纬度操作
14.即时通讯：打开即时聊天窗口
15.在线管理：(统计在线人数和在线列表，可强制某用户下线)，同一用户只能在一个客户端登录
-------------------------------------------------------------------------------------------------------------------------
菜单权限：分配给每个角色不同的菜单权限, 每个角色看到的菜单不同
按钮权限：独立分配不同的角色不同的功能权限，增删改查权限分配具体到不同的菜单
支持多用户分权限管理后台,??权限具体到不同的菜单不同的按钮
--------------------------------------------------------------------------------------------------------------信息模块(小项目代码中)
新闻管理：新闻的维护、发布、权重排序等 采用百度ueditor富文本框
公告管理：公告的维护、发布
广告管理：广告的维护、发布，状态维护，上传广告图片
友情链接：友情链接的维护、状态维护
特别推荐：特别推荐、状态维护
微信模块
关注回复：微信用户关注公众号回复
文本回复：匹配关键词进行文本回复
图文回复：匹配关键词进行图文回复
应用命令：匹配关键词进行命令操作，例如微信发送命令，执行服务器重启、关机、锁定等操作
-------------------------------------------------------------------------------------------------------------------------
技术点
1. 导出 导入 excel 文件
2??导出word文件
3. IO 流上传下载文件
4. 群发邮件，可以发html、纯文本格式，可以发给任意邮箱(实现批量发送广告邮件)
5. 群发or单独 发送短信，支持两种第三方短信商接口
6. spring? ?aop??事物处理
7. 代码生成器 (freemarker)， 代码 zip 压缩打包
8. MD5加密 SHA加密（登录密码用此加密）接口加密身份校验
9. 数据库连接池??阿里的 druid。Druid在监控、可扩展性、稳定性和性能方面都有明显的优势,支持并发
10.加入安全框架 shiro (登录授权)(session管理)
11.根据汉字 解析汉字的全拼(拼音)和首字母(导入excel到用户表，根据用户的汉字姓名生成拼音的用户名)
12.app接口@ResponseBody（支持与其它语言数据交互）
13.极光推送 (推送给APP及时消息，APP不启动也能收到)
14.微信接口(身份验证，文本、图文回复等) 微信远程控制服务器重启、锁定、其它应用程序
15.java Quartz 定时器 （定时执行某程序，精确到秒，可设置周期）
16.java websocket 即时通讯技术，点对点，群聊，单聊，EXT4对话框
17.新增Lucene全文检索
18.Base64传输图片
19.图片加水印(图片水印，文字水印）
20.生成 or??解析 二维码
21.HTML5 + JAVAEE??WebSocket 通信技术，WebSocket 验证用户登录，强制某用户下线
22.批量异步上传图片，可预览，有进度条，支持拖拽上传(百度webuploader )。列表动态滑动放大展示。
23.ehcache 自定义二级缓存 ，选择缓存存放目录，处理并发，增加系统性能
24.服务器内部GET POST 请求
25.uploadify 上传插件，单条、批量上传多线程，带进度条，异步，图片、视频, 其它文件格式均可上传
26.地图选点获取经纬度坐标，根据俩经纬度计算距离
27.tab标签页面功能，标签自由切换，不重复操作数据库
-------------------------------------------------------------------------------------------------------------------------
系统框架为：springmvc + mybaits 3.2 有 maven 版本和 非maven 版本 jdk 1.6 1.7 1.8??tomcat 6 7 8
数据库：oracle 版本 和 msyql 版本 ( spring3.0 和4.02??mybaits 3.2)? ???开发工具：myeclipse??eclipse 均可
赠送 同UI? ?? ?springmvc + hibernate??SpringSecurity Lucene Quartz MySQL、Oracle、SQL Server
-------------------------------------------------------------------------------------------------------------------------
系统演示视频：http://pan.baidu.com/s/1kTDvAn1 之前录的(有点粗糙, 凑合着看)
qq：313596790
--------------------------------------------------------------------------------------------------------------------
PC实物截图如下
登录界面背景用HTML5特效自动切换(百叶窗，幕布等多种切换方式)
