RestTemplate 详解

时间 2021-02-14

标签 html java segmentfault app 负载均衡函数 post spa .net 栏目 HTML 繁體版

原文原文链接

背景

这段时间本身作的项目中须要调用服务提供者的服务（接口），具体就是：我这边须要将页面所输入的 Groovy 脚本代码传给别人提供的服务接口，而后那边返回脚本编译的结果给我，我须要将编译结果展现在页面，用的就是 RestTemplate 了，那 RestTemplate 是什么呢？简单说就是：简化了发起 HTTP 请求以及处理响应的过程，而且支持 REST 。下文就稍微总结下。
html

如何使用

先讲讲如何使用吧，我项目是 SpringBoot 项目，能够在启动类中加入：java

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

而后在 Controller 层中引入：segmentfault

@Autowired
private RestTemplate restTemplate;

接下来就能够在 Controller 中各个方法中使用 restTemplate 了，可是 restTemplate 里面有什么方法呢？app

RestTemplate 内部方法

从图中 RestTemplate 能够看到有不少方法，咱们能够提取出主要的几种方法是：负载均衡

GET
POST
PUT
DELETE
HEAD
OPTIONS
EXCHANGE
EXECUTE

图片中依然能够知道 RestTemplate 类中的方法主要是来自接口 RestOperations，下面咱们具体看看这些方法里面的具体实现与该如何使用。函数

Get 方法

在 RestTemplate 中，发送一个 GET 请求，咱们能够经过以下两种方式：post

getForEntityui

getForEntity 方法的返回值是一个ResponseEntity<T>，ResponseEntity<T>是 Spring 对 HTTP 请求响应的封装，包括了几个重要的元素，如响应码、contentType、contentLength、响应消息体等。好比下面一个例子：spa
```
@RequestMapping("/gethello")
public String getHello() {
    ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://HELLO-SERVICE/hello", String.class);
    String body = responseEntity.getBody();
    HttpStatus statusCode = responseEntity.getStatusCode();
    int statusCodeValue = responseEntity.getStatusCodeValue();
    HttpHeaders headers = responseEntity.getHeaders();
    StringBuffer result = new StringBuffer();
    result.append("responseEntity.getBody()：").append(body).append("<hr>")
            .append("responseEntity.getStatusCode()：").append(statusCode).append("<hr>")
            .append("responseEntity.getStatusCodeValue()：").append(statusCodeValue).append("<hr>")
            .append("responseEntity.getHeaders()：").append(headers).append("<hr>");
    return result.toString();
}
```
关于这段代码，说以下几点：.net
- getForEntity 的第一个参数为我要调用的服务的地址，这里我调用了服务提供者提供的 /hello 接口，注意这里是经过服务名调用而不是服务地址，若是写成服务地址就无法实现客户端负载均衡了。（备注：我项目中须要经过 ConsulClient 去获取服务名，而后在去获取服务的 IP 和 Port，并把它拼接起来组合成个人服务地址，因此就无法实现客户端的负载均衡了，若是要是实现负载均衡，能够在 SpringBoot 启动类的中加入注解 @LoadBalanced, 以下:
```
@Bean
@LoadBalanced
public RestTemplate restTemplate() {
  return new RestTemplate();
}
```
  ）
- getForEntity 第二个参数 String.class 表示我但愿返回的 body 类型是 String
- 拿到返回结果以后，将返回结果遍历打印出来

有时候我在调用服务提供者提供的接口时，可能须要传递参数，有两种不一样的方式:

@RequestMapping("/sayhello")
public String sayHello() {
    ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://HELLO-SERVICE/sayhello?name={1}", String.class, "张三");
    return responseEntity.getBody();
}
@RequestMapping("/sayhello2")
public String sayHello2() {
    Map<String, String> map = new HashMap<>();
    map.put("name", "李四");
    ResponseEntity<String> responseEntity = restTemplate.getForEntity("http://HELLO-SERVICE/sayhello?name={name}", String.class, map);
    return responseEntity.getBody();
}

能够用一个数字作占位符，最后是一个可变长度的参数，来一一替换前面的占位符
也能够前面使用 name={name} 这种形式，最后一个参数是一个 map，map 的 key 即为前边占位符的名字，map的 value 为参数值

