java - API设计建议

Question

关闭。这个问题需要多问 focused 。目前不接受答案。

---

想要改进此问题吗？更新问题，使其仅关注一个问题 editing this post .

已关闭 4 年前。

Improve this question

我正在为服务器开发一个 API(库)(想象一个简单的服务器，它接收请求并在连接上写回响应)。

我有一种情况，我有 3 个不同的框架(第三方库)。所有这些都提供了一种处理请求的方法，但是以它们自己的方式。想象一下以下是每个库的接口(interface):

库A

public class AHandler implements AHandler {

  public Response handle(Request req){
   // ..
  }
}

库B

public class BHandler extends SomeHandler {

  public BResponse handle(BRequest req){
   // ..
  }
}

lib C

@Handler
public class BHandler {
  @HandlerMethod
  public void handle(CRequest req, CResponse res){
   // ..
  }
}

我想创建一个 API 来抽象 handle()方法转化为某种统一的方法。由于A、B和C是第三方的，我没有办法修改它们。

事实:

• 用户可以在每台服务器上拥有一个或多个此类处理程序；
• 我无法修改第三方库的源代码，也不想控制它们的版本。

为所有三个库提供统一接口(interface)的 API 设计的最佳方法是什么？

Answer 1

您可以结合使用外观和适配器来实现所需的结果。

// defines the uniform interface exposed to API clients
interface Facade {
    void handleRequest(Request request, Response response)
}

// defines the uniform interface each handler will have to expose
interface Adapter {
    void handleRequest(Request request, Response response)
}

// takes a concrete adapter as argument and delegates to it for the concrete handle logic implementation
class ConcreteFacade implements Facade{

    private Adapter adapter;

    public ConcreteFacade(Adapter adapter){
        this.adapter = adapter;
    }

    public void handleRequest(Request request, Response response){
        adaper.handleRequest(request, response);
    }

}

// one concrete adapter for each library
class ConcreteAdapter implements Adapter {

    private AHandler handler; 

    public ConcreteAdapter(AHandler handler){
        this.handler = handler;
    }

    public void handleRequest(Request request, Response response) {
        //delegate to handler
    }

}