messaging24 / flight-booking-1

Spring Boot Web Application that demonstrates Rest Endpoints, Spring Data JPA and Java 8 features.

Flight Booking API Application

SpringBoot Application that demonstrates REST API Development using Spring MVC, Spring Data JPA using Java 8 features

Features

This application has two primary REST end-points that provide flight-booking information.

1. GET /bookings?uid={passenger-id}
2. GET /bookings/{booking-id}

Besides these two primary end-points, there are few other end-points to support the consumer apps(mobile/web). They are:

1. GET /airports
2. GET /airports/{iata-code}
3. GET /flights
4. GET /flights/{flight-id}
5. GET /passengers
6. GET /passengers/{passenger-id}

To test these end-points, see the API documentation section here

Technologies used

1. Java (Programming Language)
2. Spring Boot (Application Platform)
3. Spring Data JPA (Data persistence)
4. H2 (Database)
5. JUnit, with Spring Testing (Unit & Integration Testing)

Getting Started

The source code can be checked out to your local and then build and run the application either from your IDE after importing to it as a maven project, or just from a command line. Follow these steps for the command-line option:

Prerequisites

1. Java 8
2. Maven 3
3. Git

Installing & Running

Clone this repo into your local:

git clone https://[email protected]/sameerean/flight-booking.git

Build using maven

mvn clean install

Start the app

mvn spring-boot:run

Access the Home screen

The application will be available at the URL: Home.

The home screen will give you relevant links to navigate, including the API end-points.

Test the URLs

1. [http://localhost:8080/bookings?uid=PS-10](http://localhost:8080/bookings?uid=PS-10)
2. [http://localhost:8080/bookings/FB-10](http://localhost:8080/bookings/FB-10)

API Documentation and Integration Testing

API documentation can be accessed via Swagger UI

Running the Test Cases

There is just one test case for this project as of now: BookingTest.java

You can run it either from:

• Command line

mvn test

• Your IDE

  Right click on this file and "Run As JUnit Testcase"

Database

This application is using H2 in-memory database, which (database as well as data) will be removed from memory when the application goes down.

While the application is running, you can access the H2 Console if you want to see the data outside the application.

You can connect to the DB using the JDBC URL: 'jdbc:h2:mem:flight-booking' and user 'sa' with NO password.

Data pre-loading

Sample data is pre-loaded from the demonstration purpose by DataLoader.java. In a production-grade application, this will be done through a database upgrade script/task.