码迷,mamicode.com
首页 > Web开发 > 详细

3.消费一个RESTful Web Service

时间:2018-05-29 13:13:43      阅读:277      评论:0      收藏:0      [点我收藏+]

标签:proxy   deploy   getting   repr   yun   known   操作   ted   uid   

这节课我们根据官网教程学习如何去消费(调用)一个 RESTful Web Service 。 原文链接 https://spring.io/guides/gs/consuming-rest/

本指南将引导您完成创建使用RESTful Web服务的应用程序的过程。

我们将会创建什么?

您将构建一个使用Spring RestTemplate的应用程序来检索http://gturnquist-quoters.cfapps.io/api/random中的随机Spring Boot引用。

你需要准备什么?

 如何完成这个指南?

方法有很多种,这里我们仅通过STS来完成这个操作。

参考链接 https://spring.io/guides/gs/sts/

1.  打开我们的STS,点击左上角的File————> New ————> Import Spring Getting Started Content

技术分享图片

 2. 我们这里输入 rest 来搜索出“Consuming Rest”

技术分享图片

Tips:这里勾选构建的类型是Maven项目,Code Sets 两个都勾选,这样会生成两个Project.

complete 是表示已经写好的code,initial是初始化空的项目,我们待会就在这个空的项目中进行修改和尝试。

3.  通过完成项目设置,您可以创建一个使用RESTful服务的简单应用程序。

一个RESTful服务已经在http://gturnquist-quoters.cfapps.io/api/random 站起来了。 它随机提取有关Spring Boot的引用,并将它们作为JSON文档返回。

如果您通过网络浏览器或curl请求该URL,您将收到一个如下所示的JSON文档:

{"type":"success","value":{"id":2,"quote":"With Boot you deploy everywhere you can find a JVM basically."}}

很简单,但通过浏览器获取时不会非常有用。以编程方式更有用的方式来使用REST Web服务。

为了帮助你完成这个任务,Spring提供了一个名为RestTemplate的方便的模板类。 RestTemplate使大多数RESTful服务与单行咒语交互。 它甚至可以将该数据绑定到自定义域类型。

 4. 首先我们需要创建一个Domain 实体类

package hello;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)
public class Quote {

    private String type;
    private Value value;

    public Quote() {
    }

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    public Value getValue() {
        return value;
    }

    public void setValue(Value value) {
        this.value = value;
    }

    @Override
    public String toString() {
        return "Quote{" +
                "type=‘" + type + ‘\‘‘ +
                ", value=" + value +
                ‘}‘;
    }
}

正如你所看到的,这是一个简单的Java类,它有一些属性和匹配的getter方法。 它使用Jackson JSON处理库中的@JsonIgnoreProperties进行了注释,以指示任何未绑定在此类型的属性都应该被忽略。

为了直接将数据绑定到自定义类型,您需要指定变量的名称与从API返回的JSON文档中的键完全相同。 如果JSON文档中的变量名和键不匹配,则需要使用@JsonProperty 注解来指定JSON文档的确切键。

Tips: 注意上面返回的JSON中字段名称是type和value 所以这里我们定义的也是type和value.

5. 需要额外的类来嵌入内部报价本身。

package hello;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;

@JsonIgnoreProperties(ignoreUnknown = true)
public class Value {

    private Long id;
    private String quote;

    public Value() {
    }

    public Long getId() {
        return this.id;
    }

    public String getQuote() {
        return this.quote;
    }

    public void setId(Long id) {
        this.id = id;
    }

    public void setQuote(String quote) {
        this.quote = quote;
    }

    @Override
    public String toString() {
        return "Value{" +
                "id=" + id +
                ", quote=‘" + quote + ‘\‘‘ +
                ‘}‘;
    }
}

Tips: 由于上面返回的JSON 中value 是一个对象,包含id和quote,所以这里我们需要一个额外的类来定义它。

6.使这个应用程序变得可执行

虽然可以将此服务作为传统WAR文件打包以部署到外部应用程序服务器,但下面演示的更简单的方法会创建独立应用程序。 您将所有内容打包到一个单独的,可执行的JAR文件中,由一个良好的旧Java main()方法驱动。 一路上,您使用Spring的支持将Tomcat servlet容器作为HTTP运行时嵌入,而不是部署到外部实例。

现在您可以编写使用RestTemplate的Application类来从Spring Boot报价服务中获取数据。

package hello;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.client.RestTemplate;
public class Application {

    private static final Logger log = LoggerFactory.getLogger(Application.class);
    
    public static void main(String[] args) {
        // TODO Auto-generated method stub
         RestTemplate restTemplate = new RestTemplate();
         Quote quote = restTemplate.getForObject("http://gturnquist-quoters.cfapps.io/api/random", Quote.class);
         log.info(quote.toString());

    }

}

