為REST API構建Java SDK的最佳實踐

Question

我即將針對REST API開發Java SDK，並想知道構建它的最佳實踐方法是什么。 我看過谷歌，並且還使用了許多連接到REST API的SDK，而且沒有太多的一致性。 我遇到過一些我感興趣並且想知道哪種模式可以被認為是最佳實踐的模式，如果有的話，或者是否有替代方案？

我提供了樣本/偽代碼以方便。

1）模型/請求/客戶端都是分開的。 示例電話：

Client client = new Client( ... credentials ... );

try {
    Something obj = client.post( new PostSomethingRequest( ..params... ) );
} catch( Exception oops ) { ...handle... }

try {
    Something obj2 = client.get( new GetSomethingRequest( id ) );
} catch( Exception oops ) { ...handle... }

2）模型和請求捆綁在一起，客戶端是分開的。 示例電話：

Client client = new Client( ... credentials ... );

try {
    Something obj = client.post( new Something( ..params... ) );
} catch( Exception oops ) { ...handle... }

try {
    Something obj2 = client.get( new Something( id ) );
} catch( Exception oops ) { ...handle... }

3）模型包含一切。 示例電話：

Client.setCredentials( ... credentials ... );

Something obj = new Something( ..params... );
try {
    obj.post();
} catch( Exception oops ) { ...handle... }

try {
    Something obj2 = Something.get( id );
} catch( Exception oops ) { ...handle... }

如果有更好的方法來建立這個，我也很高興聽到他們。

Answer 1

如果你為一個特殊的REST api構建一個sdk，我會使用代表REST服務調用的方法名稱，並且不會如此通用。