RestTemplate---Spring提供的轻量Http Rest 风格API调用工具

2019/04/10 10:10
阅读数 46

前言

今天在学习Spring Cloud的过程中无意发现了 RestTemplate 这个Spring 提供的Http Rest风格接口之间调用的模板工具类,感觉比Apache提供的HttpClient更加轻量化,只需要在容器中初始化该对象之后就可以使用,因此决定探索一下。

准备工作

首先创建一个SpringBoot父工程,添加必要的依赖,创建Mysql表,加入一些测试数据:

这里我创建了一个 emp 员工表,添加了两条测试数据,SQL语句如下:

创建表

DROP TABLE IF EXISTS `emp`;

CREATE TABLE `emp` (
  `id` bigint(20) NOT NULL COMMENT '主键',
  `name` varchar(32) NOT NULL COMMENT '姓名',
  `join_time` datetime DEFAULT NULL COMMENT '入职时间',
  `sex` tinyint(4) DEFAULT NULL COMMENT '性别 0 未知 1 男 2 女',
  `address` varchar(64) DEFAULT NULL COMMENT '地址',
  `education_background` varchar(64) DEFAULT NULL COMMENT '教育背景',
  `age` tinyint(3) unsigned DEFAULT NULL COMMENT '年龄',
  `remark` varchar(128) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

/*Data for the table `emp` */

insert  into `emp`(`id`,`name`,`join_time`,`sex`,`address`,`education_background`,`age`,`remark`) values (1,'无忧','2020-01-28 21:17:07',1,'陕西省/西安市/雁塔区/某某街道','本科',23,'创始人'),(2,'忘我','2020-01-28 21:18:12',1,'陕西省/西安市/雁塔区/某某街道','本科',22,'合伙人');

逆向生成

接着逆向生成实体类,Mapper和XML文件。这里我参考了博客:坚持到底的博客 博主解释的很详细,我就不重复说明了。

Service和Controller

service和controller 书写起来也比较简单,只是一些基本的CRUD,这里我额外的添加了pageHelper 分页助手插件,为了更好的模拟线上真实环境。

至此,整个项目的目录结构如下:

1580223958684

通过浏览器访问对应的接口地址,获得的数据如下。证明项目已经跑通。准备工作完成:

1580224000291

初步使用RestTemplate

创建项目

新建一个SpringBoot项目,为了方便,我这里只写Controller

利用SpringIOC创建Bean

在启动类中往容器中注入RestTemplate的Bean

@SpringBootApplication
public class BossApplication {
    public static void main(String[] args) {
        SpringApplication.run(BossApplication.class, args);
    }

    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }
}

使用其Get Api

在新项目中的Controller中注入Bean,然后调用其对应的Api即可快速的通过Http的方式调用接口了

@RestController
@RequestMapping("boss")
public class BossController {

    @Autowired
    private RestTemplate restTemplate;

    @RequestMapping("employ/{id}")
    public ResponseEntity<Emp> employById(@PathVariable Long id){
        ResponseEntity<Emp> emp = null;
        emp = restTemplate.getForEntity("http://127.0.0.1:9001/emp/" + id, Emp.class);
        return emp;
    }
}

测试效果如下,可以看到利用9002端口的项目已经调用到9001的项目并成功获取数据:

1580225028150

深入使用

前面我们已经可以初步的使用RestTemplate进行服务之间通过HttpRest请求进行调用了,接下来我们更深入的探索其他的API。Http Rest请求常用的请求方法有4种,分别是 POST、DELETE、PUT、GET。分别对应增删改查4个动作。而在url中加上操作的资源名称。并不出现动词便是我理解的RestFul风格API。下面我对不同的请求方法分别详细介绍其对应的调用方法。

GET

项目中查询的接口一般有两种:根据ID查询详情和根据参数查询列表。根据ID查询详情我已经在前面展示了

这里要说明的就是 getForEntity 和 getForObject 方法,他两的参数是相同的,但返回值类型不同 getForEntity 返回的是 ResponseEntity<T> 对象,在我看来就是将实体类包装,并且携带了响应的状态码,读者可以按需使用。相应的源码如下:

@Nullable
public <T> T getForObject(String url, Class<T> responseType, Object... uriVariables) throws RestClientException {
    RequestCallback requestCallback = this.acceptHeaderRequestCallback(responseType);
    HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor(responseType, this.getMessageConverters(), this.logger);
    return this.execute(url, HttpMethod.GET, requestCallback, responseExtractor, (Object[])uriVariables);
}

