TheRideBackEnd

This project was completely written with Java (Spring MVC).

Development server

Run the project in development mode on JetBrains Intellij IDEA or your Preferred IDE and Navigate to http://localhost:8080/. The application will automatically reload if you change any of the source files. It is advisable to have the back-end running first before the front end. RabbitMQ uses port 5672 on localhost and websocket endpoint is http://localhost:8080/ws .I strongly advise you leave this port open and have TCP enabled on your local machine or development server.

RabbitMQ Integration

Ensure Erlang and RabbitMQ are both installed on your development machine and the installation is done with the administrator account to avoid complexities, by convention Erlang is installed before RabbitMQ. You can find the solution to a common issue when configuring RabbitMQ here. This is an issue I encountered and successfully handled.

Testing

It is important to note that H2 databases do not support UUID primary key persistence,if your preference is to configure an internal memory for unit testing. MSSQL was utilised for testing for this reason.

• Unit Tests

  Unit Tests were configured using the inbuilt @SpringBootTest also ensure you use @TestInstance(TestInstance.Lifecycle.PER_CLASS) to handle test class instances more efficiently. Mocking was utilised for full isolation of the repository class. The test below simply checks if the IsOnlyMySexAllowed in the Customer class is correctly populated. See the unit test here

• Integration Tests

  The MockMvc library ws used for mocking REST verbs ('GET','POST','PUT' etc.) for integration tests. These tests have been completely isolated from the main classes (in this case the class Test_Customers was used) but a real database was utilised. The integration tests check the HTTPPOST HTTPPUT methods at a controller level. See the integration tests here

  Ensure dependencies for integration test are singleton where possible (meaning one instance per Spring IoC container).For performance, consistency and simplicity.

Entity Relationship Diagram

Below is a diagram showing the relationship between entities.

See:

https://docs.spring.io/spring-framework/reference/core/beans/factory-scopes.html