服务器端 Endpoints API 定义必须符合许多语法规则。Android Studio 了解这些规则,并会在您键入代码时进行验证,以帮您避免犯错。Android Studio 提供特定于端点的检查和快速修复。
在输入时即刻进行代码验证
例如,默认后端类型“App Engine Java 端点模块”包含以下最小注释 Endpoints API,它们位于 <backend-name>/src/main/java/<package-name>/MyEndpoint.java
下的项目中:
import javax.inject.Named;
@Api(name = "myApi", version = "v1",
namespace = @ApiNamespace(ownerDomain = "<package-name>",
ownerName = "<package-name>",
packagePath=""))
public class MyEndpoint {
@ApiMethod(name = "sayHi")
public MyBean sayHi(@Named("name") String name) {
MyBean response = new MyBean();
response.setData("Hi, " + name);
return response;
}
}
在代码中,对于传递给服务器端方法的所有非实体类型参数,都必须使用 @Named
。如果您在此代码中修改 sayHi
时忘记添加此注释,Android Studio 将在您键入时为有问题的语句加下划线,如下所示:
快速修复
为了帮您避免一些较常见的 Cloud Endpoints 开发错误,Android Studio 提供了快速修复功能。要查看这些快速修复建议,如果您在 Linux/Windows 上运行,请按 Alt + Enter,如果您在 Mac 上运行,请按 ⌥ + Enter。例如,此处的 Android Studio 显示了针对上面代码示例中显示的缺少 @Named
注释的快速修复:
与预期相同,选择第一个快速修复 (Add @Named
) 会将 @Named
添加到 method 参数。