nc.ird.cantharella.service.services

Interface PersonneService

All Known Implementing Classes:

PersonneServiceImpl

public interface PersonneService

Service : personnes, utilisateurs

Author:

Mickael Tricot, Adrien Cheype

Method Summary

Methods

Modifier and Type	Method and Description
boolean	authenticateUtilisateur(String courriel, String passwordHash) Authentifie un utilisateur.
void	checkOrCreateAdmin() Créée un administrateur par défaut s'il n'y en a pas
long	countPersonnes() Compte le nombre de personnes
void	createPersonne(nc.ird.cantharella.data.model.Personne personne) Création d'une personne
void	createUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur) Enregistrement d'un utilisateur
void	deletePersonne(nc.ird.cantharella.data.model.Personne personne) Supprime une personne
void	deleteUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur) Supprimer un utilisateur, le transformer en personne si il a des données liées.
String	hashPassword(String password) Hachage du mot de passe
List<String>	listPersonneOrganismes() Liste les organismes existants pour les personnes
List<nc.ird.cantharella.data.model.Personne>	listPersonnes() Liste les personnes (triés par nom, prénom).
List<nc.ird.cantharella.data.model.Personne>	listPersonnesWithInvalidUsers() Liste les personnes (triés par nom, prénom) avec y compris les utilisateurs invalides.
List<nc.ird.cantharella.data.model.Utilisateur>	listUtilisateursInvalid() Liste les utilisateurs à valider
List<nc.ird.cantharella.data.model.Utilisateur>	listUtilisateursValid() Liste les utilisateurs valides
nc.ird.cantharella.data.model.Personne	loadPersonne(Integer idPersonne) Charge une personne
nc.ird.cantharella.data.model.Personne	loadPersonne(String courriel) Charge une personne
nc.ird.cantharella.data.model.Utilisateur	loadUtilisateur(Integer idPersonne) Charge un utilisateur
nc.ird.cantharella.data.model.Utilisateur	loadUtilisateur(String courriel) Charge un utilisateur
void	refreshPersonne(nc.ird.cantharella.data.model.Personne personne) Rafraichit une personne (pour éviter des LazyLoadingException)
void	rejectUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur) Refuser un utilisateur, et le prévient par e-mail (supprimé de la BD ou transformé en personne si données liées)
void	resetPasswordUtilisateur(String courriel) Met à jour le mot de passe (perdu) d'un utilisateur, et lui envoie un e-mail
void	sendMailAdmins(String subject, String message, String replyTo) Envoie un e-mail aux administrateurs
nc.ird.cantharella.data.model.Utilisateur	updateAndCreateUtilisateur(nc.ird.cantharella.data.model.Personne personne) Met à jour et transforme une personne en utilisateur, génère un mot de passe automatique et le prévient par e-mail
boolean	updateOrDeletePersonneEnabled(nc.ird.cantharella.data.model.Personne personne, nc.ird.cantharella.data.model.Utilisateur modifieur) Test de droits pour la modification ou suppression d'une personne (ou par héritage d'un utilisateur)
void	updatePersonne(nc.ird.cantharella.data.model.Personne personne) Met à jour une personne
void	updateUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur, boolean admin) Met à jour un utilisateur, et lui envoie un e-mail si cela a été effectuée par un administrateur
void	validAndUpdateUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur) Valide et met à jour un utilisateur, et le prévient par e-mail

Method Detail

checkOrCreateAdmin

void checkOrCreateAdmin()
                        throws nc.ird.cantharella.data.exceptions.DataConstraintException

Créée un administrateur par défaut s'il n'y en a pas

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si la personne existe déjà (champs uniques)

countPersonnes

long countPersonnes()

Compte le nombre de personnes

Returns:

Nombre de personnes

createPersonne

void createPersonne(nc.ird.cantharella.data.model.Personne personne)
                    throws nc.ird.cantharella.data.exceptions.DataConstraintException

Création d'une personne

Parameters:

personne - Personne

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si la personne existe déjà (champs uniques)

createUtilisateur

void createUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur)
                       throws nc.ird.cantharella.data.exceptions.DataConstraintException

Enregistrement d'un utilisateur

Parameters:

utilisateur - Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si l'utilisateur existe déjà (champs uniques)

deletePersonne

void deletePersonne(nc.ird.cantharella.data.model.Personne personne)
                    throws nc.ird.cantharella.data.exceptions.DataConstraintException

Supprime une personne

Parameters:

personne - Personne

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si des données sont liées à la personne

deleteUtilisateur

void deleteUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur)
                       throws nc.ird.cantharella.data.exceptions.DataConstraintException,
                              EmailException

Supprimer un utilisateur, le transformer en personne si il a des données liées. On vérifie avant qu'il y aura toujours un administrateur.

Parameters:

utilisateur - Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si l'utilisateur est encore référencé (créateur d'entités)

EmailException - En cas d'erreur dans l'envoi d'e-mail

hashPassword

String hashPassword(String password)

Hachage du mot de passe

Parameters:

password - Mot de passe

Returns:

Mot de passe haché

listPersonnes

@Transactional(readOnly=true)
List<nc.ird.cantharella.data.model.Personne> listPersonnes()

Liste les personnes (triés par nom, prénom). Les utilisateurs non valides sont exclus.

Returns:

Personnes

listPersonnesWithInvalidUsers

@Transactional(readOnly=true)
List<nc.ird.cantharella.data.model.Personne> listPersonnesWithInvalidUsers()

Liste les personnes (triés par nom, prénom) avec y compris les utilisateurs invalides.

Returns:

Personnes

listPersonneOrganismes

