Esquema del servidor de reservas (REST) para Java

Puedes clonar el repositorio para descargar nuestro servidor REST de esqueleto.

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

Introducción

Esta es una implementación de referencia para el servidor de reservas de la API de v3 basada en lo siguiente:

• google-protobuf
• Servicios web RESTful de Jersey

Requisitos previos

Requiere instalaciones de

• Apache Maven
• Compilador de protocolos para Java
• Apache Tomcat

Comenzar

1. Copia la interfaz de Proto en un archivo proto (api_v3.proto). Modifica el paquete para que coincida con tu proyecto (com.partner.mapsbooking.v3.model).
   • Si implementas la funcionalidad de lista de espera, repite los mismos pasos con la interfaz de protocolo de lista de espera.
2. Crea un proyecto de aplicación web en tu IDE llamado booking_server_v3 y agrega compatibilidad con Maven a este proyecto.
3. Coloca tu archivo proto en src/main/resources y agrega las dependencias de Jersey y el entorno de ejecución de los búferes de protocolo al archivo pom.xml de Maven:

        <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. Ejecuta el siguiente comando en src/main para generar automáticamente un archivo fuente para las clases definidas en el archivo proto:

   protoc --java_out=java resources/api_v3.proto

   • Si implementas la funcionalidad de lista de espera, también ejecuta lo siguiente: protoc --java_out=java resources/waitlist.proto

5. Dentro de src/main/java, crea un paquete nuevo que coincida con tu groupId (com.partner.mapsbooking). Recupera el código de muestra del repositorio:

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

   coloca los archivos en tu paquete, sigue las tareas pendientes para completar tu implementación.

6. Para configurar tu servlet, modifica el archivo 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. En Run Configurations, configura un servidor Tomcat. Agrega todos los archivos JAR al directorio /WEB_INF/lib (estructura del proyecto -> artefactos -> después de seleccionar todos los archivos JAR, haz clic con el botón derecho y elige "Put into /WEB-INF/lib").
8. Ejecuta Tomcat para iniciar el servidor.

Estructura de directorios 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