Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.jeteam.bean.project
Class ProjectServiceBean  view ProjectServiceBean download ProjectServiceBean.java

java.lang.Object
  extended byorg.jeteam.bean.project.ProjectServiceBean
All Implemented Interfaces:
javax.ejb.EnterpriseBean, java.io.Serializable, javax.ejb.SessionBean
Direct Known Subclasses:
ProjectServiceBeanImpl

public abstract class ProjectServiceBean
extends java.lang.Object
implements javax.ejb.SessionBean

This bean is a service to Project CRUD operations.

Some other services are also provided, be extremely careful when removing roles from a project since this may impact the set of associated users too (read method documentation for more info).

A project is the center point of the jeteam system as user will be assigned to work on it, and all the tasks will be under the context of a project.


Constructor Summary
ProjectServiceBean()
           
 
Method Summary
abstract  void addRole(ProjectDTO project, org.jeteam.bean.security.RoleDTO role)
           Adds a new role this this project, this may allow other users to be assigned to this project.
abstract  void addTask(ProjectDTO project, org.jeteam.bean.task.TaskDTO task)
           Assigns a new task to this project, if the task has already been assigned to this project nothing happens.
abstract  void addUser(ProjectDTO project, org.jeteam.bean.user.UserDTO user)
           Assigns a new user to this project, if the user has already been assigned to this project nothing happens.
abstract  void addUsers(ProjectDTO project, org.jeteam.bean.user.UserDTO[] users)
           Adds the list of users to the existing list associated with the argument project.
abstract  void clearRoles(ProjectDTO project)
           Removes all roles from the project.
abstract  void clearTasks(ProjectDTO project)
           Removes all the tasks that have been created for this project.
abstract  void clearUsers(ProjectDTO project)
           Removes all users from this project.
abstract  ProjectDTO createProject(ProjectDTO project)
           When creating a new project make sure the project name does not already exists.
 void ejbCreate()
           
 void ejbPostCreate()
           
abstract  ProjectDTO[] getAllProjects()
           Returns all projects that can be found.
abstract  ProjectDTO[] getProjects()
           Getting the projects will only return the ones that have not been logically deleted, use getAllProjects() in case you need to retrieve the complete list of projects.
abstract  org.jeteam.bean.security.RoleDTO[] getRoles(ProjectDTO project)
           Returns the collection of roles that users must have before being able to be assigned to this project.
abstract  org.jeteam.bean.config.StatusDTO getStatus(ProjectDTO project)
           Gets the status of this project.
abstract  org.jeteam.bean.task.TaskDTO[] getTasks(ProjectDTO project)
           Returns all the tasks that have been created for this project.
abstract  org.jeteam.bean.user.UserDTO[] getUsers(ProjectDTO project)
           Returns all the users associated with this project.
abstract  void removeProject(ProjectDTO project)
           Removing a project will result in setting its 'deleted' attribute to the current date (not null ) so it will be logically deleted.
abstract  void removeRole(ProjectDTO project, org.jeteam.bean.security.RoleDTO role)
           Removes a role from the project.
abstract  void removeTask(ProjectDTO project, org.jeteam.bean.task.TaskDTO task)
           Removes the specified task from the argument project.
abstract  void removeUser(ProjectDTO project, org.jeteam.bean.user.UserDTO user)
           Removing a user from a project will result in removing the user from the relationship, it will not be deleted.
abstract  void setStatus(ProjectDTO project, org.jeteam.bean.config.StatusDTO status)
           Sets the status of this project.
abstract  void updateProject(ProjectDTO project)
           Updates this project's information, this can be either the name or the description.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.ejb.SessionBean
ejbActivate, ejbPassivate, ejbRemove, setSessionContext
 

Constructor Detail

ProjectServiceBean

public ProjectServiceBean()
Method Detail

createProject

public abstract ProjectDTO createProject(ProjectDTO project)
                                  throws ProjectException

