Merge pull request #316 from GoogleCloudPlatform/endpoints-frameworks…

…-v2-management Updates Endpoints Frameworks v2 sample with service management.
GoogleCloudPlatform · Sep 1, 2016 · b466427 · b466427
2 parents bbc8d5c + 613fefb
commit b466427
Show file tree

Hide file tree

Showing 5 changed files with 99 additions and 12 deletions.
diff --git a/appengine/endpoints-frameworks-v2/backend/README.md b/appengine/endpoints-frameworks-v2/backend/README.md
@@ -27,16 +27,7 @@ To build the project:
 
 To generate the required configuration file `swagger.json`:
 
-0. Download and unzip the [Endpoints Framework tools
-package](http://search.maven.org/remotecontent?filepath=com/google/endpoints/endpoints-framework-tools/2.0.0-beta.7/endpoints-framework-tools-2.0.0-beta.7.zip).
-
-0. Invoke the Endpoints Tool using this command:
-
-         path/to/endpoints-framework-tools-2.0.0-beta.7/bin/endpoints-framework-tools get-swagger-doc \
-             -h <PROJECT_ID>.appspot.com \
-             -w target/echo-1.0-SNAPSHOT com.example.echo.Echo
-
-    Replace`<PROJECT_ID>` with your project ID.
+    mvn exec:java -DGetSwaggerDoc
 
 ## Deploying the sample API to App Engine
 

diff --git a/appengine/endpoints-frameworks-v2/backend/pom.xml b/appengine/endpoints-frameworks-v2/backend/pom.xml
@@ -31,6 +31,9 @@
     <properties>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 
+        <endpoints.framework.version>2.0.0-beta.7</endpoints.framework.version>
+        <endpoints.management.version>1.0.0-beta.7</endpoints.management.version>
+
         <endpoints.project.id>YOUR_PROJECT_ID</endpoints.project.id>
     </properties>
 
@@ -45,10 +48,62 @@
         <dependency>
             <groupId>com.google.endpoints</groupId>
             <artifactId>endpoints-framework</artifactId>
-            <version>2.0.0-beta.7</version>
+            <version>${endpoints.framework.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.google.endpoints</groupId>
+            <artifactId>endpoints-management-control-appengine</artifactId>
+            <version>${endpoints.management.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>com.google.endpoints</groupId>
+            <artifactId>endpoints-framework-auth</artifactId>
+            <version>${endpoints.management.version}</version>
         </dependency>
     </dependencies>
 
+    <profiles>
+        <profile>
+            <id>GetSwaggerDoc</id>
+            <activation>
+                <property>
+                    <name>GetSwaggerDoc</name>
+                </property>
+            </activation>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.codehaus.mojo</groupId>
+                        <artifactId>exec-maven-plugin</artifactId>
+                        <version>1.4.0</version>
+                        <configuration>
+                            <includePluginDependencies>true</includePluginDependencies>
+                            <mainClass>com.google.api.server.spi.tools.EndpointsTool</mainClass>
+                            <arguments>
+                                <argument>get-swagger-doc</argument>
+                                <argument>--hostname=${endpoints.project.id}.appspot.com</argument>
+                                <argument>--war=target/echo-1.0-SNAPSHOT</argument>
+                                <argument>com.example.echo.Echo</argument>
+                            </arguments>
+                        </configuration>
+                        <dependencies>
+                            <dependency>
+                                <groupId>com.google.endpoints</groupId>
+                                <artifactId>endpoints-framework-tools</artifactId>
+                                <version>${endpoints.framework.version}</version>
+                            </dependency>
+                            <dependency>
+                                <groupId>com.google.appengine</groupId>
+                                <artifactId>appengine-api-1.0-sdk</artifactId>
+                                <version>1.9.30</version>
+                            </dependency>
+                        </dependencies>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+
     <build>
         <!-- for hot reload of the web application-->
         <outputDirectory>${project.build.directory}/${project.build.finalName}/WEB-INF/classes</outputDirectory>

diff --git a/appengine/endpoints-frameworks-v2/backend/src/main/java/com/example/echo/Echo.java b/appengine/endpoints-frameworks-v2/backend/src/main/java/com/example/echo/Echo.java
@@ -16,10 +16,12 @@
 
 package com.example.echo;
 
+import com.google.api.server.spi.auth.EspAuthenticator;
 import com.google.api.server.spi.auth.common.User;
 import com.google.api.server.spi.config.Api;
 import com.google.api.server.spi.config.ApiMethod;
 import com.google.api.server.spi.config.ApiNamespace;
+import com.google.api.server.spi.config.AuthLevel;
 
 /** The Echo API which Endpoints will be exposing. */
 @Api(
@@ -57,7 +59,12 @@ public Message echo(Message message) {
    * Note that httpMethod is not required here. Without httpMethod, this will default to GET due
    * to the API method name. httpMethod is added here for example purposes.
    */
-  @ApiMethod(httpMethod = ApiMethod.HttpMethod.GET)
+  @ApiMethod(
+      httpMethod = ApiMethod.HttpMethod.GET,
+      authenticators = {EspAuthenticator.class},
+      audiences = {"YOUR_OAUTH_CLIENT_ID"},
+      authLevel = AuthLevel.REQUIRED
+      )
   public Email getUserEmail(User user) throws UnauthorizedException {
     if (user == null) {
       throw new UnauthorizedException();

diff --git a/appengine/endpoints-frameworks-v2/backend/src/main/webapp/WEB-INF/appengine-web.xml b/appengine/endpoints-frameworks-v2/backend/src/main/webapp/WEB-INF/appengine-web.xml
@@ -26,4 +26,8 @@
     <system-properties>
         <property name="java.util.logging.config.file" value="WEB-INF/logging.properties"/>
     </system-properties>
+
+   <env-variables>
+        <env-var name="ENDPOINTS_SERVICE_NAME" value="${endpoints.project.id}.appspot.com" />
+    </env-variables>
 </appengine-web-app>
diff --git a/appengine/endpoints-frameworks-v2/backend/src/main/webapp/WEB-INF/web.xml b/appengine/endpoints-frameworks-v2/backend/src/main/webapp/WEB-INF/web.xml
@@ -32,4 +32,34 @@
     <welcome-file-list>
         <welcome-file>index.html</welcome-file>
     </welcome-file-list>
+
+    <!-- Add a filter that fetches the service config from service management. -->
+    <filter>
+        <filter-name>endpoints-api-configuration</filter-name>
+        <filter-class>com.google.api.control.ServiceManagementConfigFilter</filter-class>
+    </filter>
+
+    <!-- Add a filter that performs Endpoints logging and monitoring. -->
+    <filter>
+        <filter-name>endpoints-api-controller</filter-name>
+        <filter-class>com.google.api.control.extensions.appengine.GoogleAppEngineControlFilter</filter-class>
+        <init-param>
+            <param-name>endpoints.projectId</param-name>
+            <param-value>${endpoints.project.id}</param-value>
+        </init-param>
+        <init-param>
+            <param-name>endpoints.serviceName</param-name>
+            <param-value>${endpoints.project.id}.appspot.com</param-value>
+        </init-param>
+    </filter>
+
+    <filter-mapping>
+        <filter-name>endpoints-api-configuration</filter-name>
+        <servlet-name>EndpointsServlet</servlet-name>
+    </filter-mapping>
+
+    <filter-mapping>
+        <filter-name>endpoints-api-controller</filter-name>
+        <servlet-name>EndpointsServlet</servlet-name>
+    </filter-mapping>
 </web-app>