AWS Serverless Cloud Native Java RESTful API

Develop an API following the best practices in the set of principles of REST (State Representation Transfer) architecture.

The travel entity must contain the attributes: Country, City, Date (YYYY / MM / DD) and Reason.

o Create a new trip record:

• HTTP return code 201

o Get trips by period:

• Via query / travel parameter? Start = X and end = Y
• Return 200 containing the results in a list.
• Even when nothing is found, return an empty list and HTTP code 200.
• Returns all fields of the entity in the body.

o get trips by country:

• Via parameter, inform the country / trips /
• Return only one trip from the country.
• HTTP Code 200 case found, body not found empty and HTTP Code 404.

enjoy city trips:

• Via Consulta inform the city and via Path parameter inform the country / trips / /? city ​​=
• The city search for being of type contains (like - LSI Sort Indexing key)
• Return only one trip from the country.
• HTTP Code 200 case found, body not found empty and HTTP Code 404.

• No API source code should contain a README file with instructions for running an API locally and also on AWS.

Requirements

• AWS CLI already configured with at least PowerUser permission
• Java SE Development Kit 8 installed
• Docker installed
• Maven
• SAM CLI
• Python 3

Setup process

Installing dependencies

We use maven to install our dependencies and package our application into a JAR file:

mvn install

Local development

Invoking function locally through local API Gateway

1. Update AWS credentials vi .aws/credentials

2. Start DynamoDB Local in a Docker container. docker run -p 8000:8000 -v $(pwd)/local/dynamodb:/data/ amazon/dynamodb-local -jar DynamoDBLocal.jar -sharedDb -dbPath /data

3. • Use this command to list the table

        aws dynamodb list-tables --endpoint-url http://localhost:8000
     

4. Create the DynamoDB table.

   Documentation: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html

   Execute this commands in the main folder:

     aws dynamodb create-table --cli-input-json file://dbDynamo.json --endpoint-url http://localhost:8000
   

5. If You want to create the table using the (http://localhost:8000/shell/#)

   • past file dbDynamo.json and run

If the table already exist, you can delete: aws dynamodb delete-table --table-name study --endpoint-url http://localhost:8000

6. Start the SAM local API.

• On a Mac: sam local start-api --env-vars src/test/resources/test_environment_mac.json
• On Windows: sam local start-api --env-vars src/test/resources/test_environment_windows.json
• On Linux: sam local start-api --env-vars src/test/resources/test_environment_linux.json

OBS: If you already have the container locally (in your case the java8), then you can use --skip-pull-image to remove the download