前言:
  springmvc对注解的支持非常灵活和飘逸, 也得web编程少了以往很大一坨配置项. 另一方面移动互联网的到来, 使得REST API变得流行, 甚至成为主流. 因此我们来关注下springmvc对rest api的支持程度, 以及需要做的工作评估.

样例设计和准备:
  springmvc学习笔记系列的文章目录:
  • idea创建springmvc项目
  REST API的设计原则遵循之前的博文来实现
  • 移动互联网实战--Web Restful API设计和基础架构 
  初步设计一个查询系统, 通过userid, 返回该用户的详细信息.
  请求url:

http://{host}:{port}/rest/demo/query_user_by_id?user_id={user_id}

  响应结果:

{
  success:true,
  errCode:0,
  errMsg:"OK",
  value:{
    username:"lilei",
    userId:"1001",
    age:18
  }
}

  样例中, 请求参数扁平化(HTTP request params), 结果采用JSON来组织.

编程:
  按之前博文"idea创建springmvc项目"创建springmvc项目.
  先在mvc-dispatcher-servlet.xml中, 添加如下项

<context:annotation-config>
<mvc:annotation-driven />

  注: 支持各类注解类, 如ResponseBody, RequestBody, JSON/XMl转化.
  添加实体类TResult和UserInfo类.
  TResult类设计如下:

public class TResult<T> {

  private boolean success = false;

  private int errCode = 0;

  private String errMsg = "OK";

  private T value = null;

}

  注: 这边省略了各个属性成员的getter和setter, 需要补上.
  UserInfo类的定义如下:

public class UserInfo {

  private String userId;

  private String username;

  private int age;

}

  注: 这边省略了各个属性成员的getter和setter, 需要补上.
  编写自定义的Controller类RestController.

@Controller
@RequestMapping(value = "/rest/demo")
public class RestController {
  @RequestMapping(value="/query_user_by_id", method=RequestMethod.GET)
  public @ResponseBody TResult<UserInfo> queryUserById(@RequestParam(value="user_id") String userId) {
    TResult<UserInfo> result = new TResult<UserInfo>();
    UserInfo userInfo = new UserInfo();
    userInfo.setUserId(userId);
    userInfo.setUsername("李雷");
    userInfo.setAge(18);
    result.setValue(userInfo);
    result.setSuccess(true);
    return result;
  }
}

  定义了queryUesrById的方法, 返回实体TResult<UserInfo>, 指定注解@ResponseBody, SpringMVC会帮助将其默认转化为JSON格式.

测试和迭代:
  在浏览器中, 输入http://127.0.0.1:8080/rest/demo/query_user_by_id?user_id=1001, 结果如下所示:
  
  出现了http status 406(Not Acceptable)的错误.
  网上搜了一圈后, 尝试各种灵丹妙药后, 大多不灵光. 究其原因, springmvc的版本不一致.
  由于我的springmvc为4.1.1, 则依照博文"Spring WebMVC 4.1返回json时导致的 406(Not Acceptable)问题"的说法, 添加fasterxml的jackson包即可解决.
  在pom.xml中, 添加如下依赖项:

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-core</artifactId>
  <version>2.5.4</version>
</dependency>
<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-annotations</artifactId>
  <version>2.5.4</version>
</dependency>
<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-databind</artifactId>
  <version>2.5.1</version>
</dependency>

  重新部署, 再次测试, 这次正常了.
  
  该案例就正式通过了, 值得庆幸.

问题汇总:
  web开发中, 最让人头痛的就是中文乱码问题了, 所幸这次没有碰到. 不过居安思危, 防范于未然. 这边也总结下.
  若返回的JSON字符串中有中文乱码, 可以在@RequestMapping中, 添加项 produces = "application/json;charset=UTF-8", 构成如下形式:

@RequestMapping(value="/query_user_by_id", method=RequestMethod.GET, produces = "application/json;charset=UTF-8")

  当然也可能是字符编码本身非UTF-8导致, 比如编辑器的文字编码为GBK时, 你按UTF-8返回, 就有可能乱码.
  这可以通过神器idea的右下角编码类型来修改.
  
  对于JAVA实体类转化为JSON格式, 需要该JAVA的POJO类, 需要完备该类的getter/setter方法. 避免莫名其妙的情况.

总结:
  springmvc编写REST API确实方便, 特别是注解类的大量使用, 使得配置精简, 编码灵活. 后续如果有机会, 尝试测试一下springmvc整体的QPS, 看看其作为接入层, 整体的服务能力是多少, 以及如何优化.

写在最后:
  
如果你觉得这篇文章对你有帮助, 请小小打赏下. 其实我想试试, 看看写博客能否给自己带来一点小小的收益. 无论多少, 都是对楼主一种由衷的肯定.

  

