Getting started with the microproject
Play with the microproject skeleton
Understand the structure of the vlibtour project
You have been provided with the initial version of the project.
For the moment the provided maven modules are the following:
- vlibtour-libraries: This module provides some libraries not available through maven.
- vlibtour-applications: This module provides client applications.
- vlibtour-tourist-application: This module allows to run the tourist application with proxies for the server parts of the system.
- vlibtour-tour-management-admin-client: This application provides an administration client to populate or withdraw the content of the database for the tours and the POIs. This client allows to test the JavaEE part of the project.
The vlibtour-microservices directory contains the maven modules of the microservices.
- vlibtour-bikestation: for getting information about bike availabilities (with REST).
- vlibtour-tour-management-system: for managing the tours (with JavaEE).
- vlibtour-lobby-room-system: for exchanging the position of the users (with RabbitMQ).
In the root directory you find also:
- The readme.md file: It explains the role of each maven modules and their dependencies.
- The pom.xml file: It provides the necessary maven description to automatize compilation, testing and execution.
Verify that integration tests are correct
A specific shell script is provided to check the integration tests of each part of the project, before running the demonstration. This script performs a call to the integration tests scripts of each microservice, and then of the client applications.
Run the initial version of the project
The idea is to use the following script to execute the microproject.
In this initial version, the script detects that nothing is implemented and shows exceptions. In the next steps of the microproject, you will implement the missing parts.
At the end of the project, you will use this script to
- Start the application server, initiate the database and deploy the tour management bean
- Start the rabbitmq server
- Start your lobby room server
- Start the visit emulation server
- Start the tourist client applications for Joe and for Avrel and display their movements on the map on screen
- And finally ... stop everything.
Read the readme.md!
Take time to read the different readme.md files present in the subdirectories.
These readme.md files provide you with explanations to guide you in the code.
We recommend to use the following command to get the list of these files:
Implement the missing parts
You have to complete the code of the client applications and of the microservices.
We recommend to use the following commands to identify the files to be modified: