Spring Boot构建RESTful API与单元测试

首先,回顾并详细说明一下在快速入门中使用的 @Controller@RestController@RequestMapping注解。如果您对Spring MVC不熟悉并且还没有尝试过快速入门案例,建议先看一下快速入门的内容。

  • @Controller:修饰class,用来创建处理http请求的对象
  • @RestController:Spring4之后加入的注解,原来在 @Controller中返回json需要 @ResponseBody来配合,如果直接用 @RestController替代 @Controller就不需要再配置 @ResponseBody,默认返回json格式。
  • @RequestMapping:配置url映射

下面我们尝试使用Spring MVC来实现一组对User对象操作的RESTful API,配合注释详细说明在Spring MVC中如何映射HTTP请求、如何传参、如何编写单元测试。

* RESTful API具体设计如下:*

User实体定义:

public class User {    
private Long id; 
private String name;   
private Integer age;     // 省略setter和getter } 

实现对User对象的操作接口

下面针对该Controller编写测试用例验证正确性,具体如下。当然也可以通过浏览器插件等进行请求提交验证。

@RunWith(SpringJUnit4ClassRunner.class) 
@SpringApplicationConfiguration(classes = MockServletContext.class)
 @WebAppConfiguration public class ApplicationTests {    
  private MockMvc mvc;     
  @Before    
  
    public void setUp() throws Exception {   
          mvc = MockMvcBuilders.standaloneSetup(new UserController()).build(); 
  }     
  
  @Test     public void testUserController() throws Exception {        
   // 测试UserController         
   RequestBuilder request = null;       
     // 1、get查一下user列表,应该为空      
        request = get("/users/");         
        mvc.perform(request)                
         .andExpect(status().isOk())            
              .andExpect(content().string(equalTo("[]")));  
                     //2、post提交一个user    
          request = post("/users/")      
          .param("id", "1")                 
          .param("name", "测试大师")                 
          .param("age", "20");        
           mvc.perform(request)           
                 .andExpect(content().string(equalTo("success")));       
                   // 3、get获取user列表,应该有刚才插入的数据    
          request = get("/users/");     
          mvc.perform(request)                 
          .andExpect(status().isOk())                 
          .andExpect(content().string(equalTo("[{\"id\":1,\"name\":\"测试大师\",\"age\":20}]")));         
          // 4、put修改id为1的user         
          request = put("/users/1")                 
          
          .param("name", "测试终极大师")                
           .param("age", "30");         
           mvc.perform(request)                 
           .andExpect(content().string(equalTo("success")));         
           // 5、get一个id为1的user         
           request = get("/users/1");         
           mvc.perform(request)                 
           .andExpect(content().string(equalTo("{\"id\":1,\"name\":\"测试终极大师\",\"age\":30}")));
           // 6、del删除id为1的user         
           
           request = delete("/users/1");         
           mvc.perform(request)                 
           .andExpect(content().string(equalTo("success")));         
           // 7、get查一下user列表,应该为空         
           request = get("/users/");         
           mvc.perform(request)                 
           .andExpect(status().isOk())                 
           .andExpect(content().string(equalTo("[]"))); 
               } 
} 

至此,我们通过引入web模块(没有做其他的任何配置),就可以轻松利用Spring MVC的功能,以非常简洁的代码完成了对User对象的RESTful API的创建以及单元测试的编写。其中同时介绍了Spring MVC中最为常用的几个核心注解: @Controller, @RestController, RequestMapping以及一些参数绑定的注解: @PathVariable, @ModelAttribute, @RequestParam等。

原文发布于微信公众号 - 程序猿DD(didispace)

原文发表时间:2017-08-01

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏乐沙弥的世界

ORA-27090 故障一例

    最近的alert日志中碰到了ORA-27090的错误信息,其错误提示为Unable to reserve kernel resources for as...

732
来自专栏程序猿DD

Spring Boot使用@Async实现异步调用:ThreadPoolTaskScheduler线程池的优雅关闭

上周发了一篇关于Spring Boot中使用 @Async来实现异步任务和线程池控制的文章:《Spring Boot使用@Async实现异步调用:自定义线程池》...

6087
来自专栏A周立SpringCloud

使用Feign实现Form表单提交

之前,笔者写了《使用Spring Cloud Feign上传文件》。近日,有同事在对接遗留的Struts古董系统,需要使用Feign实现Form表单提交。其实步...

5256
来自专栏好好学java的技术栈

SpringMVC+RestFul详细示例实战教程(实现跨域访问)

**REST(Representational State Transfer)**,中文翻译叫“表述性状态转移”。是 Roy Thomas Fielding 在...

2054
来自专栏阿杜的世界

在Spring Boot项目中使用Spock框架

Spock框架是基于Groovy语言的测试框架,Groovy与Java具备良好的互操作性,因此可以在Spring Boot项目中使用该框架写优雅、高效以及DSL...

2681
来自专栏软件开发

Spring MVC 学习总结(十一)——IDEA+Maven+多模块实现SSM框架集成

与SSH(Struts/Spring/Hibernate/)一样,Spring+SpringMVC+MyBatis也有一个简称SSM,Spring实现业务对象管...

2542
来自专栏用户2442861的专栏

cmake教程4(find_package使用)

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/haluoluo211/article/d...

3723
来自专栏bboysoul

使用永恒之蓝(MS17-010)漏洞入侵windows7

前几天,被勒索病毒(Wannacry)刷屏了,这个病毒是大家知道了备份文件的重要性,当然,我是不怕什么病毒的,因为我是一天备份一次文件,而且微云一份,坚果云,移...

1.8K4
来自专栏扎心了老铁

springboot kafka集成(实现producer和consumer)

本文介绍如何在springboot项目中集成kafka收发message。 1、先解决依赖 springboot相关的依赖我们就不提了,和kafka相关的只依赖...

9135
来自专栏Albert陈凯

2018-11-17 面试必问问题TransactionalJava事务之一——Java事务的基本问题

关于加@Transactional注解的方法之间调用,事务是否生效的问题 https://blog.csdn.net/blacktal/article/det...

2732

扫码关注云+社区

领取腾讯云代金券