两种类型的接口

软件开发中，常见的接口调用类型有两种，分别是：WebService、WebAPI，它们两种类型的接口，对于调用的方式，到底有哪些区别呢？

如何调用接口

先看一下要调用这两种接口类型，以Java代码为例，需要怎么实现。

Java调用WebAPI

下面这段Java代码示例，表示调用一个WebAPI接口，获取token的过程。

 private final RestTemplate restTemplate = new RestTemplate();   

 public void getToken() {
        String url = "www.baidu.com/api/getToken";

        // 构建请求体
        JSONObject requestBody = new JSONObject();
        requestBody.put("appId", "123456");
        requestBody.put("appSecret", "abcdef");
    
        // 构建请求头
        HttpHeaders headers = new HttpHeaders();
        headers.setContentType("application/json");
    
        // 创建请求实体
        HttpEntity<String> requestEntity = new HttpEntity<>(requestBody.toJSONString(), headers);
        
        try {
            // 发送POST请求
            ResponseEntity<String> response = restTemplate.exchange(
                    url,
                    HttpMethod.POST,
                    requestEntity,
                    String.class
            );
        } catch (RestClientException e) {
            throw new RuntimeException(e);
        }
    }

Java调用WebService

private final RestTemplate restTemplate = new RestTemplate();

 String url = "www.baidu.com/api/gettoken";

        // 构建请求体
        JSONObject requestBody = new JSONObject();
        requestBody.put("appId", "123456");
        requestBody.put("appSecret", "abcdef");


private void getToken() {
            String soapRequest = ""<?xml version=\"1.0\" encoding=\"utf-8\"?>\n" +
                "<soap:Envelope xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" " +
                "xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" " +
                "xmlns:soap=\"http://schemas.xmlsoap.org/soap/envelope/\">\n" +
                "  <soap:Body>\n" +
                "    <getToken xmlns=\"http://tempuri.org/\">\n" +
                "      <UserName>" + interfaceSGConfig.getUsername() + "</UserName>\n" +
                "      <PassWord>" + interfaceSGConfig.getPassword() + "</PassWord>\n" +
                "      <appId>123456</appId>\n" +
                "      <appSecret>abcdef</appSecret>\n" +
                "    </getToken>\n" +
                "  </soap:Body>\n" +
                "</soap:Envelope>";"

            HttpHeaders headers = new HttpHeaders();
            headers.add("Content-Type", "text/xml;charset=utf-8");
            HttpEntity<String> requestEntity = new HttpEntity<>(soapRequest, headers);

            ResponseEntity<String> response = restTemplate.exchange(
                    "www.baidu.com/getToken.asmx",
                    HttpMethod.POST,
                    requestEntity,
                    String.class
            );
    }

以上两段代码，表达了类似的逻辑，都是调用接口，获取token。区别在于一个是调用的WebAPI，另一个是调用的WebService。

两种类型区别

从上面的示例代码中，可以总结一下，两种接口类型，在调用方式上，有以下区别：

现在用的比较多的是webapi的方式定义接口，调用也相对简单。

还有一点就是，无论是Java或是.net，都可以定义WebService或者WebAPI。