Endpoints Framework Maven 플러그인은 Endpoints Framework 프로젝트를 빌드하기 위한 작업 및 구성을 제공합니다. 이 플러그인은 서버 측 및 클라이언트 측 지원을 제공합니다. 서버 측 목표는 주석 처리된 Endpoints Framework 자바 프로젝트 및 클라이언트 라이브러리에서 검색 문서 및 OpenAPI 사양을 생성합니다. 클라이언트 측 목표는 검색 문서를 사용할 수 있을 때 클라이언트 라이브러리를 생성합니다.
Endpoints Framework Maven 플러그인 추가
다음 플러그인 스니펫을 사용하여 pom.xml
에 Endpoints Framework Maven 플러그인을 추가합니다.
플러그인 목표
Endpoints Framework Maven 플러그인을 추가한 후 다음 Endpoints Framework 관련 Maven 목표를 사용할 수 있습니다.
서버 측
목표 | 설명 |
---|---|
endpoints-framework:clientLibs |
클라이언트 라이브러리를 생성합니다. |
endpoints-framework:discoveryDocs |
검색 문서를 생성합니다. |
endpoints-framework:openApiDocs |
OpenAPI 문서를 생성합니다. |
클라이언트 측
목표 | 설명 |
---|---|
endpoints-framework:generateSrc |
검색 문서에서 클라이언트 라이브러리를 생성합니다. |
목표 매개변수
각 목표에는 사용할 수 있는 연결된 매개변수가 있습니다. pom.xml
또는 명령줄에서 이러한 설정을 지정할 수 있습니다.
pom.xml
에서 이러한 설정을 구성하려면 <configuration>
섹션에 매개변수 이름을 추가합니다.
또는 패턴 -D[USER_PROPERTY]=[PARAMETER_VALUE]
에 따라 명령줄에서 이러한 설정을 구성할 수 있습니다.
각 목표에서 사용할 수 있는 매개변수 목록은 다음 섹션을 참조하세요.
endpoints-framework:clientLibs
이 목표는 서버측에서 클라이언트 라이브러리를 생성합니다.
매개변수 | 설명 | 사용자 속성 |
---|---|---|
clientLibDir |
생성된 클라이언트 라이브러리의 위치를 정의합니다. 기본 위치는 `target/client-libs`로 정의됩니다. | endpoints.clientLibDir |
serviceClasses |
서비스 클래스(Endpoints 클래스)의 이름 목록을 제공하기 위한 선택적인 매개변수입니다. `web.xml`에서 추론할 수 있습니다. | endpoints.serviceClasses |
webappDir |
`webapp` 디렉토리의 위치를 제공합니다. 기본 위치는 `src/main/webapp`으로 정의됩니다. | endpoints.webappDir |
hostname |
클라이언트 라이브러리의 루트 URL을 설정합니다. 예를 들어 `hostname = myapp.appspot.com`을 사용하면 기본 루트 URL이 `https://myapp.appspot.com/_ah/api`가 됩니다. | endpoints.hostname |
endpoints-framework:discoveryDocs
이 목표는 검색 문서를 생성합니다.
매개변수 | 설명 | 사용자 속성 |
---|---|---|
discoveryDocDir |
생성된 검색 문서의 위치를 정의합니다. 기본 위치는 `target/discovery-docs`로 정의됩니다. | endpoints.discoveryDocDir |
serviceClasses |
서비스 클래스(Endpoints 클래스)의 이름 목록을 제공하기 위한 선택적인 매개변수입니다. `web.xml`에서 추론할 수 있습니다. | endpoints.serviceClasses |
webappDir |
`webapp` 디렉토리의 위치를 제공합니다. 기본 위치는 `src/main/webapp`으로 정의됩니다. | endpoints.webappDir |
hostname |
검색 문서의 루트 URL을 설정합니다. 예를 들어 `hostname = myapp.appspot.com`을 사용하면 기본 루트 URL이 `https://myapp.appspot.com/_ah/api`가 됩니다. | endpoints.hostname |
endpoints-framework:openApiDocs
이 목표는 OpenAPI 문서를 생성합니다.
매개변수 | 설명 | 사용자 속성 |
---|---|---|
openApiDocDir |
생성된 OpenAPI 문서의 위치를 정의합니다. 기본 위치는 `target/openapi-docs`로 정의됩니다. | endpoints.openApiDocDir |
serviceClasses |
서비스 클래스(Endpoints 클래스)의 이름 목록을 제공하기 위한 선택적인 매개변수입니다. `web.xml`에서 추론할 수 있습니다. | endpoints.serviceClasses |
webappDir |
`webapp` 디렉토리의 위치를 제공합니다. 기본 위치는 `src/main/webapp`으로 정의됩니다. | endpoints.webappDir |
hostname |
OpenAPI 문서의 루트 URL을 설정합니다. 예를 들어 `hostname = myapp.appspot.com`을 사용하면 기본 루트 URL이 `https://myapp.appspot.com/_ah/api`가 됩니다. | endpoints.hostname |
endpoints-framework:generateSrc
이 목표는 검색 문서에서 클라이언트 소스를 생성합니다.
매개변수 | 설명 | 사용자 속성 |
---|---|---|
discoveryDocs |
검색 문서 목록을 정의합니다. | endpoints.discoveryDocs |
generatedSrcDir |
생성된 클라이언트 라이브러리 소스의 출력 디렉토리입니다. 기본 위치는 `target/generated-sources/`에 있습니다. | endpoints.generatedSrcDir |
다음 단계
- GitHub에서 플러그인 코드를 살펴보고 문제를 보고합니다.