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.core.person.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.core.dto.HasAttributes;
30  import org.kuali.student.core.dto.Idable;
31  import org.kuali.student.core.dto.MetaInfo;
32  import org.kuali.student.core.ws.binding.JaxbAttributeMapListAdapter;
33  
34  /**
35   *Detailed information about a person's citizenship.
36   */ 
37  @XmlAccessorType(XmlAccessType.FIELD)
38  public class PersonCitizenshipInfo implements Serializable, Idable, HasAttributes {
39  
40      private static final long serialVersionUID = 1L;
41  
42      @XmlElement
43      private String personId;
44  
45      @XmlElement
46      private String countryOfCitizenshipCode;
47  
48      @XmlElement
49      private String countryOfCitizenshipName;
50  
51      @XmlElement
52      private Date effectiveDate;
53  
54      @XmlElement
55      private Date expirationDate;
56  
57      @XmlElement
58      @XmlJavaTypeAdapter(JaxbAttributeMapListAdapter.class)
59      private Map<String, String> attributes;
60  
61      @XmlElement
62      private MetaInfo metaInfo;
63  
64      @XmlAttribute
65      private String id;
66  
67      /**
68       * Unique identifier for a person record. This is optional, due to the identifier being set at the time of creation of the person. Once the person has been created, this should be seen as required.
69       */
70      public String getPersonId() {
71          return personId;
72      }
73  
74      public void setPersonId(String personId) {
75          this.personId = personId;
76      }
77  
78      /**
79       * Code for the country of citizenship
80       */
81      public String getCountryOfCitizenshipCode() {
82          return countryOfCitizenshipCode;
83      }
84  
85      public void setCountryOfCitizenshipCode(String countryOfCitizenshipCode) {
86          this.countryOfCitizenshipCode = countryOfCitizenshipCode;
87      }
88  
89      /**
90       * Name of country of citizenship
91       */
92      public String getCountryOfCitizenshipName() {
93          return countryOfCitizenshipName;
94      }
95  
96      public void setCountryOfCitizenshipName(String countryOfCitizenshipName) {
97          this.countryOfCitizenshipName = countryOfCitizenshipName;
98      }
99  
100     /**
101      * Date and time that this citizenship 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.
102      */
103     public Date getEffectiveDate() {
104         return effectiveDate;
105     }
106 
107     public void setEffectiveDate(Date effectiveDate) {
108         this.effectiveDate = effectiveDate;
109     }
110 
111     /**
112      * Date and time that this citizenship 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.
113      */
114     public Date getExpirationDate() {
115         return expirationDate;
116     }
117 
118     public void setExpirationDate(Date expirationDate) {
119         this.expirationDate = expirationDate;
120     }
121 
122     /**
123      * List of key/value pairs, typically used for dynamic attributes.
124      */
125     public Map<String, String> getAttributes() {
126         if (attributes == null) {
127             attributes = new HashMap<String, String>();
128         }
129         return attributes;
130     }
131 
132     public void setAttributes(Map<String, String> attributes) {
133         this.attributes = attributes;
134     }
135 
136     /**
137      * 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.
138      */
139     public MetaInfo getMetaInfo() {
140         return metaInfo;
141     }
142 
143     public void setMetaInfo(MetaInfo metaInfo) {
144         this.metaInfo = metaInfo;
145     }
146 
147     /**
148      * Unique identifier for the citizenship record. This is set by the service to be able to determine changes and alterations to the structure as well as provides a handle for searches. This structure is not accessible through unique operations, and it is strongly recommended that no external references to this particular identifier be maintained. Once this identifier is set by the service, it should be seen as required and readonly.
149      */
150     public String getId() {
151         return id;
152     }
153 
154     public void setId(String id) {
155         this.id = id;
156     }
157 }