如何使用注解在Java的Google端点中定义不同的版本以及如何调用它们?从理论上讲,我知道我需要使用@Api创建不同的类,然后定义元素版本。
@Api(name = "myApi",
version = "v1",
public class YourFirstAPI {
/** A simple endpoint method that takes a name and says Hi back */
@ApiMethod(name = "sayHi")
public MyBean sayHi(@Named("name") String name) {
MyBean response = new MyBean();
response.setData("Hi, " + name);
return response;
}
}
@Api(name = "myApi2",
version = "v2",
public class YourFirstAPI2 {
/** A simple endpoint method that takes a name and says Hi back */
@ApiMethod(name = "sayHi")
public MyBean sayHi(@Named("name") String name) {
MyBean response = new MyBean();
response.setData("Hi, " + name);
return response;
}
}
是这样定义API的好方法还是有更好的方法呢?
当我想使用v1或v2时,我必须通过调用API的特定名称来做到这一点?
最佳答案
您可以随意继续使用相同的名称命名API,而只需更改版本名称即可。那就是版本名的美:)
根据客户端调用API的方式,无论客户端基于的是Java runtime,javascript library in the browser,building an object to interact with the API,还是构造URL并使用HTTP以直接RESTful方式调用API,指定要访问的API版本将在相关文档中进行说明。