Esqueleto do servidor de agendamento (REST) para Java

Você pode baixar nosso esqueleto do servidor REST clonando o repositório

git clone https://maps-booking.googlesource.com/java-maps-booking-rest-server-v3-skeleton

Introdução

Esta é uma implementação de referência para o servidor de agendamento da API v3 com base em:

• google-protobuf
• Serviços da Web RESTful de Jersey

Pré-requisitos

Exigir a instalação de

• Apache Maven (em inglês)
• Compilador de protocolo para Java
• Apache Tomcat

Começar

1. Copie a Interface Proto em um arquivo proto (api_v3.proto). Modificar o pacote que corresponde ao seu projeto (com.partner.mapsbooking.v3.model).
   • Se estiver implementando a funcionalidade de lista de espera, repita as mesmas etapas com as Interface Proto da lista de espera
2. Crie um projeto de aplicativo da Web em seu ambiente de desenvolvimento integrado chamado booking_server_v3, adicione Suporte do Maven para este projeto.
3. Coloque o arquivo .proto na pasta src/main/resources, e adicione dependências do ambiente de execução dos buffers de protocolo e Jersey para o Maven arquivo pom.xml:

        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.glassfish.jersey</groupId>
                    <artifactId>jersey-bom</artifactId>
                    <version>${jersey.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
   
        <dependencies>
            <dependency>
                <groupId>org.glassfish.jersey.containers</groupId>
                <artifactId>jersey-container-servlet-core</artifactId>
            </dependency>
            <dependency>
                <groupId>org.glassfish.jersey.media</groupId>
                <artifactId>jersey-media-json-jackson</artifactId>
                <version>2.27</version>
            </dependency>
            <dependency>
                <groupId>com.google.protobuf</groupId>
                <artifactId>protobuf-java</artifactId>
                <version>3.5.1</version>
            </dependency>
            <dependency>
                <groupId>io.grpc</groupId>
                <artifactId>grpc-protobuf</artifactId>
                <version>1.11.0</version>
            </dependency>
        </dependencies>
   
        <properties>
            <java.version>1.8</java.version>
            <jersey.version>2.23.2</jersey.version>
        </properties>
   

4. Execute o seguinte comando em src/main para gerar automaticamente um arquivo de origem para as classes definidas no arquivo proto:

   protoc --java_out=java resources/api_v3.proto
   

   • Se você estiver implementando a funcionalidade da lista de espera, execute também o seguinte: protoc --java_out=java resources/waitlist.proto

5. Dentro de src/main/java, crie um novo pacote que corresponda às groupId (com.partner.mapsbooking). Recupere o exemplo de código do repositório:

    git clone https://maps-booking.googlesource.com/java-maps-booking-rest-server-v3-skeleton
   

   Coloque os arquivos no pacote, siga as TODOs para concluir sua implementação.

6. Configure o servlet modificando o arquivo web.xml:

   <?xml version="1.0" encoding="UTF-8"?>
   <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_4_0.xsd"
            version="4.0">
   
       <servlet>
           <servlet-name>Booking Rest Server</servlet-name>
           <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
           <init-param>
               <param-name>jersey.config.server.provider.packages</param-name>
               <param-value>com.partner.mapsbooking</param-value>
           </init-param>
           <load-on-startup>1</load-on-startup>
       </servlet>
   
       <servlet-mapping>
           <servlet-name>Booking Rest Server</servlet-name>
           <url-pattern>/mapsbooking/*</url-pattern>
       </servlet-mapping>
   </web-app>
   

7. Em "Run Configurations", defina uma configuração de servidor Tomcat. Adicionar todos os jars no diretório /WEB_INF/lib (estrutura do projeto -> artefatos -> Após selecionar todos os jars, clique com o botão direito do mouse e escolha "Put into /WEB-INF/lib".
8. Execute o Tomcat para iniciar o seu servidor.

Estrutura de diretórios final

  src
  |---main
      |---java
          |---com.partner.mapsbooking
              |---rest
                  |---BookingService.java
                  |---BookingExceptionMapper.java
                  |---Error.java
              |---authentication
                  |---AuthenticationService.java
                  |---RestAuthenticationFilter.java
              |---v3.model
                  |---ApiV3.java
                  |---Waitlist.java
      |---resources
          |---api_v3.proto
          |---waitlist.proto
  |---test