Source code: org/jeteam/bean/config/StatusServiceBean.java
1 /*
2 * JETeam, Java Enterprise TeamWork
3 *
4 * Distributable under the GPL license.
5 * See terms of licence at http://www.gnu.org
6 *
7 * $Source: /cvsroot/jeteam/jeteam/jeteam-bcx/src/java/org/jeteam/bean/config/StatusServiceBean.java,v $
8 * $Date: 2003/05/28 22:07:47 $
9 * $Author: draftdog $
10 * $Revision: 1.9 $
11 */
12 package org.jeteam.bean.config;
13
14 import javax.ejb.CreateException;
15 import javax.ejb.SessionBean;
16
17
18 /**
19 *
20 * <p>
21 * This bean is a service to Status CRUD operations.
22 * </p>
23 *
24 * <p>
25 * A status is an indicator telling you the status of a certain task
26 * or other item, this is not really like the progress, rather it
27 * will tell you if a project is suspended, closed, deleted, etc...
28 * </p>
29 *
30 * @ejb.bean
31 * name="StatusService"
32 * type="Stateless"
33 * jndi-name="org.jeteam.bean.config/StatusService/Home"
34 * @ejb.util
35 * generate="physical"
36 * element.uuid 127-0-0-1-1aff40f:f3962d7998:-7f81
37 * @ejb.ejb-ref
38 * ejb-name="Status"
39 * view-type="local"
40 * ref-name="ejb/StatusBeanRef"
41 * @ejb.security-identity
42 * run-as="InternalUser"
43 *
44 */
45 public abstract class StatusServiceBean implements SessionBean
46 {
47
48 // ---------------- business methods ----------------------
49
50 /**
51 *
52 * <p>
53 * Create a new status entry, the name of the status must be unique.
54 * </p>
55 *
56 * @ejb.interface-method
57 * @ejb.transaction type="Required"
58 * @ejb.permission
59 * unchecked = "false"
60 * role-name = "StatusService,StatusService.createStatus"
61 */
62 public abstract org.jeteam.bean.config.StatusDTO createStatus(org.jeteam.bean.config.StatusDTO status)
63 throws StatusException;
64
65 /**
66 *
67 * <p>
68 * Physically removes the status from the data source.
69 * </p>
70 *
71 * @ejb.interface-method
72 * @ejb.transaction type="Required"
73 * @ejb.permission
74 * unchecked = "false"
75 * role-name = "StatusService,StatusService.removeStatus"
76 */
77 public abstract void removeStatus(org.jeteam.bean.config.StatusDTO status)
78 throws StatusException;
79
80 /**
81 *
82 * <p>
83 * Returns a collection of all status entries found in the data
84 * source.
85 * </p>
86 *
87 * @ejb.interface-method
88 * @ejb.transaction type="Required"
89 * @ejb.permission
90 * unchecked = "false"
91 * role-name = "StatusService,StatusService.getStatusses"
92 */
93 public abstract org.jeteam.bean.config.StatusDTO[] getStatusses()
94 throws StatusException;
95
96 /**
97 *
98 * <p>
99 * Updates the properties of the status, the name can be changed but
100 * must be unique.
101 * </p>
102 *
103 * @ejb.interface-method
104 * @ejb.transaction type="Required"
105 * @ejb.permission
106 * unchecked = "false"
107 * role-name = "StatusService,StatusService.updateStatus"
108 */
109 public abstract void updateStatus(org.jeteam.bean.config.StatusDTO status)
110 throws StatusException;
111
112 // ---------------- create methods -------------------------
113
114 /**
115 * @ejb.create-method
116 * @ejb.transaction type="Required"
117 * @ejb.permission
118 * unchecked = "false"
119 * role-name = "StatusService,StatusService.ejbCreate"
120 */
121 public void ejbCreate()
122 throws CreateException
123 {
124 }
125
126 public void ejbPostCreate()
127 throws CreateException
128 {
129 }
130 }