When creating a new project make sure the project name does not already exists.


removeProject

public abstract void removeProject(ProjectDTO project)
                            throws ProjectException

Removing a project will result in setting its 'deleted' attribute to the current date (not null ) so it will be logically deleted.


getProjects

public abstract ProjectDTO[] getProjects()
                                  throws ProjectException

Getting the projects will only return the ones that have not been logically deleted, use getAllProjects() in case you need to retrieve the complete list of projects.


getAllProjects

public abstract ProjectDTO[] getAllProjects()
                                     throws ProjectException

Returns all projects that can be found.


getUsers

public abstract org.jeteam.bean.user.UserDTO[] getUsers(ProjectDTO project)
                                                 throws ProjectException

Returns all the users associated with this project.


removeUser

public abstract void removeUser(ProjectDTO project,
                                org.jeteam.bean.user.UserDTO user)
                         throws ProjectException

Removing a user from a project will result in removing the user from the relationship, it will not be deleted.


clearUsers

public abstract void clearUsers(ProjectDTO project)
                         throws ProjectException

Removes all users from this project.


updateProject

public abstract void updateProject(ProjectDTO project)
                            throws ProjectException

Updates this project's information, this can be either the name or the description. The name can be changed but must remain unique.


addUser

public abstract void addUser(ProjectDTO project,
                             org.jeteam.bean.user.UserDTO user)
                      throws ProjectException

Assigns a new user to this project, if the user has already been assigned to this project nothing happens.


addTask

public abstract void addTask(ProjectDTO project,
                             org.jeteam.bean.task.TaskDTO task)
                      throws ProjectException

Assigns a new task to this project, if the task has already been assigned to this project nothing happens.


setStatus

public abstract void setStatus(ProjectDTO project,
                               org.jeteam.bean.config.StatusDTO status)
                        throws ProjectException

Sets the status of this project.


getStatus

public abstract org.jeteam.bean.config.StatusDTO getStatus(ProjectDTO project)
                                                    throws ProjectException

Gets the status of this project.


getRoles

public abstract org.jeteam.bean.security.RoleDTO[] getRoles(ProjectDTO project)
                                                     throws ProjectException

Returns the collection of roles that users must have before being able to be assigned to this project. If a user has one of the roles associated to him/her, he can be assigned to the project.


addRole

public abstract void addRole(ProjectDTO project,
                             org.jeteam.bean.security.RoleDTO role)
                      throws ProjectException

Adds a new role this this project, this may allow other users to be assigned to this project. If the role is already assinged to this project nothing happens.


removeRole

public abstract void removeRole(ProjectDTO project,
                                org.jeteam.bean.security.RoleDTO role)
                         throws ProjectException

Removes a role from the project.

This may cause for some confusion since all associated users that do not have roles anymore required by the project will be removed from the project.


clearRoles

public abstract void clearRoles(ProjectDTO project)
                         throws ProjectException

Removes all roles from the project.

This will remove all associated users from this project, so use it with care!


addUsers

public abstract void addUsers(ProjectDTO project,
                              org.jeteam.bean.user.UserDTO[] users)
                       throws ProjectException

Adds the list of users to the existing list associated with the argument project.


getTasks

public abstract org.jeteam.bean.task.TaskDTO[] getTasks(ProjectDTO project)
                                                 throws ProjectException

Returns all the tasks that have been created for this project.


clearTasks

public abstract void clearTasks(ProjectDTO project)
                         throws ProjectException

Removes all the tasks that have been created for this project.


removeTask

public abstract void removeTask(ProjectDTO project,
                                org.jeteam.bean.task.TaskDTO task)
                         throws ProjectException

Removes the specified task from the argument project. The task must exist, and must be associated with the project.


ejbCreate

public void ejbCreate()
               throws javax.ejb.CreateException

ejbPostCreate

public void ejbPostCreate()
                   throws javax.ejb.CreateException