Las definiciones de la API de extremos del lado del servidor deben cumplir una serie de reglas sintácticas. Android Studio las integra y valida tu código mientras escribes para ayudarte a evitar cometer errores. Android Studio proporciona inspecciones específicas para extremos y correcciones rápidas.
Validación de código mientras escribes
Por ejemplo, el tipo de backend predeterminado Módulo de extremos de Java en App Engine contiene la siguiente API de extremos mínima anotada ubicada en tu proyecto en <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;
}
}
En el código, @Named
es obligatorio para todos los parámetros de tipo no-entidad que pasan a los métodos del lado del servidor. Si olvidas agregar esta anotación cuando modificas sayHi
en este código, Android Studio subrayará la declaración problemática mientras escribes, como se muestra a continuación:
Soluciones rápidas
Para ayudarte a evitar algunos de los errores de desarrollo más comunes de Cloud Endpoints, Android Studio ofrece correcciones rápidas. Para ver estas sugerencias de solución rápidas, presiona Alt + Intro si se ejecuta en Linux/Windows ⌥ + Intro si se ejecuta en una Mac. Por ejemplo, aquí Android Studio muestra una solución rápida para la anotación @Named
faltante que se muestra en la muestra de código anterior:
Como se esperaba, cuando eliges la primera solución rápida (Add @Named
) se agrega @Named
al parámetro del método.