端点后端的代码验证和快速修复

服务器端 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 参数。