Skeleton del servidor de reservas (REST) para Java

Puedes descargar nuestra el esqueleto del servidor REST clonando el repo

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 versión 3 de la API que se basa en lo siguiente:

• google-protobuf
• Servicios web RESTful de Jersey

Requisitos previos

Requiere la instalación de

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

Comenzar

1. Copia la interfaz de Proto en un archivo proto (api_v3.proto). Modificar 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 el Interfaz de protocolo de lista de espera
2. Crea un proyecto de aplicación web en tu IDE llamado booking_server_v3, agrega La asistencia de Maven para este proyecto.
3. Coloca el archivo proto en src/main/resources,,agrega para el tiempo de ejecución de los búferes de protocolo y Jersey 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. 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 repo:

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

   coloca los archivos debajo de tu paquete, sigue las TODO para completar para tu implementación.

6. Para configurar el 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, establece una configuración del servidor de Tomcat. Agregar todas los jars al directorio /WEB_INF/lib (estructura del proyecto -> artifacts -> Después de seleccionar todos los archivos jar con el botón derecho, haz clic y elige "Put into /WEB-INF/lib").
8. Ejecuta Tomcat para iniciar tu servidor.

Estructura final del directorio

  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