@Transactional(readOnly=true)
List<String> listPersonneOrganismes()

Liste les organismes existants pour les personnes

Returns:

Les organismes

listUtilisateursInvalid

@Transactional(readOnly=true)
List<nc.ird.cantharella.data.model.Utilisateur> listUtilisateursInvalid()

Liste les utilisateurs à valider

Returns:

Utilisateurs à valider

listUtilisateursValid

@Transactional(readOnly=true)
List<nc.ird.cantharella.data.model.Utilisateur> listUtilisateursValid()

Liste les utilisateurs valides

Returns:

Utilisateurs valides

loadPersonne

nc.ird.cantharella.data.model.Personne loadPersonne(Integer idPersonne)
                                                    throws nc.ird.cantharella.data.exceptions.DataNotFoundException

Charge une personne

Parameters:

idPersonne - Identifiant

Returns:

Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataNotFoundException - Si la personne n'existe pas

loadPersonne

nc.ird.cantharella.data.model.Personne loadPersonne(String courriel)
                                                    throws nc.ird.cantharella.data.exceptions.DataNotFoundException

Charge une personne

Parameters:

courriel - Courriel

Returns:

Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataNotFoundException - Si la personne n'existe pas

loadUtilisateur

nc.ird.cantharella.data.model.Utilisateur loadUtilisateur(Integer idPersonne)
                                                          throws nc.ird.cantharella.data.exceptions.DataNotFoundException

Charge un utilisateur

Parameters:

idPersonne - Identifiant

Returns:

Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataNotFoundException - Si l'utilisateur n'existe pas

loadUtilisateur

nc.ird.cantharella.data.model.Utilisateur loadUtilisateur(String courriel)
                                                          throws nc.ird.cantharella.data.exceptions.DataNotFoundException

Charge un utilisateur

Parameters:

courriel - Courriel

Returns:

Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataNotFoundException - Si l'utilisateur n'existe pas

authenticateUtilisateur

boolean authenticateUtilisateur(String courriel,
                              String passwordHash)

Authentifie un utilisateur. L'utilisateur ne doit pas seulement exister mais être également validé.

Parameters:

courriel - Courriel

passwordHash - Mot de passe haché

Returns:

Vrai si l'authentification réussit

refreshPersonne

void refreshPersonne(nc.ird.cantharella.data.model.Personne personne)

Rafraichit une personne (pour éviter des LazyLoadingException)

Parameters:

personne - Personne

rejectUtilisateur

void rejectUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur)

Refuser un utilisateur, et le prévient par e-mail (supprimé de la BD ou transformé en personne si données liées)

Parameters:

utilisateur - Utilisateur

resetPasswordUtilisateur

void resetPasswordUtilisateur(String courriel)
                              throws nc.ird.cantharella.data.exceptions.DataNotFoundException,
                                     EmailException

Met à jour le mot de passe (perdu) d'un utilisateur, et lui envoie un e-mail

Parameters:

courriel - Courriel

Throws:

nc.ird.cantharella.data.exceptions.DataNotFoundException - Si le courriel n'existe pas

EmailException - En cas d'erreur dans l'envoi d'e-mail

sendMailAdmins

void sendMailAdmins(String subject,
                  String message,
                  String replyTo)
                    throws EmailException

Envoie un e-mail aux administrateurs

Parameters:

subject - Sujet

message - Message

replyTo - Expéditeur

Throws:

EmailException - En cas d'erreur lors de l'envoi

updateAndCreateUtilisateur

nc.ird.cantharella.data.model.Utilisateur updateAndCreateUtilisateur(nc.ird.cantharella.data.model.Personne personne)
                                                                     throws EmailException,
                                                                            nc.ird.cantharella.data.exceptions.DataConstraintException

Met à jour et transforme une personne en utilisateur, génère un mot de passe automatique et le prévient par e-mail

Parameters:

personne - Personne

Returns:

Utilisateur créé

Throws:

EmailException - En cas d'erreur dans l'envoi d'e-mail

nc.ird.cantharella.data.exceptions.DataConstraintException - Si la personne existe déjà (champs uniques)

updatePersonne

void updatePersonne(nc.ird.cantharella.data.model.Personne personne)
                    throws nc.ird.cantharella.data.exceptions.DataConstraintException

Met à jour une personne

Parameters:

personne - Personne

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si la personne existe déjà (champs uniques)

updateUtilisateur

void updateUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur,
                     boolean admin)
                       throws nc.ird.cantharella.data.exceptions.DataConstraintException

Met à jour un utilisateur, et lui envoie un e-mail si cela a été effectuée par un administrateur

Parameters:

utilisateur - Utilisateur

admin - Effectuée par un administrateur ?

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si l'utilisateur existe déjà (champs uniques)

validAndUpdateUtilisateur

void validAndUpdateUtilisateur(nc.ird.cantharella.data.model.Utilisateur utilisateur)
                               throws nc.ird.cantharella.data.exceptions.DataConstraintException

Valide et met à jour un utilisateur, et le prévient par e-mail

Parameters:

utilisateur - Utilisateur

Throws:

nc.ird.cantharella.data.exceptions.DataConstraintException - Si l'utilisateur existe déjà (champs uniques)

updateOrDeletePersonneEnabled

boolean updateOrDeletePersonneEnabled(nc.ird.cantharella.data.model.Personne personne,
                                    nc.ird.cantharella.data.model.Utilisateur modifieur)

Test de droits pour la modification ou suppression d'une personne (ou par héritage d'un utilisateur)

Parameters:

personne - Personne à mettre à jour

modifieur - L'utilisateur qui fait la modification

Returns:

vrai si l'utilisateur peut modifier ou supprimer la personne