Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mborne/tp-graph-java
[ENSG] Projet de départ pour le TP de refactoring sur les graphes (version Java archivée)
https://github.com/mborne/tp-graph-java
dijsktra-shortest-path exercise java refactoring
Last synced: 15 days ago
JSON representation
[ENSG] Projet de départ pour le TP de refactoring sur les graphes (version Java archivée)
- Host: GitHub
- URL: https://github.com/mborne/tp-graph-java
- Owner: mborne
- License: mit
- Created: 2021-01-03T21:59:26.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-11-25T13:21:07.000Z (about 2 months ago)
- Last Synced: 2024-12-27T06:08:22.377Z (22 days ago)
- Topics: dijsktra-shortest-path, exercise, java, refactoring
- Language: Java
- Homepage: https://github.com/mborne/cours-patron-conception/blob/archive-java/src/annexe/tp-graph/index.md#tp---refactoring-de-traitement-de-graphe
- Size: 3.66 MB
- Stars: 0
- Watchers: 2
- Forks: 60
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tp-graph-java
## Description
Projet de départ pour le [TP - Refactoring de traitement de graphe (version JAVA)](https://mborne.github.io/cours-patron-conception/annexe/tp-graph-java/index.html) associé au cours sur [les patrons de conception et principes de refactoring](https://mborne.github.io/cours-patron-conception/).
## Principes
* La branche par défaut ("main") permet de récupérer un projet maven pour commencer à travailler
* Les branches 0.1, 0.2, etc. correspondront aux corrections pour chaque question du TP
* junit et mockito sont utilisés pour les tests unitaires et fonctionnels
## Organisation du code
La classe [Application](src/main/java/org/acme/graph/Application.java) est le point d'entrée de l'application. La méthode `main` assure le démarrage de l'API implémentée à l'aide de [spring-boot](https://spring.io/guides/gs/spring-boot/).
Le code de l'API est organisé en package dans `src/` :
* `model` : Modélisation des données de l'application
* ̀`io` : Lecture de graphes
* `routing` : Implémentation de l'algorithme de calcul de plus court chemin
* `controllers` : Contrôleurs de l'application spring
* `config` : Configuration de l'application spring (initialisation des beans)
* `errors` : Gestion des erreurs (exceptions personnalisées)
## Utilisation
### Avec eclipse
* Lancer l'application "Application.java".
* Ouvrir http://localhost:8080/api/route?origin=1&destination=9557 dans un navigateur
* Ouvrir http://localhost:8080/ pour un démonstrateur
### En ligne de commande
* Construire le jar : `mvn clean package`
```bash
mvn clean package
```
* Démarrer l'API : `mvn spring-boot:run`
* Tester l'API : `curl "http://localhost:8080/api/route?origin=1&destination=9557"`
* Ouvrir le démonstrateur : `http://localhost:8080`
## Données utilisées
Un extrait de [ROUTE500](https://files.opendatarchives.fr/professionnels.ign.fr/route500/) est présent dans `src/main/resources/route500/idf/troncon_route.shp` à des fins de tests. Il est intégré dans le jar et est chargé par défaut.
Il est possible de charger un autre fichier à l'aide de l'option `graph.path` :
```bash
java -Dgraph.path=path/to/troncon_route.shp -jar target/tp-refactoring-graph-0.1.0-SNAPSHOT.jar
```
## Démonstrateur
Pour adapter le code démonstrateur (**dernière question**), le code correspondant est dans le dossier `front/`. En cas de changement dans ce dossier, il convient de reconstruire `src/main/resources/public` qui est servi par spring à l'aide des commandes suivantes :
```bash
# installation des dépendances
npm install
# construction du front
npm run build
```
Remarques :
* [NodeJS](https://nodejs.org/en) doit être installé en amont de l'exécution de ces commandes.
* Voir [package.json](package.json) et [vite.config.js](vite.config.js) (adapté à partir de [OpenLayers + Vite](https://github.com/openlayers/ol-vite?tab=readme-ov-file#openlayers--vite))
## Notes
* Log en mode debug : `-Dlogging.level.org.acme.graph=DEBUG`.
* Génération de rapport de couverture : `mvn clean package jacoco:report` (voir target/site/jacoco/index.html)
* [VisualVM](https://visualvm.github.io/) pourra vous aider pour les optimisations.
## Licence
[MIT](LICENSE)