48. spring boot单元测试restfull API【从零开始学Spring Boot】

 

 

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

 

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

 

* RESTful API具体设计如下：*

请求类型	URL	功能说明
GET	/users	查询用户列表
POST	/users	创建一个用户
GET	/users/id	根据id查询一个用户
PUT	/users/id	根据id更新一个用户
DELETE	/users/id	根据id删除一个用户

 

User实体定义：

public class User {

   privatelongid;

   private String name;

   private Integer age;

   // 省略setter和getter

}

 

实现对User对象的操作接口：

package com.kfit.controller;

 

import java.util.ArrayList;

import java.util.Collections;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import org.springframework.web.bind.annotation.PathVariable;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RequestMethod;

import org.springframework.web.bind.annotation.RestController;

import com.kfit.demo.User;

 

@RestController

@RequestMapping(value="/users")// 通过这里配置使下面的映射都在/users下  

public class UserController {

   

    //这里为了方便测试，直接将数据存储在map中，实际请从数据库获取.

    private static Map<Long,User> users = Collections.synchronizedMap(new HashMap<Long,User>());

   

    /**

     * 返回所有的用户.

     * @return

     */

    @RequestMapping(value="", method=RequestMethod.GET)

    public List<User> getUserList() {

        // 处理"/users/"的GET请求，用来获取用户列表

        // 还可以通过@RequestParam从页面中传递参数来进行查询条件或者翻页信息的传递

        List<User> r = new ArrayList<User>(users.values());

        returnr;

    }

   

    @RequestMapping(value="/{id}", method=RequestMethod.GET)

    public User getUser(@PathVariable Long id) {

        // 处理"/users/{id}"的GET请求，用来获取url中id值的User信息

        // url中的id可通过@PathVariable绑定到函数的参数中

        returnusers.get(id);

    }

   

    /**

     * post 保存用户.

     * @param user

     * @return

     */

    @RequestMapping(value = "",method=RequestMethod.POST)

    public String postUser(User user){

        // 处理"/users/"的POST请求，用来创建User

        //@ModelAttribute User user

        // 除了@ModelAttribute绑定参数之外，还可以通过@RequestParam从页面中传递参数

        users.put(user.getId(), user);

        return"success";

    }

   

    /**

     * 使用put 进行更新用户.

     * @param id

     * @param user

     * @return

     */

    @RequestMapping(value="/{id}",method=RequestMethod.PUT)

    public String putUser(@PathVariable Long id,User user){

        // 处理"/users/{id}"的GET请求，用来获取url中id值的User信息

         User u = users.get(id);

         u.setName(user.getName());

         u.setAge(user.getAge());

         users.put(id, u);

        return"success";

    }

   

    /**

     * 使用delete删除用户.

     * @param id

     * @return

     */

    @RequestMapping(value="/{id}", method=RequestMethod.DELETE)

    public String deleteUser(@PathVariable Long id) {

        // 处理"/users/{id}"的DELETE请求，用来删除User

        // url中的id可通过@PathVariable绑定到函数的参数中

        users.remove(id);

        return"success";

    }

   

}

 

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

 

package com.kfit.demo;

 

import org.junit.Before;

import org.junit.Test;

import org.junit.runner.RunWith;

import org.springframework.boot.test.SpringApplicationConfiguration;

import org.springframework.mock.web.MockServletContext;

import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import org.springframework.test.context.web.WebAppConfiguration;

import org.springframework.test.web.servlet.MockMvc;

import org.springframework.test.web.servlet.RequestBuilder;

import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;

import org.springframework.test.web.servlet.result.MockMvcResultMatchers;

import org.springframework.test.web.servlet.setup.MockMvcBuilders;

 

import com.kfit.controller.UserController;

 

@RunWith(SpringJUnit4ClassRunner.class)

@SpringApplicationConfiguration(classes=MockServletContext.class)//MockServletContext.class

@WebAppConfiguration

public class UserControllerTest extends MockMvcResultMatchers{

   

    //模拟mvc对象类.

    private MockMvc mvc;

   

    @Before

    public void setup(){

       /*

        * MockMvcBuilders使用构建MockMvc对象.

        */

       mvc = MockMvcBuilders.standaloneSetup(new UserController()).build();

    }

   

    @Test

    public void testUserController() throws Exception{

       RequestBuilder request = null;

       //1. get 以下user列表，应该为空》

   

       //1、构建一个get请求.

       request = MockMvcRequestBuilders.get("/users");

       mvc.perform(request)

           .andExpect(status().isOk())

           .andExpect(content().string("[]"))

           ;

       System.out.println("UserControllerTest.testUserController().get");

      

       // 2、post提交一个user

       request = MockMvcRequestBuilders.post("/users")

                                   .param("id","1")

                                   .param("name","林峰")

                                   .param("age","20")

              ;

      

      

        mvc.perform(request).andExpect(status().isOk()).andExpect(content().string("success"));

 

       // 3、get获取user列表，应该有刚才插入的数据

       request = MockMvcRequestBuilders.get("/users");

    mvc.perform(request).andExpect(status().isOk()).andExpect(content().string("[{\"id\":1,\"name\":\"林峰\",\"age\":20}]"));

      

      

       // 4、put修改id为1的user

        request = MockMvcRequestBuilders.put("/users/1")

                .param("name", "林则徐")

                .param("age", "30");

        mvc.perform(request)

                .andExpect(content().string("success"));

       

        // 5、get一个id为1的user

        request = MockMvcRequestBuilders.get("/users/1");

        mvc.perform(request)

                .andExpect(content().string("{\"id\":1,\"name\":\"林则徐\",\"age\":30}"));

      

       

       

     // 6、del删除id为1的user

        request = MockMvcRequestBuilders.delete("/users/1");

        mvc.perform(request)

                .andExpect(content().string("success"));

 

        // 7、get查一下user列表，应该为空

        request = MockMvcRequestBuilders.get("/users");

        mvc.perform(request)

                .andExpect(status().isOk())

                .andExpect(content().string("[]"));

       

    }

   

}

 

 

   至此，我们通过引入web模块（没有做其他的任何配置），就可以轻松利用Spring MVC的功能，以非常简洁的代码完成了对User对象的RESTful API的创建以及单元测试的编写。

 

 

  【Spring Boot 系列博客】

à悟空学院：https://t.cn/Rg3fKJD

学院中有Spring Boot相关的课程！点击「阅读原文」进行查看！

SpringBoot视频：http://t.cn/A6ZagYTi

Spring Cloud视频：http://t.cn/A6ZagxSR

SpringBoot Shiro视频：http://t.cn/A6Zag7IV

SpringBoot交流平台：https://t.cn/R3QDhU0

SpringData和JPA视频：http://t.cn/A6Zad1OH

SpringSecurity5.0视频：http://t.cn/A6ZadMBe

Sharding-JDBC分库分表实战：http://t.cn/A6ZarrqS

分布式事务解决方案「手写代码」：http://t.cn/A6ZaBnIr

 

网易云课堂视频最新更新：

第十一章 Spring Boot 日志

1、spring boot日志—理论

2、Spring Boot日志-logback

3、Spring Boot日志-log4j2

第十二章 Spring Boot 知识点2

1、spring boot 服务配置和部署

2、Spring Boot 定制URL匹配规则

 

 

历史章节：

 

第一章 快速开始

1、Spring Boot之Hello World

2、Spring Boot之Hello World访问404

 

第二章 Spring Boot之JSON

1、spring boot返回json数据

2、Spring Boot完美使用FastJson解析JSON数据

 

第三章 Spring Boot热部署

1、Spring Boot热部署(springloader)

2、springboot + devtools（热部署）

 

第四章 Spring Boot数据库

1、Spring Boot JPA/Hibernate/Spring Data概念

2、Spring Boot JPA-Hibernate

3、Spring Boot Spring Data JPA介绍

4、Spring Boot JdbcTemplate

5、Spring Boot集成MyBatis

 

第五章 web开发

1、全局异常捕捉

2、配置server信息

3、spring boot使用thymeleaf

4、Spring Boot 使用freemarker

5、Spring Boot添加JSP支持

 

第六章 定时任务

1、Spring Boot定时任务

2、Spring Boot 定时任务升级篇（动态修改cron参数）

3、Spring Boot 定时任务升级篇（动态添加修改删除定时任务）

4、Spring Boot 定时任务升级篇（集群/分布式下的定时任务说明）

5、Spring Boot Quartz介绍

6、Spring Boot Quartz在Java Project中使用

7、Spring Boot 集成Quartz普通使用

8、Spring Boot 集成Quartz升级版

9、Spring Boot 集成Quartz二次升级版

10、Spring Boot 集成Quartz-Job如何自动注入Spring容器托管的对象

 

第七章 Spring Boot MyBatis升级篇

1、Spring Boot MyBatis升级篇-注解

2、Spring Boot MyBatis升级篇-注解-自增ID

3、Spring Boot MyBatis升级篇-注解-增删改查

4、Spring Boot MyBatis升级篇-注解-分页查询

5、Spring Boot MyBatis升级篇-注解-分页PageHelper不生效

6、Spring Boot MyBatis升级篇-注解- mybatic insert异常：BindingException: Parameter 'name' not found

7、Spring Boot MyBatis升级篇-注解- #和$符号特别篇

8、Spring Boot MyBatis升级篇-注解-@Result

9、Spring Boot MyBatis升级篇-注解-动态SQL(if test)-方案一:<script>

10、Spring Boot MyBatis升级篇-注解-动态SQL(if test)-方案二:@Provider

11、Spring Boot MyBatis升级篇-注解-动态SQL-参数问题

12、Spring Boot MyBatis升级篇-注解-特别篇：@MapperScan和@Mapper

13、Spring Boot MyBatis升级篇-XML

14、Spring Boot MyBatis升级篇-XML-自增ID

15、Spring Boot MyBatis升级篇-XML-增删改查

16、Spring Boot MyBatis升级篇-XML-分页查询

17、Spring Boot MyBatis升级篇-XML-分页PageHelper不生效

18、Spring Boot MyBatis升级篇-XML-动态SQL(if test)

19、Spring Boot MyBatis升级篇-XML-注解-初尝试

20、Spring Boot MyBatis升级篇- pagehelper替换为pagehelper-spring-boot-starter

 

第八章 Spring Boot 知识点1

1、Spring Boot 拦截器HandlerInterceptor

2、Spring Boot启动加载数据CommandLineRunner

3、Spring Boot环境变量读取和属性对象的绑定

4、Spring Boot使用自定义的properties

5、Spring Boot使用自定义的properties

6、Spring Boot使用@SpringBootApplication

7、Spring Boot 监控和管理生产环境

 

第十章 Spring Boot 打包部署

1、Spring Boot打包部署（(提供Linux的sh文件)）

 

第十一章 Spring Boot 日志

1、spring boot日志—理论

2、Spring Boot日志-logback

3、Spring Boot日志-log4j2

 

 

评论

2 楼 林祥纤 2016-11-27  

k88520 写道

厉害厉害  我对spring mvc还没真的理解透彻 只是学习怎么使用  收获颇丰

这个是需要时间的。

1 楼 k88520 2016-11-23  

厉害厉害  我对spring mvc还没真的理解透彻 只是学习怎么使用  收获颇丰