필수 파일 및 구성

이 페이지에서는 App Engine용 Cloud Endpoints Frameworks 사용을 위해 API에 포함되어야 하는 파일을 설명합니다.

프로젝트에 최소한 다음 파일이 포함되어야 합니다.

파일 및 위치 설명
/src/main/java/<packagepath>/<your_api_class>.java 백엔드 API가 포함된 클래스 파일(또는 여러 클래스에서 API를 구현하는 경우 여러 파일)입니다.
/src/main/webapp/WEB-INF/appengine-web.xml App Engine 구성에 필요한 웹 앱 배포 설명자입니다.
/src/main/webapp/WEB-INF/web.xml URL을 서블릿과 기타 정보에 매핑하는 표준 자바 웹 앱 배포 설명자입니다.

다음 섹션에서 이러한 각 필수 파일의 콘텐츠를 설명합니다.

API 클래스 파일

클래스 파일(또는 멀티 클래스 API를 사용하는 경우 여러 파일)의 필수 및 선택적 콘텐츠는 Endpoint 주석 주제에서 자세히 설명합니다.

appengine-web.xml

appengine-web.xml 파일은 API가 배포되었을 때, App Engine 표준 환경 구성을 정의하기 위해 사용됩니다. 자세한 내용은 appengine-web.xml 참조를 확인하세요.

이 파일에 필요한 최소 콘텐츠는 다음과 같습니다.

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
    <runtime>java8</runtime>
    <threadsafe>true</threadsafe>

    <system-properties>
        <property name="java.util.logging.config.file" value="WEB-INF/logging.properties"/>
    </system-properties>
</appengine-web-app>

web.xml

web.xml 파일을 사용하여 들어오는 요청을 처리하여 App Engine에서 실행되는 백엔드 서비스로 전달하는 Endpoints 서블릿을 구성합니다. Endpoints 서블릿은 Cloud Endpoints에서 API를 관리하는 데 필요합니다.

이 파일에 필요한 최소 콘텐츠는 다음과 같습니다.

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <!-- Wrap the backend with Endpoints Frameworks v2. -->
    <servlet>
        <servlet-name>EndpointsServlet</servlet-name>
        <servlet-class>com.google.api.server.spi.EndpointsServlet</servlet-class>
        <init-param>
            <param-name>services</param-name>
            <param-value>com.example.skeleton.MyApi</param-value>
        </init-param>
    </servlet>
    <!-- Route API method requests to the backend. -->
    <servlet-mapping>
        <servlet-name>EndpointsServlet</servlet-name>
        <url-pattern>/_ah/api/*</url-pattern>
    </servlet-mapping>
</web-app>

web.xml에 대한 자세한 내용은 배포 설명자: web.xml를 확인하세요.