Project

General

Profile

1. Introduction

JTheque est un projet en Java composé de plusieurs sous-projets :

  • JTheque Utilities : Plusieurs utilitaires facilitant la création d'applications Java en particulier des applications modulaires.
  • JTheque Collections : Plusieurs applications permettant de gérer des films, livres et vidéos.
  • JTheque Metrics : Une application pour générer des métriques pour un projet Java.

2. Méthodologie de développement

Ce projet est entièrement développé en utilisant Intellij Idea 9.0.

Les sources du projet sont toutes inclues dans Subversion.

Le build est réalisé au moyen de Maven 2, en utilisant Artifactory comme proxy d'entreprise. Hudson est utilisé comme serveur d'intégration continue. En fin de chaîne, on retrouve Sonar pour suivre la qualité logicielle des différentes projets.

Les tests unitaires sont gérés avec JUnit 4.

Le framework Spring est grandement utilisé.

Plus d'informations sur les Outils utilisés.

3. Nomenclature

Tous les sous-projets de JTheque se nomment JTheque XXX.

4. Règles de codage

Voici les règles de codage qui sont suivies (depuis JTheque Core 2.0) dans le projet JTheque :

  • Fonctions les plus courtes possibles
  • Éviter les switchs
  • Extraire les blocs try/catch à un haut niveau
  • Éviter les commentaires répétitifs par rapport au code
  • Ne pas mélanger les objets de données et les objets métiers
  • Préférer des setters métiers que des setters de propriété
  • Englober les exceptions de bas niveau
  • Mettre des messages explicites dans les exceptions pour s'y retrouver facilement
  • Éviter de retourner null, préférer une exception ou un objet spécial
  • Éviter de passer null à une fonction
  • Tester avant de coder
  • Un concept par test
  • Un minimum d'assertions par test

5. Procédure de publication

La prodécure de publication d'une nouvelle version est décrite ici.

6. Développeurs

JTheque est actuellement développé par une seule personne, Baptiste Wicht.