View Javadoc

1   /**
2    * Copyright 2010 The Kuali Foundation Licensed under the
3    * Educational Community License, Version 2.0 (the "License"); you may
4    * not use this file except in compliance with the License. You may
5    * obtain a copy of the License at
6    *
7    * http://www.osedu.org/licenses/ECL-2.0
8    *
9    * Unless required by applicable law or agreed to in writing,
10   * software distributed under the License is distributed on an "AS IS"
11   * BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
12   * or implied. See the License for the specific language governing
13   * permissions and limitations under the License.
14   */
15  
16  package org.kuali.student.lum.lu.dto;
17  
18  import java.io.Serializable;
19  import java.util.Date;
20  import java.util.HashMap;
21  import java.util.Map;
22  
23  import javax.xml.bind.annotation.XmlAccessType;
24  import javax.xml.bind.annotation.XmlAccessorType;
25  import javax.xml.bind.annotation.XmlAttribute;
26  import javax.xml.bind.annotation.XmlElement;
27  import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
28  
29  import org.kuali.student.common.dto.HasAttributes;
30  import org.kuali.student.common.dto.Idable;
31  import org.kuali.student.common.dto.MetaInfo;
32  import org.kuali.student.core.ws.binding.JaxbAttributeMapListAdapter;
33  
34  
35  /**
36   *Detailed information about a single LUI.
37   */ 
38  @XmlAccessorType(XmlAccessType.FIELD)
39  public class LuiInfo implements Serializable, Idable, HasAttributes {
40  
41      private static final long serialVersionUID = 1L;
42  
43      @XmlElement
44      private String luiCode;
45  
46      @XmlElement
47      private String cluId;
48  
49      @XmlElement(name="atpKey")
50      private String atpId;
51  
52      @XmlElement
53      private Integer maxSeats;
54  
55      @XmlElement
56      private Date effectiveDate;
57  
58      @XmlElement
59      private Date expirationDate;
60  
61      @XmlElement
62      @XmlJavaTypeAdapter(JaxbAttributeMapListAdapter.class)
63      private Map<String, String> attributes;
64  
65      @XmlElement
66      private MetaInfo metaInfo;
67  
68      @XmlAttribute
69      private String state;
70  
71      @XmlAttribute
72      private String id;
73  
74      /**
75       * Code identifier/name for the LUI. This is typically used in human readable form (e.g. ENGL 100 section 123).
76       */
77      public String getLuiCode() {
78          return luiCode;
79      }
80  
81      public void setLuiCode(String luiCode) {
82          this.luiCode = luiCode;
83      }
84  
85      /**
86       * Unique identifier for a Canonical Learning Unit (CLU).
87       */
88      public String getCluId() {
89          return cluId;
90      }
91  
92      public void setCluId(String cluId) {
93          this.cluId = cluId;
94      }
95  
96      /**
97       * Unique identifier for an Academic Time Period (ATP).
98       */
99      public String getAtpId() {
100         return atpId;
101     }
102 
103     public void setAtpId(String atpId) {
104         this.atpId = atpId;
105     }
106 
107     /**
108      * Maximum number of "seats" that the LUI will hold for registration.
109      */
110     public Integer getMaxSeats() {
111         return maxSeats;
112     }
113 
114     public void setMaxSeats(Integer maxSeats) {
115         this.maxSeats = maxSeats;
116     }
117 
118     /**
119      * Date and time that this LUI became effective. This is a similar concept to the effective date on enumerated values. When an expiration date has been specified, this field must be less than or equal to the expiration date.
120      */
121     public Date getEffectiveDate() {
122         return effectiveDate;
123     }
124 
125     public void setEffectiveDate(Date effectiveDate) {
126         this.effectiveDate = effectiveDate;
127     }
128 
129     /**
130      * Date and time that this LUI expires. This is a similar concept to the expiration date on enumerated values. If specified, this should be greater than or equal to the effective date. If this field is not specified, then no expiration date has been currently defined and should automatically be considered greater than the effective date.
131      */
132     public Date getExpirationDate() {
133         return expirationDate;
134     }
135 
136     public void setExpirationDate(Date expirationDate) {
137         this.expirationDate = expirationDate;
138     }
139 
140     /**
141      * List of key/value pairs, typically used for dynamic attributes.
142      */
143     public Map<String, String> getAttributes() {
144         if (attributes == null) {
145             attributes = new HashMap<String, String>();
146         }
147         return attributes;
148     }
149 
150     public void setAttributes(Map<String, String> attributes) {
151         this.attributes = attributes;
152     }
153 
154     /**
155      * Create and last update info for the structure. This is optional and treated as read only since the data is set by the internals of the service during maintenance operations.
156      */
157     public MetaInfo getMetaInfo() {
158         return metaInfo;
159     }
160 
161     public void setMetaInfo(MetaInfo metaInfo) {
162         this.metaInfo = metaInfo;
163     }
164 
165     /**
166      * The current status of the LUI. The values for this field are constrained to those in the luState enumeration. A separate setup operation does not exist for retrieval of the meta data around this value.
167      */
168     public String getState() {
169         return state;
170     }
171 
172     public void setState(String state) {
173         this.state = state;
174     }
175 
176     /**
177      * Unique identifier for a Learning Unit Instance (LUI). This is optional, due to the identifier being set at the time of creation. Once the LUI has been created, this should be seen as required.
178      */
179     public String getId() {
180         return id;
181     }
182 
183     public void setId(String id) {
184         this.id = id;
185     }
186 }