Ajouter une méthode à une entité

Dans ArgoUML, vous pouvez ajouter une méthode sur une entité. Pour cela, ajouter la méthode dans le modèle, sur l'entité elle-même. Si besoin, il faudra ajouter au modèle les types des paramètres ou de la valeur de retour.

ToPIA utilise le patron de conception Generation Gap pour séparer le code généré du code écrit par le développeur. Ainsi, le ré-génération n'écrase que du code généré et jamais du code utilisateur. Vous ne devez jamais modifier les classe générées mais seulement toucher aux implémentations qui héritent de ces classes.

Vous remarquerez que ToPIA a bien ajouté la méthode dans l'interface de l'entité mais à laisser l'implémentation abstraite. C'est donc à vous d'écrire le code dans le Impl.

Forcer le chargement d'une association

Utiliser une clé métier pour identifier les entité (naturalId)

Chaque entité possède une cré primaire topiaId, mais dans certains cas il est important d'avoir une notion d'unicité sur une ou plusieurs propriétés d'une entité, ce qu'on appele une clé métier. Le comportement souhaité serait de préserver l'unicité sur ces propriétés ainsi que la création d'un index pour optimiser l'accès aux données.

Il est donc nécessaire de préciser cette notion au niveau du modèle, cela par le biais du tagValue (également propriété hibernate) naturalId

fr.ird.observe.entities.referentiel.ParametrageTaillePoidsFaune.class.tagvalue.naturalIdMutable=false
fr.ird.observe.entities.referentiel.ParametrageTaillePoidsFaune.attribute.sexe.tagvalue.naturalId=true
fr.ird.observe.entities.referentiel.ParametrageTaillePoidsFaune.attribute.ocean.tagvalue.naturalId=true
fr.ird.observe.entities.referentiel.ParametrageTaillePoidsFaune.attribute.ocean.tagvalue.notNull=false
fr.ird.observe.entities.referentiel.ParametrageTaillePoidsFaune.attribute.espece.tagvalue.naturalId=true

Ici, les propriétés "sexe", "ocean" et "espece" forment la clé métier de l'entité "ParametrageTaillePoidsFaune". Par défaut les propriétés d'une clé métier sont non null, mais il est possible de préciser dans certains cas qu'une propriété peut l'être (comme ici avec "ocean").

Le naturalId provoque trois résultats :

• création d'un index unique en base.
• vérification dans hibernate de l'intégrité de l'entité à la création : il est donc nécessaire de créer l'entité avec des valeurs pour les propriétés de la clé métier (méthode create sur le dao).
• impossibilité de modifier les valeurs de ces propriétés sur une entité existante ; à moins de le préciser dans la configuration via le tagValue "naturalIdMutable" placé à "true" (déconseillé).

Le DAO de l'entité se voit ajouté les méthodes suivantes :

• createByNaturalId : qui permet de crée l'entité avec tout les naturalId
• createByNotNull : qui permet de crée l'entité avec tout les naturalId not null (donc obligatoire)
• existByNaturalId : qui permet de vérifié que l'entité correspondant au naturalId existe
• findByNaturalId : qui permet de chercher l'entité sur les naturalId

Ajouter des requêtes complexes

public class ContactDAOImpl<E extends Contact> extends ContactDAOAbstract<E> {

   @Override
   public Set<Contact> findAllByCompany(Company company) throws TopiaException {
        ...
   }

}