Utilizzo di Guice con Cloud Endpoints Frameworks

Google Guice è un framework di inserimento di dipendenze che puoi utilizzare con un progetto Endpoint Frameworks v2 per configurare la mappatura e i filtri dei servlet in modo programmatico in Java, anziché in web.xml.

Per utilizzare Guice, devi aggiungere la seguente dipendenza preconfezionata a pom.xml o build.gradle. Inoltre, devi configurare i plug-in Endpoint Frameworks per Maven e Gradle per definire le classi di servizio utilizzate dai plug-in per creare documenti OpenAPI.

Maven

appengine-java8/endpoints-v2-guice/pom.xml 
<dependency>
  <groupId>com.google.endpoints</groupId>
  <artifactId>endpoints-framework-guice</artifactId>
  <version>2.2.2</version>
</dependency>

Gradle

appengine-java8/endpoints-v2-guice/build.gradle 
compile 'com.google.endpoints:endpoints-framework-guice:2.2.2'
endpointsServer {
  // Endpoints Framework Plugin server-side configuration
  hostname = "${projectId}.appspot.com"
  serviceClasses = ['com.example.echo.Echo']
}

Il passaggio successivo consiste nell'aggiornare web.xml per indirizzare tutto il traffico da /_ah/api/* al server Servi dell'endpoint.

appengine-java8/endpoints-v2-guice/src/main/webapp/WEB-INF/web.xml 
<filter>
    <filter-name>guiceFilter</filter-name>
    <filter-class>com.google.inject.servlet.GuiceFilter</filter-class>
</filter>

<!--
  URL Pattern /_ah/api/* instead of /* because a legacy v1 servlet uses
  the route /_ah/api/ and using /* will erronously use the legacy v1
  servlet instead of routing to your API.
-->
<filter-mapping>
    <filter-name>guiceFilter</filter-name>
    <url-pattern>/_ah/api/*</url-pattern>
</filter-mapping>

<listener>
    <listener-class>com.example.echo.EchoGuiceListener</listener-class>
</listener>

Implementa la classe listener nel progetto. Dovrebbe essere simile al seguente, a seconda del numero di servizi:

appengine-java8/endpoints-v2-guice/src/main/java/com/example/echo/EchoGuiceListener.java 
public class EchoGuiceListener extends GuiceServletContextListener {

  @Override
  protected Injector getInjector() {
    return Guice.createInjector(new EchoEndpointModule());
  }
}

La classe listener crea un nuovo iniettore che gestisce la mappatura e il filtro dei servlet, che normalmente viene definito da web.xml, ma ora viene definito dalla classe EchoEndpointModule definita come:

appengine-java8/endpoints-v2-guice/src/main/java/com/example/echo/EchoEndpointModule.java 
public class EchoEndpointModule extends EndpointsModule {
  @Override
  public void configureServlets() {
    super.configureServlets();

    bind(ServiceManagementConfigFilter.class).in(Singleton.class);
    filter("/_ah/api/*").through(ServiceManagementConfigFilter.class);

    Map<String, String> apiController = new HashMap<String, String>();
    apiController.put("endpoints.projectId", "YOUR-PROJECT-ID");
    apiController.put("endpoints.serviceName", "YOUR-PROJECT-ID.appspot.com");

    bind(GoogleAppEngineControlFilter.class).in(Singleton.class);
    filter("/_ah/api/*").through(GoogleAppEngineControlFilter.class, apiController);

    bind(Echo.class).toInstance(new Echo());
    configureEndpoints("/_ah/api/*", ImmutableList.of(Echo.class));
  }
}

Passaggi successivi