Tips: 这里我们可以看到通过一个RestTemplate 对象的方法,我们消费(调用)了另外一个Restfule web service 的数据。有了这种调用方式,我们便将不再需要编写Httpclient方法来处理调用。

由于Jackson JSON处理库位于类路径中,RestTemplate将使用它(通过消息转换器)将传入的JSON数据转换为Quote对象。 从那里,Quote对象的内容将被记录到控制台。

在这里,您只使用RestTemplate进行HTTP GET请求。 但RestTemplate还支持其他HTTP动词,例如POST,PUT和DELETE。

打印控制台如图所示:

技术分享图片

7. 使用Spring Boot管理应用程序生命周期

到目前为止,我们还没有在我们的应用程序中使用过Spring Boot,但这样做有一些优点,而且这并不难。 其中一个优点是我们可能希望让Spring Boot管理RestTemplate中的消息转换器,以便自定义很容易以声明方式添加。 为此,我们在主类上使用@SpringBootApplication并转换主要方法来启动它,就像在任何Spring Boot应用程序中一样。 最后,我们将RestTemplate移动到一个CommandLineRunner回调函数中,以便在启动时由Spring Boot执行:

src/main/java/hello/Application.java

package hello;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.client.RestTemplateBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;

@SpringBootApplication
public class Application {

    private static final Logger log = LoggerFactory.getLogger(Application.class);
    
    public static void main(String[] args) {
        // TODO Auto-generated method stub
        SpringApplication.run(Application.class);
        
//         RestTemplate restTemplate = new RestTemplate();
//         Quote quote = restTemplate.getForObject("http://gturnquist-quoters.cfapps.io/api/random", Quote.class);
//         log.info(quote.toString());

    }
    
    @Bean
    public RestTemplate restTemplate(RestTemplateBuilder builder) {
        return builder.build();
    }

    @Bean
    public CommandLineRunner run(RestTemplate restTemplate) throws Exception {
        return args -> {
            Quote quote = restTemplate.getForObject("http://gturnquist-quoters.cfapps.io/api/random", Quote.class);
            log.info(quote.toString());
        };
    }

}

Tips: 刚才那种方式显然并不优雅,我们注释掉刚才的内容更换成使用Spring Boot 的code 来看下。通过这种方式显然更优雅地调用了 其他Restful Web service.

RestTemplateBuilder由Spring注入,如果您使用它创建RestTemplate,那么您将受益于Spring Boot中使用消息转换器和请求工厂进行的所有自动配置。

我们还将RestTemplate提取到@Bean中以使其更易于测试(这样可以更轻松地进行模拟)。

8.编译生一个可执行的Jar

您可以使用Gradle或Maven从命令行运行应用程序。 或者您可以构建一个包含所有必需的依赖项,类和资源的可执行JAR文件,并运行该文件。 这使得在整个开发生命周期内跨越不同环境等,将服务作为应用程序发布,版本化和部署变得非常容易。

这一步我们使用STS中集成的工具来操作生成一个可执行的Jar,如图所示:

技术分享图片

之后我们应该能看到target 文件夹下多了一个文件

技术分享图片

 

如果您正在使用Gradle,则可以使用./gradlew bootRun运行该应用程序。 或者您可以使用./gradlew构建构建JAR文件。 然后你可以运行JAR文件:

java -jar build/libs/gs-consuming-rest-0.1.0.jar

如果您使用的是Maven,则可以使用./mvnw spring-boot:run来运行该应用程序。 或者,您可以使用./mvnw clean包构建JAR文件。 然后你可以运行JAR文件:

java -jar target/gs-consuming-rest-0.1.0.jar

上述过程将创建一个可运行的JAR。 您也可以选择构建经典的WAR文件。

您应该看到如下所示的输出,并随机引用:

技术分享图片

如果你看到错误无法提取响应:没有找到合适的HttpMessageConverter用于响应类型[class hello.Quote],那么你有可能处于一个无法连接到后端服务的环境中(如果可以的话,它会发送JSON)。 也许你背后是一个公司代理? 尝试将标准系统属性http.proxyHost和http.proxyPort设置为适合您的环境的值。

 好了本节课到这里就结束了,通过本节课我们发现Spring Boot 中服务之间相互调用时最原生的其实是通过这种方式调用的。

源码:https://github.com/geekxingyun/JavaEE-Framework-Sample/tree/master/Spring-Consume-Restful-Web-Service-Sample

3.消费一个RESTful Web Service

标签:proxy   deploy   getting   repr   yun   known   操作   ted   uid   

原文地址:https://www.cnblogs.com/xingyunblog/p/9104411.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!