// 可以看到,getForEntity 只是对getForObject的结果进行强制类型转换,并没有什么特别的操作
public <T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, Object... uriVariables) throws RestClientException {
    RequestCallback requestCallback = this.acceptHeaderRequestCallback(responseType);
    ResponseExtractor<ResponseEntity<T>> responseExtractor = this.responseEntityExtractor(responseType);
    return (ResponseEntity)nonNull(this.execute(url, HttpMethod.GET, requestCallback, responseExtractor, uriVariables));
}

带请求参数的GET

项目中一般都会有分页条件查询的接口,此时请求参数以key value 形式提交。我们只需要调用对应的重载方法即可

例如有如下接口。根据性别分页查询员工:

@RequestMapping("/list/{sex}/{pageNum}/{pageSize}")
public List<Emp> getByParam(@PathVariable Integer sex,
                            @PathVariable Integer pageNum,
                            @PathVariable Integer pageSize){
    return empService.getListByPara(pageNum, pageSize, sex);
}

我们通过RestTemplate可以这样查询:

@RequestMapping("employList/{sex}")
public List employById1(@PathVariable Integer sex,
                        @RequestParam Integer pageNum,
                        @RequestParam Integer pageSize) {
    // 直接返回对象
    List emp = null;
    Map<String, Object> paraMap = new HashMap<>();
    paraMap.put("pageNum", pageNum);
    paraMap.put("pageSize", pageSize);
    paraMap.put("sex", sex);
    // 通过map的形式,spring会将url对应的参数key替换成value
    //        emp = restTemplate.getForObject("http://127.0.0.1:9001/emp/list/{sex}/{pageNum}/{pageSize}", List.class, paraMap);
    // 通过可变参的形式,spring会按顺序替换url中的参数
    emp = restTemplate.getForObject("http://127.0.0.1:9001/emp/list/{sex}/{pageNum}/{pageSize}", List.class, pageNum, pageSize, sex);
    return emp;
}

以上是完全按照Rest风格的GET url,参数都是在url上以PathVariable 的形式出现的,但如果参数不在url上,就需要稍加修改了

非Rest风格GET请求

我们知道,GET请求的请求参数一般都在url上拼接。url后面以 ? 开始,key=value 的形式拼接多个请求参数。多个键值对之间用 & 符号连接。我琢磨了很久也只发现了字符串拼接这种传参方式,(惭愧,回去该好好读读 http 请求相关的书籍了)如果读者发现了更好的方法请不吝赐教!实现代码如下:

@RequestMapping("employList1/{sex}")
public List employList1(@PathVariable Integer sex,
                        @RequestParam Integer pageNum,
                        @RequestParam Integer pageSize,
                        HttpServletRequest request) {
    // 直接返回对象
    List emp = null;
    // 请求参数
    Map<String, Object> map= new HashMap<>();
    map.put("pageNum", pageNum);
    map.put("pageSize", pageSize);
    map.put("sex", sex);
	// 在url中拼接参数,然后由spring从map中将值替换
    emp = restTemplate.getForObject("http://127.0.0.1:9001/emp/list/{sex}" + "?pageNum={pageNum}&pageSize={pageSize}", List.class, map);
    return emp;
}

POST

项目中,POST请求一般以JSON的形式发送。基本的发送方法很简单。将对象打包好扔到方法的第二个参数就可以发送了

@RequestMapping("new")
public int addEmploy(@RequestBody Emp emp) {
    return restTemplate.postForObject("http://127.0.0.1:9001/emp/new", emp, Integer.class);
}

PS:在测试 POST 请求的过程中我发现了两处配置问题

  1. 插入的数据乱码,这个需要在数据库连接url中加参数。设置编码位 utf8
url: jdbc:mysql://192.168.25.128:3306/mysql?characterEncoding=UTF-8&useSSL=false&serverTimezone=CTT

  1. 之前写的 select * 查询没有开启mysql下划线到Java驼峰的自动转换,导致入职日期,教育背景字段没有读取成功

这个在 application.yml 中可以配置:

mybatis:
  mapper-locations: classpath:cn/keats/mapper/*Mapper.xml
  configuration:
    map-underscore-to-camel-case: true

PUT DELETE

put 请求类似于 post,delete 请求类似于 get。这里就不在赘述了

后记

RestTemplate的介绍就到这里了,以上的方法基本涵盖了项目目前所有的接口,使用RestTemplate给我的感受就是如果接口完全按照Rest风格书写,使用其方法很简单,基本上一行代码就调用成功了。如果不是完全按照Rest风格的接口就需要多花费一些时间来二次封装接口了。推荐调用Rest风格API时候使用。

GITHUB项目地址

此博客的所有代码都已经同步上传至我的GITHUB仓库中,想要练手的朋友不妨克隆下来使用

RestTemplate 使用介绍 RestTemplate发送GET、POST请求的示例项目

原文出处:https://www.cnblogs.com/keatsCoder/p/12256255.html

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部