| java.lang.Object jfb.tools.activitymgr.core.DbMgr
DbMgr | public class DbMgr (Code) | | Classe offrant les services de base de persistence de
l'application.
|
Method Summary | |
protected static DbTransaction | beginTransaction() Permet de commencer une transaction.
Une connexion à la base de données est établie. | protected static Contribution | changeContributionTask(DbTransaction tx, Contribution contribution, Task newContributionTask) Change la tache d'une contribution.
Parameters: tx - contexte de transaction. Parameters: contribution - la contribution. Parameters: newContributionTask - la tache à affecter. | protected static void | closeDatabaseAccess() Ferme la base de données. | protected static void | commitTransaction(DbTransaction tx) Valide une transactrion. | protected static Collaborator | createCollaborator(DbTransaction tx, Collaborator newCollaborator) Crée un collaborateur.
Parameters: tx - contexte de transaction. Parameters: newCollaborator - le collaborateur à créer. | protected static Contribution | createContribution(DbTransaction tx, Contribution newContribution) Crée une contribution.
Parameters: tx - contexte de transaction. Parameters: newContribution - la nouvelle contribution. | protected static Duration | createDuration(DbTransaction tx, Duration newDuration) Crée une contribution.
Parameters: tx - contexte de transaction. Parameters: newDuration - la nouvelle durée. | protected static void | createTables(DbTransaction tx) Crée les tables du modèle de données. | protected static Task | createTask(DbTransaction tx, Task parentTask, Task newTask) Crée une tache.
La tache parent peut être nulle pour indiquer que la nouvelle tache
est une tache racine.
Parameters: tx - le contexte de transaction. Parameters: parentTask - la tache parent accueillant la nouvelle tache. Parameters: newTask - la nouvelle tache. | protected static boolean | durationIsUsed(DbTransaction tx, Duration duration) Vérifie si la durée est utilisée en base.
Parameters: tx - le contexte de transaction. Parameters: duration - la durée à vérifier. | protected static void | endTransaction(DbTransaction tx) Ferme une transactrion. | protected static Collaborator | getCollaborator(DbTransaction tx, long collaboratorId) Parameters: tx - le contexte de transaction. Parameters: collaboratorId - l'identifiant du collaborateur recherché. | protected static Collaborator | getCollaborator(DbTransaction tx, String login) Parameters: tx - le contexte de transaction. Parameters: login - l'identifiant de connexion du collaborateur recherché. | protected static Collaborator[] | getCollaborators(DbTransaction tx, int orderByClauseFieldIndex, boolean ascendantSort, boolean onlyActiveCollaborators) Parameters: tx - le contexte de transaction. Parameters: orderByClauseFieldIndex - index de l'attribut utilisé pour le tri. Parameters: ascendantSort - booléen indiquant si le tri doit être ascendant. Parameters: onlyActiveCollaborators - booléen indiquant si l'on ne doit retourner queles collaborateurs actifs. | protected static Contribution[] | getContributions(DbTransaction tx, Collaborator contributor, Task task, Calendar fromDate, Calendar toDate) Parameters: tx - le contexte de transaction. Parameters: contributor - le collaborateur associé aux contributions. Parameters: task - la tache associée aux contributions. Parameters: fromDate - la date de départ. Parameters: toDate - la date de fin. | protected static Contribution[] | getContributions(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) Retourne les contributions associées aux paramètres spécifiés.
Tous les paramètres sont facultatifs. | protected static long | getContributionsNb(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) Calcule le nombre des contributions associée aux paramètres spécifiés.
Tous les paramètres sont facultatifs. | protected static long | getContributionsSum(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) Calcule le cumuls des consommations associees aux contributions pour
les paramètres spécifiés.
Tous les paramètres sont facultatifs. | protected static Duration | getDuration(DbTransaction tx, long durationId) Parameters: tx - le contexte de transaction. Parameters: durationId - l'identifiant de la durée. | protected static Duration[] | getDurations(DbTransaction tx, boolean onlyActiveCollaborators) Parameters: tx - le contexte de transaction. Parameters: onlyActiveCollaborators - booléen indiquant si l'on ne doit retourner queles collaborateurs actifs. | protected static Task | getParentTask(DbTransaction tx, Task task) Parameters: tx - le contexte de transaction. Parameters: task - la tache dont on veut connaitre la tache parent. | protected static Task[] | getSubtasks(DbTransaction tx, Task parentTask) Parameters: tx - le contexte de transaction. Parameters: parentTask - la tache parent dont on veut connaitre les sous-taches. | protected static Task | getTask(DbTransaction tx, long taskId) Parameters: tx - le contexte de transaction. Parameters: taskId - l'identifiant de la tache recherchée. | protected static Task | getTask(DbTransaction tx, String taskPath, byte taskNumber) Parameters: tx - le contexte de transaction. Parameters: taskPath - le chemin de la tache recherchée. Parameters: taskNumber - le numéro de la tache recherchée. | protected static Task | getTask(DbTransaction tx, String taskPath, String taskCode) Parameters: tx - le contexte de transaction. Parameters: taskPath - le chemin de la tache recherchée. Parameters: taskCode - le code de la tache recherchée. | protected static TaskSums | getTaskSums(DbTransaction tx, Task task) Parameters: tx - le contexte de transaction. Parameters: task - la tâche pour laquelle on souhaite connaître les totaux. | protected static Task[] | getTasks(DbTransaction tx, String path) Parameters: tx - le contexte de transaction. Parameters: path - le chemin dont on veut connaître les taches. | protected static Task[] | getTasks(DbTransaction tx, TaskSearchFilter filter) Retourn la liste des taches correspondant au filtre de recherche spécifié.
Parameters: tx - le contexte de transaction. Parameters: filter - le filtre de recherche. | protected static Task[] | getTasks(DbTransaction tx, Collaborator collaborator, Calendar fromDate, Calendar toDate) Parameters: tx - le contexte de transaction. Parameters: collaborator - le collaborateur. Parameters: fromDate - date de début. Parameters: toDate - date de fin. | protected static void | initDatabaseAccess(String driverName, String url, String user, String password) Initialise la connexion à la base de données. | protected static byte | newTaskNumber(DbTransaction tx, String path) Génère un nouveau numéro de tache pour un chemin donné.
Parameters: tx - le contexte de transaction. Parameters: path - le chemin considéré. | protected static void | removeCollaborator(DbTransaction tx, Collaborator collaborator) Supprime un collaborateur. | protected static void | removeContribution(DbTransaction tx, Contribution contribution) Supprime une contribution. | protected static void | removeDuration(DbTransaction tx, Duration duration) Supprime une durée du référentiel de durées. | protected static void | removeTask(DbTransaction tx, Task task) Supprime une tache. | protected static void | rollbackTransaction(DbTransaction tx) Annule le modifications effectuées dans le cadre d'une transactrion. | protected static boolean | tablesExist(DbTransaction tx) Vérifie si les tables existent dans le modèle.
Parameters: tx - le contexte de transaction. | protected static Collaborator | updateCollaborator(DbTransaction tx, Collaborator collaborator) Modifie les attributs d'un collaborateur.
Parameters: tx - contexte de transaction. Parameters: collaborator - le collaborateur à modifier. | protected static Contribution | updateContribution(DbTransaction tx, Contribution contribution) Modifie les attributs d'une contribution.
Parameters: tx - contexte de transaction. Parameters: contribution - la contribution à modifier. | protected static Duration | updateDuration(DbTransaction tx, Duration duration) Met à jour une durée.
Parameters: tx - le contexte de transaction. Parameters: duration - la durée à mettre à jour. | protected static Task | updateTask(DbTransaction tx, Task task) Modifie les attributs d'une tache.
Parameters: tx - contexte de transaction. Parameters: task - la tache à modifier. |
beginTransaction | protected static DbTransaction beginTransaction() throws DbException(Code) | | Permet de commencer une transaction.
Une connexion à la base de données est établie. Celle ci
doit être validée par la couche appelante par une invocation
de endTransaction .
le contexte de transaction. throws: DbException - levé en cas d'incident technique d'accès à la base. |
changeContributionTask | protected static Contribution changeContributionTask(DbTransaction tx, Contribution contribution, Task newContributionTask) throws DbException(Code) | | Change la tache d'une contribution.
Parameters: tx - contexte de transaction. Parameters: contribution - la contribution. Parameters: newContributionTask - la tache à affecter. la contribution mise à jour. throws: DbException - levé en cas d'incident technique d'accès à la base. |
closeDatabaseAccess | protected static void closeDatabaseAccess() throws DbException(Code) | | Ferme la base de données.
throws: DbException - levé en cas d'incident technique d'accès à la BDD. |
commitTransaction | protected static void commitTransaction(DbTransaction tx) throws DbException(Code) | | Valide une transactrion.
Parameters: tx - contexte de transaction. throws: DbException - levé en cas d'incident technique d'accès à la base. |
createCollaborator | protected static Collaborator createCollaborator(DbTransaction tx, Collaborator newCollaborator) throws DbException(Code) | | Crée un collaborateur.
Parameters: tx - contexte de transaction. Parameters: newCollaborator - le collaborateur à créer. le collaborateur après création. throws: DbException - levé en cas d'incident technique d'accès à la base. |
createContribution | protected static Contribution createContribution(DbTransaction tx, Contribution newContribution) throws DbException(Code) | | Crée une contribution.
Parameters: tx - contexte de transaction. Parameters: newContribution - la nouvelle contribution. la contribution après création. throws: DbException - levé en cas d'incident technique d'accès à la base. |
createDuration | protected static Duration createDuration(DbTransaction tx, Duration newDuration) throws DbException(Code) | | Crée une contribution.
Parameters: tx - contexte de transaction. Parameters: newDuration - la nouvelle durée. la durée après création. throws: DbException - levé en cas d'incident technique d'accès à la base. |
createTables | protected static void createTables(DbTransaction tx) throws DbException(Code) | | Crée les tables du modèle de données.
Parameters: tx - contexte de transaction. throws: DbException - levé en cas d'incident technique d'accès à la base. |
createTask | protected static Task createTask(DbTransaction tx, Task parentTask, Task newTask) throws DbException(Code) | | Crée une tache.
La tache parent peut être nulle pour indiquer que la nouvelle tache
est une tache racine.
Parameters: tx - le contexte de transaction. Parameters: parentTask - la tache parent accueillant la nouvelle tache. Parameters: newTask - la nouvelle tache. la tache après création. throws: DbException - levé en cas d'incident technique d'accès à la base. |
durationIsUsed | protected static boolean durationIsUsed(DbTransaction tx, Duration duration) throws DbException(Code) | | Vérifie si la durée est utilisée en base.
Parameters: tx - le contexte de transaction. Parameters: duration - la durée à vérifier. un booléen indiquant si la durée est utilisée. throws: DbException - levé en cas d'incident technique d'accès à la base. |
endTransaction | protected static void endTransaction(DbTransaction tx) throws DbException(Code) | | Ferme une transactrion.
Parameters: tx - le contexte de transaction. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getCollaborator | protected static Collaborator getCollaborator(DbTransaction tx, long collaboratorId) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: collaboratorId - l'identifiant du collaborateur recherché. le collaborateur dont l'identifiant est spécifié. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getCollaborator | protected static Collaborator getCollaborator(DbTransaction tx, String login) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: login - l'identifiant de connexion du collaborateur recherché. le collaborateur dont l'identifiant de connexion est spécifié. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getCollaborators | protected static Collaborator[] getCollaborators(DbTransaction tx, int orderByClauseFieldIndex, boolean ascendantSort, boolean onlyActiveCollaborators) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: orderByClauseFieldIndex - index de l'attribut utilisé pour le tri. Parameters: ascendantSort - booléen indiquant si le tri doit être ascendant. Parameters: onlyActiveCollaborators - booléen indiquant si l'on ne doit retourner queles collaborateurs actifs. la liste des collaborateurs. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getContributions | protected static Contribution[] getContributions(DbTransaction tx, Collaborator contributor, Task task, Calendar fromDate, Calendar toDate) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: contributor - le collaborateur associé aux contributions. Parameters: task - la tache associée aux contributions. Parameters: fromDate - la date de départ. Parameters: toDate - la date de fin. la liste des contributions associées aux paramètres spécifiés. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getContributions | protected static Contribution[] getContributions(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) throws DbException(Code) | | Retourne les contributions associées aux paramètres spécifiés.
Tous les paramètres sont facultatifs. Chaque paramètre spécifié agît
comme un filtre sur le résultat. A l'inverse, l'omission d'un paramètre
provoque l'inclusion de toutes les contributions, quelque soit leurs
valeurs pour l'attribut considéré.
La spécification des paramètres répond aux mêmes règles que pour la
méthode getContributionsSum .
Parameters: tx - le contexte de transaction. Parameters: task - la tâche associée aux contributions (facultative). Parameters: contributor - le collaborateur associé aux contributions (facultatif). Parameters: year - l'année (facultative). Parameters: month - le mois (facultatif). Parameters: day - le jour (facultatif). les contributions. throws: DbException - levé en cas d'incident technique d'accès à la base. See Also: jfb.tools.activitymgr.core.DbMgr.getContributionsSum(DbTransactionTaskCollaboratorIntegerIntegerInteger) |
getContributionsNb | protected static long getContributionsNb(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) throws DbException(Code) | | Calcule le nombre des contributions associée aux paramètres spécifiés.
Tous les paramètres sont facultatifs. Chaque paramètre spécifié agît
comme un filtre sur le résultat. A l'inverse, l'omission d'un paramètre
provoque l'inclusion de toutes les contributions, quelque soit leurs
valeurs pour l'attribut considéré.
En spécifiant la tache X, on connaîtra la somme des contribution pour
la taches X. En ne spécifiant pas de tache, la somme sera effectuée quelque
soit les tâches.
Parameters: tx - le contexte de transaction. Parameters: task - la tâche associée aux contributions (facultative). Parameters: contributor - le collaborateur associé aux contributions (facultatif). Parameters: year - l'année (facultative). Parameters: month - le mois (facultatif). Parameters: day - le jour (facultatif). la seomme des contributions. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getContributionsSum | protected static long getContributionsSum(DbTransaction tx, Task task, Collaborator contributor, Integer year, Integer month, Integer day) throws DbException(Code) | | Calcule le cumuls des consommations associees aux contributions pour
les paramètres spécifiés.
Tous les paramètres sont facultatifs. Chaque paramètre spécifié agît
comme un filtre sur le résultat. A l'inverse, l'omission d'un paramètre
provoque l'inclusion de toutes les contributions, quelque soit leurs
valeurs pour l'attribut considéré.
En spécifiant la tache X, on connaîtra la somme des contribution pour
la taches X. En ne spécifiant pas de tache, la somme sera effectuée quelque
soit les tâches.
Parameters: tx - le contexte de transaction. Parameters: task - la tâche associée aux contributions (facultative). Parameters: contributor - le collaborateur associé aux contributions (facultatif). Parameters: year - l'année (facultative). Parameters: month - le mois (facultatif). Parameters: day - le jour (facultatif). la seomme des contributions. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getDuration | protected static Duration getDuration(DbTransaction tx, long durationId) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: durationId - l'identifiant de la durée. la durée. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getDurations | protected static Duration[] getDurations(DbTransaction tx, boolean onlyActiveCollaborators) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: onlyActiveCollaborators - booléen indiquant si l'on ne doit retourner queles collaborateurs actifs. la liste des durées. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getParentTask | protected static Task getParentTask(DbTransaction tx, Task task) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: task - la tache dont on veut connaitre la tache parent. la tache parent d'une tache spécifiée. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getSubtasks | protected static Task[] getSubtasks(DbTransaction tx, Task parentTask) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: parentTask - la tache parent dont on veut connaitre les sous-taches. la liste des sous-taches. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTask | protected static Task getTask(DbTransaction tx, long taskId) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: taskId - l'identifiant de la tache recherchée. la tache dont l'identifiant est spécifié. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTask | protected static Task getTask(DbTransaction tx, String taskPath, byte taskNumber) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: taskPath - le chemin de la tache recherchée. Parameters: taskNumber - le numéro de la tache recherchée. la tache dont le chemin et le numéro sont spécifiés. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTask | protected static Task getTask(DbTransaction tx, String taskPath, String taskCode) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: taskPath - le chemin de la tache recherchée. Parameters: taskCode - le code de la tache recherchée. la tache dont le code et la tache parent sont spécifiés. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTaskSums | protected static TaskSums getTaskSums(DbTransaction tx, Task task) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: task - la tâche pour laquelle on souhaite connaître les totaux. les totaux associés à une tache (consommé, etc.). throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTasks | protected static Task[] getTasks(DbTransaction tx, String path) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: path - le chemin dont on veut connaître les taches. la liste des taches associées à un chemin donné. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTasks | protected static Task[] getTasks(DbTransaction tx, TaskSearchFilter filter) throws DbException(Code) | | Retourn la liste des taches correspondant au filtre de recherche spécifié.
Parameters: tx - le contexte de transaction. Parameters: filter - le filtre de recherche. la liste des taches correspondant au filtre de recherche spécifié. throws: DbException - levé en cas d'incident technique d'accès à la base. |
getTasks | protected static Task[] getTasks(DbTransaction tx, Collaborator collaborator, Calendar fromDate, Calendar toDate) throws DbException(Code) | | Parameters: tx - le contexte de transaction. Parameters: collaborator - le collaborateur. Parameters: fromDate - date de début. Parameters: toDate - date de fin. la liste de taches associées au collaborateur entre les 2 dates spécifiées. throws: DbException - levé en cas d'incident technique d'accès à la base. |
initDatabaseAccess | protected static void initDatabaseAccess(String driverName, String url, String user, String password) throws DbException(Code) | | Initialise la connexion à la base de données.
Parameters: driverName - le nom du driver JDBC. Parameters: url - l'URL de connexion au serveur. Parameters: user - l'identifiant de connexion/ Parameters: password - le mot de passe de connexion. throws: DbException - levé en cas d'incident technique d'accès à la base. |
newTaskNumber | protected static byte newTaskNumber(DbTransaction tx, String path) throws DbException(Code) | | Génère un nouveau numéro de tache pour un chemin donné.
Parameters: tx - le contexte de transaction. Parameters: path - le chemin considéré. le numéro généré. throws: DbException - levé en cas d'incident technique d'accès à la base. |
removeCollaborator | protected static void removeCollaborator(DbTransaction tx, Collaborator collaborator) throws DbException(Code) | | Supprime un collaborateur.
Parameters: tx - le contexte de transaction. Parameters: collaborator - le collaborateur à supprimer. throws: DbException - levé en cas d'incident technique d'accès à la base. |
removeContribution | protected static void removeContribution(DbTransaction tx, Contribution contribution) throws DbException(Code) | | Supprime une contribution.
Parameters: tx - le contexte de transaction. Parameters: contribution - la contribution à supprimer. throws: DbException - levé en cas d'incident technique d'accès à la base. |
removeDuration | protected static void removeDuration(DbTransaction tx, Duration duration) throws DbException(Code) | | Supprime une durée du référentiel de durées.
Parameters: tx - le contexte de transaction. Parameters: duration - la durée à supprimer. throws: DbException - levé en cas d'incident technique d'accès à la base. |
removeTask | protected static void removeTask(DbTransaction tx, Task task) throws DbException(Code) | | Supprime une tache.
Parameters: tx - le contexte de transaction. Parameters: task - la tache à supprimer. throws: DbException - levé en cas d'incident technique d'accès à la base. |
rollbackTransaction | protected static void rollbackTransaction(DbTransaction tx) throws DbException(Code) | | Annule le modifications effectuées dans le cadre d'une transactrion.
Parameters: tx - contexte de transaction. throws: DbException - levé en cas d'incident technique d'accès à la base. |
tablesExist | protected static boolean tablesExist(DbTransaction tx) throws DbException(Code) | | Vérifie si les tables existent dans le modèle.
Parameters: tx - le contexte de transaction. un booléen indiquant si la table spécifiée existe dans le modèle. throws: DbException - levé en cas d'incident technique d'accès à la base. |
updateCollaborator | protected static Collaborator updateCollaborator(DbTransaction tx, Collaborator collaborator) throws DbException(Code) | | Modifie les attributs d'un collaborateur.
Parameters: tx - contexte de transaction. Parameters: collaborator - le collaborateur à modifier. le collaborateur modifié. throws: DbException - levé en cas d'incident technique d'accès à la base. |
updateContribution | protected static Contribution updateContribution(DbTransaction tx, Contribution contribution) throws DbException(Code) | | Modifie les attributs d'une contribution.
Parameters: tx - contexte de transaction. Parameters: contribution - la contribution à modifier. la contribution modifiée. throws: DbException - levé en cas d'incident technique d'accès à la base. |
updateDuration | protected static Duration updateDuration(DbTransaction tx, Duration duration) throws DbException(Code) | | Met à jour une durée.
Parameters: tx - le contexte de transaction. Parameters: duration - la durée à mettre à jour. la durée mise à jour. throws: DbException - levé en cas d'incident technique d'accès à la base. |
updateTask | protected static Task updateTask(DbTransaction tx, Task task) throws DbException(Code) | | Modifie les attributs d'une tache.
Parameters: tx - contexte de transaction. Parameters: task - la tache à modifier. la tache modifiée. throws: DbException - levé en cas d'incident technique d'accès à la base. |
|
|