第一个调用地址也能够是一个URI而不是字符串，这个时候咱们构建一个URI便可，参数神马的都包含在URI中了，以下：

@RequestMapping("/sayhello3")
public String sayHello3() {
    UriComponents uriComponents = UriComponentsBuilder.fromUriString("http://HELLO-SERVICE/sayhello?name={name}").build().expand("王五").encode();
    URI uri = uriComponents.toUri();
    ResponseEntity<String> responseEntity = restTemplate.getForEntity(uri, String.class);
    return responseEntity.getBody();
}

经过Spring中提供的UriComponents来构建Uri便可。

固然，服务提供者不只能够返回String，也能够返回一个自定义类型的对象，好比个人服务提供者中有以下方法：

@RequestMapping(value = "/getbook1", method = RequestMethod.GET)
public Book book1() {
    return new Book("三国演义", 90, "罗贯中", "花城出版社");
}

对于该方法我能够在服务消费者中经过以下方式来调用：

@RequestMapping("/book1")
public Book book1() {
    ResponseEntity<Book> responseEntity = restTemplate.getForEntity("http://HELLO-SERVICE/getbook1", Book.class);
    return responseEntity.getBody();
}

运行结果以下：

getForObject

getForObject 函数其实是对 getForEntity 函数的进一步封装，若是你只关注返回的消息体的内容，对其余信息都不关注，此时可使用 getForObject，举一个简单的例子，以下：
```
@RequestMapping("/book2")
public Book book2() {
    Book book = restTemplate.getForObject("http://HELLO-SERVICE/getbook1", Book.class);
    return book;
}
```

POST 方法

在 RestTemplate 中，POST 请求能够经过以下三个方法来发起：

postForEntity

该方法和get请求中的getForEntity方法相似，以下例子：

@RequestMapping("/book3")
public Book book3() {
    Book book = new Book();
    book.setName("红楼梦");
    ResponseEntity<Book> responseEntity = restTemplate.postForEntity("http://HELLO-SERVICE/getbook2", book, Book.class);
    return responseEntity.getBody();
}

方法的第一参数表示要调用的服务的地址
方法的第二个参数表示上传的参数
方法的第三个参数表示返回的消息体的数据类型

我这里建立了一个Book对象，这个Book对象只有name属性有值，将之传递到服务提供者那里去，服务提供者代码以下：

@RequestMapping(value = "/getbook2", method = RequestMethod.POST)
public Book book2(@RequestBody Book book) {
    System.out.println(book.getName());
    book.setPrice(33);
    book.setAuthor("曹雪芹");
    book.setPublisher("人民文学出版社");
    return book;
}

服务提供者接收到服务消费者传来的参数book，给其余属性设置上值再返回，调用结果以下：

postForObject

若是你只关注，返回的消息体，能够直接使用postForObject。用法和getForObject一致。
postForLocation

postForLocation 也是提交新资源，提交成功以后，返回新资源的 URI，postForLocation 的参数和前面两种的参数基本一致，只不过该方法的返回值为 URI ，这个只须要服务提供者返回一个 URI 便可，该 URI 表示新资源的位置。

PUT 方法

在 RestTemplate 中，PUT 请求能够经过 put 方法调用，put 方法的参数和前面介绍的 postForEntity 方法的参数基本一致，只是 put 方法没有返回值而已。举一个简单的例子，以下：

@RequestMapping("/put")
public void put() {
    Book book = new Book();
    book.setName("红楼梦");
    restTemplate.put("http://HELLO-SERVICE/getbook3/{1}", book, 99);
}

book对象是我要提交的参数，最后的99用来替换前面的占位符{1}

DELETE 方法

delete 请求咱们能够经过 delete 方法调用来实现，以下例子：

@RequestMapping("/delete")
public void delete() {
    restTemplate.delete("http://HELLO-SERVICE/getbook4/{1}", 100);
}

HEADER 方法

返回资源的全部 HTTP headers。

OPTIONS

问能够执行哪些方法。

EXCHANGE

与其它接口的不一样：

容许调用者指定HTTP请求的方法（GET,POST,PUT等）
能够在请求中增长body以及头信息，其内容经过参数 HttpEntity<?>requestEntity 描述
exchange支持‘含参数的类型’（即泛型类）做为返回类型，该特性经过 ParameterizedTypeReference<T>responseType 描述