REST API 客户端设计

Question

我想创建一个 REST API 客户端，它对于同一个 REST API 服务器将调用不同的 URL。这种不同的调用将向客户端返回 JSON 和 XML。 什么是适合这种情况的好的设计模式？

到目前为止，我已经想出了策略和命令的组合：

public interface IRestCall {
    /** Setup the URL for the call. */
    void setup(IRestSetup setup) throws Exception;
    /** Execute the call, using the URL set up in the first step. 
     * @throws Exception */
    void call() throws Exception;
    /** Process the result and return to the user. */
    <T> T getResult(IRestResultProcessor<T> result) throws Exception;
} 

这是策略界面。该战略的背景将 在 Facade 类的某些 Get/Post/Put 方法中。

IRestSetup 和 IRestResultProcessor 是 Command 对象的接口 这将为 REST API 设置 URL 并处理结果。

Answer 1

我认为您不需要一些特殊的设计模式来处理这种情况。我个人只会为 GET 和 POST 请求添加一些通用方法。下面的代码只处理 GET 请求，但应该足以理解我的意思。

您处理 GET 请求的客户端方法可能类似于

/**
restUrl - url to the service 
resClz - the actual POJO object that the JSON or XML response will be mapped to
resType - type of MIME object returned by the server (typically MediaType.APPLICATION_JSON or MediaType.APPLICATION_XML)
*/  
  <T> T doRestGet(String restUrl, Class<T> resClz, String resType){

        T obj;
        Client client = ClientBuilder.newClient();            

        WebTarget target = client.target(UriBuilder.fromUri("http://localhost:8088/Your_WS_root").build()); 

        try{

         obj =(T) target.path(restUrl).request()
              .accept(resType).get().readEntity(resClz);


        }catch(Exception e){
         System.out.println(e);//log or propagate the exception

        return null;
        }
        return obj;
}

您的服务器方法可能类似于

@GET
  @Path("/userMsg")
  @Produces(MediaType.APPLICATION_JSON)
  public UserMessage getUsersOne() {

   UserMessage uMsg = new UserMessage();
   uMsg.setUserMsg("successful call");
   return uMsg;
  }

现在你会调用你的服务

UserMessage uMsg = (UserMessage)doRestGet("userMsg", UserMessage.class, MediaType.APPLICATION_JSON );