springmvc学习笔记---面向移动端支持REST API的更多相关文章

  1. springmvc学习笔记(19)-RESTful支持

    springmvc学习笔记(19)-RESTful支持 标签: springmvc springmvc学习笔记19-RESTful支持 概念 REST的样例 controller REST方法的前端控 ...

  2. springmvc学习笔记--REST API的异常处理

    前言: 最近使用springmvc写了不少rest api, 觉得真是一个好框架. 之前描述的几篇关于rest api的文章, 其实还是不够完善. 比如当遇到参数缺失, 类型不匹配的情况时, 直接抛出 ...

  3. springmvc学习笔记(常用注解)

    springmvc学习笔记(常用注解) 1. @Controller @Controller注解用于表示一个类的实例是页面控制器(后面都将称为控制器). 使用@Controller注解定义的控制器有如 ...

  4. SpringMVC:学习笔记(3)——REST

    SpringMVC:学习笔记(3)——REST 了解REST风格 按照传统的开发方式,我们在实现CURD操作时,会写多个映射路径,比如对一本书的操作,我们会写多个URL,可能如下 web/delete ...

  5. SpringMVC:学习笔记(8)——文件上传

    SpringMVC--文件上传 说明: 文件上传的途径 文件上传主要有两种方式: 1.使用Apache Commons FileUpload元件. 2.利用Servlet3.0及其更高版本的内置支持. ...

  6. springmvc学习笔记(简介及使用)

    springmvc学习笔记(简介及使用) 工作之余, 回顾了一下springmvc的相关内容, 这次也为后面复习什么的做个标记, 也希望能与大家交流学习, 通过回帖留言等方式表达自己的观点或学习心得. ...

  7. SpringMVC学习笔记之二(SpringMVC高级参数绑定)

    一.高级参数绑定 1.1 绑定数组 需求:在商品列表页面选中多个商品,然后删除. 需求分析:功能要求商品列表页面中的每个商品前有一个checkbok,选中多个商品后点击删除按钮把商品id传递给Cont ...

  8. springMVC 学习笔记(一):springMVC 入门

    springMVC 学习笔记(一):spring 入门 什么是 springMVC springMVC 是 spring 框架的一个模块,springMVC 和 spring 无需通过中间整合层进行整 ...

  9. Spring实战第四章学习笔记————面向切面的Spring

    Spring实战第四章学习笔记----面向切面的Spring 什么是面向切面的编程 我们把影响应用多处的功能描述为横切关注点.比如安全就是一个横切关注点,应用中许多方法都会涉及安全规则.而切面可以帮我 ...

随机推荐

  1. cordova 5.0 白名单

    最新的cordova 5.0 更新了白名单机制,增强了安全性,但是也给我们在开发中带来了很多问题: 当你引入谷歌.百度地图时,会出现 Failed to load resource -- 解决办法: ...

  2. Zabbix页面遇到历史记录的乱码需要修改数据库

    Zabbix页面遇到历史记录的乱码需要修改数据库: 解决办法: 1.将 zabbix 数据库中的表备份: 2.手动删除 zabbix 数据库: 3.重新创建 zabbix 库时手动指定字符集为 utf ...

  3. python登陆,注册小程序

    def login(username,password): ''' 用于用户登录 :param username: 用户输入用户名 :param password: 用户输入密码 :return: T ...

  4. jstl c:choose>、<c:when>和<c:otherwise>标签

    <c:choose>.<c:when>和<c:otherwise>在一起连用,可以实现Java语言中的if-else语句的功能.例如以下代码根据username请求 ...

  5. HDU 5442 后缀自动机+kmp

    题目大意: 给定一个字符串,可理解成环,然后选定一位置,逆时针或顺时针走一遍,希望得到字典序最大,如果同样大,希望找到起始位置最小的,如果还相同,就默认顺时针 比赛一直因为处理最小位置出错,一结束就想 ...

  6. HDU 2594 扩展kmp模板题

    题目大意: 给定两个字符串,在第一个字符串中找到一个最大前缀作为第二个字符串的后缀 #include <iostream> #include <cstdio> #include ...

  7. 如何在redhat下安装WineQQ

    使用过redhat的朋友都知道在redhat下要使用聊天工具例如:腾讯QQ只能是用网页QQ,但网页QQ始终用得不尽人意,下面我将给大家介绍一种在redhat下安装WineQQ的方法,让你能在redha ...

  8. 国产ProcessOn和国外gliffy的对比区别【原创】

    之前一直在用国外的作图工具gliffy,不足之处gliffy是英文的,很多国内相关从业者使用起来就有一定门槛,今天我给大家再推荐一款比gliffy更方便的作图工具ProcessOn,除了绘制UML建模 ...

  9. Windows Server 2012 R2 设置

    一.任务栏左下角启动服务器管理器,然后进行设置.1.登录不显示服务器管理器 2.本地服务器,看到右边的IE增强的安全配置,如图所示,关闭两项内容.这样就关闭了IE增强安全提示框. 3.“工具”菜单,启 ...

  10. jQuery中 end(); 的用法

    jQuery中的end()方法的意思 选取某个元素,查找选取其子元素,然后再回过来选取这个元素.用例子说明了一下: 比如HTML代码: <p><span>Hello</s ...