Coverage Report

 /*
  * Copyright 2007-2009 The Kuali Foundation
  *
  * Licensed under the Educational Community License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  * http://www.opensource.org/licenses/ecl2.php
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 package org.kuali.rice.kim.bo.entity.dto;
 
 import org.kuali.rice.kim.api.entity.citizenship.EntityCitizenship;
 import org.kuali.rice.kim.api.entity.citizenship.EntityCitizenshipContract;
 import org.kuali.rice.kim.api.entity.personal.EntityBioDemographics;
 import org.kuali.rice.kim.api.entity.principal.Principal;
 import org.kuali.rice.kim.api.entity.principal.PrincipalContract;
 import org.kuali.rice.kim.api.entity.privacy.EntityPrivacyPreferences;
 import org.kuali.rice.kim.api.entity.type.EntityTypeData;
 import org.kuali.rice.kim.api.entity.type.EntityTypeDataContract;
 import org.kuali.rice.kim.bo.entity.KimEntity;
 import org.kuali.rice.kim.bo.entity.KimEntityAffiliation;
 import org.kuali.rice.kim.bo.entity.KimEntityEmploymentInformation;
 import org.kuali.rice.kim.bo.entity.KimEntityEthnicity;
 import org.kuali.rice.kim.bo.entity.KimEntityExternalIdentifier;
 import org.kuali.rice.kim.bo.entity.KimEntityName;
 import org.kuali.rice.kim.bo.entity.KimEntityResidency;
 import org.kuali.rice.kim.bo.entity.KimEntityVisa;
 
 
 import java.util.ArrayList;
 import java.util.List;
 
 /**
  * This is a data transfer object containing all information related to a KIM
  * entity.
  * 
  * @author Kuali Rice Team (kuali-rice@googlegroups.com)
  */
 public class KimEntityInfo extends KimInactivatableInfo implements KimEntity {
 
     private static final long serialVersionUID = 1L;
 
     private List<KimEntityAffiliationInfo> affiliations;
     private EntityBioDemographics bioDemographics;
     private List<EntityCitizenship> citizenships;
     private List<KimEntityEmploymentInformationInfo> employmentInformation;
     private String entityId;
     private List<EntityTypeData> entityTypes;
     private List<KimEntityExternalIdentifierInfo> externalIdentifiers;
     private List<KimEntityNameInfo> names;
     private List<Principal> principals;
     private EntityPrivacyPreferences privacyPreferences;
     private List<KimEntityEthnicityInfo> ethnicities;
     private List<KimEntityResidencyInfo> residencies;
     private List<KimEntityVisaInfo> visas;
 
     /**
      * This constructs an empty KimEntityInfo
      */
     public KimEntityInfo() {
         super();
         active = true;
     }
 
     /**
      * This constructs a KimEntityInfo derived from the {@link KimEntity} passed in.
      * 
      * @param entity the {@link KimEntity} that this KimEntityInfo is derived from.  If null, then an empty 
      * KimEntityInfo will be constructed.
      */
     public KimEntityInfo(KimEntity entity) {
         this();
 
         if (entity != null) {
 
             entityId = entity.getEntityId();
             active = entity.isActive();
 
             // See comments by utility method deriveCollection for why this is used.  
             // Essentially, the constructor was too darned long.
 
             principals = new ArrayList<Principal>();
             for (PrincipalContract contract : entity.getPrincipals()) {
                 principals.add(Principal.Builder.create(contract).build());
             }
 
             if (entity.getBioDemographics() != null) {
                 bioDemographics = EntityBioDemographics.Builder.create(entity.getBioDemographics()).build();
             }
 
             if (entity.getPrivacyPreferences() != null) {
                 privacyPreferences = EntityPrivacyPreferences.Builder.create(entity.getPrivacyPreferences()).build();
             }
 
             names = deriveCollection(entity.getNames(), new XForm<KimEntityName, KimEntityNameInfo>() {
                 public KimEntityNameInfo xform(KimEntityName source) {
                     return new KimEntityNameInfo(source);
                 } 
             });
 
             entityTypes = new ArrayList<EntityTypeData>();
             for (EntityTypeDataContract contract : entity.getEntityTypes()) {
                 entityTypes.add(EntityTypeData.Builder.create(contract).build());
             }
 
             affiliations = deriveCollection(entity.getAffiliations(), new XForm<KimEntityAffiliation, KimEntityAffiliationInfo>() {
                 public KimEntityAffiliationInfo xform(KimEntityAffiliation source) {
                     return new KimEntityAffiliationInfo(source);
                 }
             });
 
             employmentInformation = deriveCollection(entity.getEmploymentInformation(), 
                     new XForm<KimEntityEmploymentInformation, KimEntityEmploymentInformationInfo>() {
                 public KimEntityEmploymentInformationInfo xform(KimEntityEmploymentInformation source) {
                     return new KimEntityEmploymentInformationInfo(source);
                 }
             });
 
             externalIdentifiers = deriveCollection(entity.getExternalIdentifiers(), 
                     new XForm<KimEntityExternalIdentifier, KimEntityExternalIdentifierInfo>() {
                 public KimEntityExternalIdentifierInfo xform(KimEntityExternalIdentifier source) {
                     return new KimEntityExternalIdentifierInfo(source); 
                 }
             });        
 
             citizenships = new ArrayList<EntityCitizenship>();
             for (EntityCitizenshipContract contract : entity.getCitizenships()) {
                 citizenships.add(EntityCitizenship.Builder.create(contract).build());
             }
 
             ethnicities = deriveCollection(entity.getEthnicities(), new XForm<KimEntityEthnicity, KimEntityEthnicityInfo>() {
                 public KimEntityEthnicityInfo xform(KimEntityEthnicity source) {
                     return new KimEntityEthnicityInfo(source);
                 }
             });
 
             residencies = deriveCollection(entity.getResidencies(), new XForm<KimEntityResidency, KimEntityResidencyInfo>() {
                 public KimEntityResidencyInfo xform(KimEntityResidency source) {
                     return new KimEntityResidencyInfo(source);
                 }
             });
 
             visas = deriveCollection(entity.getVisas(), new XForm<KimEntityVisa, KimEntityVisaInfo>() {
                 public KimEntityVisaInfo xform(KimEntityVisa source) {
                     return new KimEntityVisaInfo(source);
                 }
             });
         }
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getAffiliations()
      */
     public List<KimEntityAffiliationInfo> getAffiliations() {
         // If our reference is null, assign and return an empty List
         return (affiliations != null) ? affiliations : (affiliations = new ArrayList<KimEntityAffiliationInfo>());
 
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s affiliations.  Note the behavior of {@link #getAffiliations()} if
      * this is set to null;
      */
     public void setAffiliations(List<KimEntityAffiliationInfo> affiliations) {
         this.affiliations = affiliations;
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getDefaultAffiliation()
      */
     public KimEntityAffiliationInfo getDefaultAffiliation() {
         KimEntityAffiliationInfo result = null;
         if (affiliations != null)
             for (KimEntityAffiliationInfo affiliation : affiliations) {
                 if (result == null) {
                     result = affiliation;
                 }
                 if (affiliation.isDefaultValue()) {
                     result = affiliation;
                     break;
                 }
             }
         return result;
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getBioDemographics()
      */
     public EntityBioDemographics getBioDemographics() {
         return bioDemographics;
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s demographic information.  Note the behavior of 
      * {@link #getBioDemographics()} if this is set to null;
      */
     public void setBioDemographics(EntityBioDemographics bioDemographics) {
         this.bioDemographics = bioDemographics;
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getCitizenships()
      */
     public List<EntityCitizenship> getCitizenships() {
         // If our reference is null, assign and return an empty List
         return (citizenships != null) ? citizenships : (citizenships = new ArrayList<EntityCitizenship>());
 
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s demographic information.  Note the behavior of 
      * {@link #getCitizenships()} if this is set to null;
      */
     public void setCitizenships(List<EntityCitizenship> citizenships) {
         this.citizenships = citizenships;
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getEmploymentInformation()
      */
     public List<KimEntityEmploymentInformationInfo> getEmploymentInformation() {
         // If our reference is null, assign and return an empty List
         return (employmentInformation != null) ? employmentInformation
                 : (employmentInformation = new ArrayList<KimEntityEmploymentInformationInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s employment information.  Note the behavior of 
      * {@link #getEmploymentInformation()} if this is set to null;
      */
     public void setEmploymentInformation(List<KimEntityEmploymentInformationInfo> employmentInformation) {
         this.employmentInformation = employmentInformation;
     }
 
     /** 
      * {@inheritDoc}
      * @see KimEntity#getPrimaryEmployment()
      */
     public KimEntityEmploymentInformationInfo getPrimaryEmployment() {
         KimEntityEmploymentInformationInfo result = null;
         if (employmentInformation != null)
             for (KimEntityEmploymentInformationInfo employment : employmentInformation) {
                 if (employment.isPrimary()) {
                     result = employment;
                 }
             }
         return result;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getEntityId()
      */
     public String getEntityId() {
         return entityId;
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s entity id.  Note the behavior of 
      * {@link #getEntityId()} if this is set to null;
      */
     public void setEntityId(String entityId) {
         this.entityId = entityId;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getEntityTypes()
      */
     public List<EntityTypeData> getEntityTypes() {
         // If our reference is null, assign and return an empty List
         return (entityTypes != null) ? entityTypes : (entityTypes = new ArrayList<EntityTypeData>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s entity types.  Note the behavior of 
      * {@link #getEntityTypes()} if this is set to null;
      */
     public void setEntityTypes(List<EntityTypeData> entityTypes) {
         this.entityTypes = entityTypes;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getExternalIdentifiers()
      */
     public List<KimEntityExternalIdentifierInfo> getExternalIdentifiers() {
         // If our reference is null, assign and return an empty List
         return (externalIdentifiers != null) ? externalIdentifiers
                 : (externalIdentifiers = new ArrayList<KimEntityExternalIdentifierInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s external identifiers.  Note the behavior of 
      * {@link #getExternalIdentifiers()} if this is set to null;
      */
     public void setExternalIdentifiers(List<KimEntityExternalIdentifierInfo> externalIdentifiers) {
         this.externalIdentifiers = externalIdentifiers;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getNames()
      */
     public List<KimEntityNameInfo> getNames() {
         // If our reference is null, assign and return an empty List
         return (names != null) ? names : (names = new ArrayList<KimEntityNameInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s names.  Note the behavior of 
      * {@link #getNames()} if this is set to null;
      */
     public void setNames(List<KimEntityNameInfo> names) {
         this.names = names;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getDefaultName()
      */
     public KimEntityNameInfo getDefaultName() {
         KimEntityNameInfo result = null;
         for (KimEntityNameInfo name : this.getNames()) {
             if (result == null) {
                 result = name;
             }
             if (name.isDefaultValue()) {
                 result = name;
                 break;
             }
         }
         return result;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getPrincipals()
      */
     public List<Principal> getPrincipals() {
         // If our reference is null, assign and return an empty List
         return (principals != null) ? principals : (principals = new ArrayList<Principal>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s principals.  Note the behavior of 
      * {@link #getPrincipals()} if this is set to null;
      */
     public void setPrincipals(List<Principal> principals) {
         this.principals = principals;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getPrivacyPreferences()
      */
     public EntityPrivacyPreferences getPrivacyPreferences() {
         return privacyPreferences;
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s privacy preferences.  Note the behavior of 
      * {@link #getPrivacyPreferences()} if this is set to null;
      */
     public void setPrivacyPreferences(EntityPrivacyPreferences privacyPreferences) {
         this.privacyPreferences = privacyPreferences;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getEthnicities()
      */
     public List<KimEntityEthnicityInfo> getEthnicities() {
         // If our reference is null, assign and return an empty List
         return (ethnicities != null) ? ethnicities : (ethnicities = new ArrayList<KimEntityEthnicityInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s ethnicities.  Note the behavior of 
      * {@link #getEthnicities()} if this is set to null;
      */
     public void setEthnicities(List<KimEntityEthnicityInfo> ethnicities) {
         this.ethnicities = ethnicities;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getResidencies()
      */
     public List<KimEntityResidencyInfo> getResidencies() {
         // If our reference is null, assign and return an empty List
         return (residencies != null) ? residencies : (residencies = new ArrayList<KimEntityResidencyInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s residencies.  Note the behavior of 
      * {@link #getResidencies()} if this is set to null;
      */
     public void setResidencies(List<KimEntityResidencyInfo> residencies) {
         this.residencies = residencies;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getVisas()
      */
     public List<KimEntityVisaInfo> getVisas() {
         // If our reference is null, assign and return an empty List
         return (visas != null) ? visas : (visas = new ArrayList<KimEntityVisaInfo>());
     }
 
     /** 
      * Setter for this {@link KimEntityInfo}'s visas.  Note the behavior of 
      * {@link #getVisas()} if this is set to null;
      */
     public void setVisas(List<KimEntityVisaInfo> visas) {
         this.visas = visas;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getEntityExternalIdentifier(String)
      */
     public KimEntityExternalIdentifier getEntityExternalIdentifier(String externalIdentifierTypeCode) {
         KimEntityExternalIdentifier result = null;
 
         List<KimEntityExternalIdentifierInfo> externalIdentifiers = getExternalIdentifiers();
         if (externalIdentifiers != null)
             for (KimEntityExternalIdentifier eid : externalIdentifiers) {
                 if (eid.getExternalIdentifierTypeCode().equals(externalIdentifierTypeCode)) {
                     result = eid;
                 }
             }
         return result;
     }
 
     /**
      * {@inheritDoc}
      * @see KimEntity#getEntityType(String)
      */
     public EntityTypeData getEntityType(String entityTypeCode) {
         EntityTypeData result = null;
 
         if (entityTypes != null)
             for (EntityTypeData eType : entityTypes) {
                 if (eType.getEntityTypeCode().equals(entityTypeCode)) {
                     result = eType;
                 }
             }
         return result;
     }
     
     /*
         // utility method converts this monstrous block:
         
         if (entity.getEntityTypes() != null) {
             entityTypes = new ArrayList<KimEntityEntityTypeInfo>(entity.getEntityTypes().size());
 
             for (KimEntityEntityType entityEntityType : entity.getEntityTypes()) if (entityEntityType != null) {
                 entityTypes.add(new KimEntityEntityTypeInfo(entityEntityType));
             }
         } else {
             entityTypes = new ArrayList<KimEntityEntityTypeInfo>();
         }
         
         // to this:
         
         entityTypes = deriveCollection(entity.getEntityTypes(), new XForm<KimEntityEntityType, KimEntityEntityTypeInfo>() {
             public KimEntityEntityTypeInfo xform(KimEntityEntityType source) {
                 return new KimEntityEntityTypeInfo(source);
             }
         });
      
         // Note that generic type C is required because some of the source collections use wildcards
      */
     private static <A,B,C> List<B> deriveCollection(List<A> source, XForm<C,B> transformer) {
         List<B> result = null;
         if (source != null) {
             result = new ArrayList<B>(source.size());
             
             for (A element : source) if (element != null) {
                 B mutant = transformer.xform((C)element);
                 if (mutant != null) {
                     result.add(mutant);
                 }
             }
         } else {
             result = new ArrayList();
         }
         return result;
     }
     
     private static interface XForm<A,B> {
         public B xform(A source);
     }
 
 }

1		/*
2		* Copyright 2007-2009 The Kuali Foundation
3		*
4		* Licensed under the Educational Community License, Version 2.0 (the "License");
5		* you may not use this file except in compliance with the License.
6		* You may obtain a copy of the License at
7		*
8		* http://www.opensource.org/licenses/ecl2.php
9		*
10		* Unless required by applicable law or agreed to in writing, software
11		* distributed under the License is distributed on an "AS IS" BASIS,
12		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13		* See the License for the specific language governing permissions and
14		* limitations under the License.
15		*/
16		package org.kuali.rice.kim.bo.entity.dto;
17
18		import org.kuali.rice.kim.api.entity.citizenship.EntityCitizenship;
19		import org.kuali.rice.kim.api.entity.citizenship.EntityCitizenshipContract;
20		import org.kuali.rice.kim.api.entity.personal.EntityBioDemographics;
21		import org.kuali.rice.kim.api.entity.principal.Principal;
22		import org.kuali.rice.kim.api.entity.principal.PrincipalContract;
23		import org.kuali.rice.kim.api.entity.privacy.EntityPrivacyPreferences;
24		import org.kuali.rice.kim.api.entity.type.EntityTypeData;
25		import org.kuali.rice.kim.api.entity.type.EntityTypeDataContract;
26		import org.kuali.rice.kim.bo.entity.KimEntity;
27		import org.kuali.rice.kim.bo.entity.KimEntityAffiliation;
28		import org.kuali.rice.kim.bo.entity.KimEntityEmploymentInformation;
29		import org.kuali.rice.kim.bo.entity.KimEntityEthnicity;
30		import org.kuali.rice.kim.bo.entity.KimEntityExternalIdentifier;
31		import org.kuali.rice.kim.bo.entity.KimEntityName;
32		import org.kuali.rice.kim.bo.entity.KimEntityResidency;
33		import org.kuali.rice.kim.bo.entity.KimEntityVisa;
34
35
36		import java.util.ArrayList;
37		import java.util.List;
38
39		/**
40		* This is a data transfer object containing all information related to a KIM
41		* entity.
42		*
43		* @author Kuali Rice Team (kuali-rice@googlegroups.com)
44		*/
45	0	public class KimEntityInfo extends KimInactivatableInfo implements KimEntity {
46
47		private static final long serialVersionUID = 1L;
48
49		private List<KimEntityAffiliationInfo> affiliations;
50		private EntityBioDemographics bioDemographics;
51		private List<EntityCitizenship> citizenships;
52		private List<KimEntityEmploymentInformationInfo> employmentInformation;
53		private String entityId;
54		private List<EntityTypeData> entityTypes;
55		private List<KimEntityExternalIdentifierInfo> externalIdentifiers;
56		private List<KimEntityNameInfo> names;
57		private List<Principal> principals;
58		private EntityPrivacyPreferences privacyPreferences;
59		private List<KimEntityEthnicityInfo> ethnicities;
60		private List<KimEntityResidencyInfo> residencies;
61		private List<KimEntityVisaInfo> visas;
62
63		/**
64		* This constructs an empty KimEntityInfo
65		*/
66		public KimEntityInfo() {
67	0	super();
68	0	active = true;
69	0	}
70
71		/**
72		* This constructs a KimEntityInfo derived from the {@link KimEntity} passed in.
73		*
74		* @param entity the {@link KimEntity} that this KimEntityInfo is derived from. If null, then an empty
75		* KimEntityInfo will be constructed.
76		*/
77		public KimEntityInfo(KimEntity entity) {
78	0	this();
79
80	0	if (entity != null) {
81
82	0	entityId = entity.getEntityId();
83	0	active = entity.isActive();
84
85		// See comments by utility method deriveCollection for why this is used.
86		// Essentially, the constructor was too darned long.
87
88	0	principals = new ArrayList<Principal>();
89	0	for (PrincipalContract contract : entity.getPrincipals()) {
90	0	principals.add(Principal.Builder.create(contract).build());
91		}
92
93	0	if (entity.getBioDemographics() != null) {
94	0	bioDemographics = EntityBioDemographics.Builder.create(entity.getBioDemographics()).build();
95		}
96
97	0	if (entity.getPrivacyPreferences() != null) {
98	0	privacyPreferences = EntityPrivacyPreferences.Builder.create(entity.getPrivacyPreferences()).build();
99		}
100
101	0	names = deriveCollection(entity.getNames(), new XForm<KimEntityName, KimEntityNameInfo>() {
102		public KimEntityNameInfo xform(KimEntityName source) {
103	0	return new KimEntityNameInfo(source);
104		}
105		});
106
107	0	entityTypes = new ArrayList<EntityTypeData>();
108	0	for (EntityTypeDataContract contract : entity.getEntityTypes()) {
109	0	entityTypes.add(EntityTypeData.Builder.create(contract).build());
110		}
111
112	0	affiliations = deriveCollection(entity.getAffiliations(), new XForm<KimEntityAffiliation, KimEntityAffiliationInfo>() {
113		public KimEntityAffiliationInfo xform(KimEntityAffiliation source) {
114	0	return new KimEntityAffiliationInfo(source);
115		}
116		});
117
118	0	employmentInformation = deriveCollection(entity.getEmploymentInformation(),
119	0	new XForm<KimEntityEmploymentInformation, KimEntityEmploymentInformationInfo>() {
120		public KimEntityEmploymentInformationInfo xform(KimEntityEmploymentInformation source) {
121	0	return new KimEntityEmploymentInformationInfo(source);
122		}
123		});
124
125	0	externalIdentifiers = deriveCollection(entity.getExternalIdentifiers(),
126	0	new XForm<KimEntityExternalIdentifier, KimEntityExternalIdentifierInfo>() {
127		public KimEntityExternalIdentifierInfo xform(KimEntityExternalIdentifier source) {
128	0	return new KimEntityExternalIdentifierInfo(source);
129		}
130		});
131
132	0	citizenships = new ArrayList<EntityCitizenship>();
133	0	for (EntityCitizenshipContract contract : entity.getCitizenships()) {
134	0	citizenships.add(EntityCitizenship.Builder.create(contract).build());
135		}
136
137	0	ethnicities = deriveCollection(entity.getEthnicities(), new XForm<KimEntityEthnicity, KimEntityEthnicityInfo>() {
138		public KimEntityEthnicityInfo xform(KimEntityEthnicity source) {
139	0	return new KimEntityEthnicityInfo(source);
140		}
141		});
142
143	0	residencies = deriveCollection(entity.getResidencies(), new XForm<KimEntityResidency, KimEntityResidencyInfo>() {
144		public KimEntityResidencyInfo xform(KimEntityResidency source) {
145	0	return new KimEntityResidencyInfo(source);
146		}
147		});
148
149	0	visas = deriveCollection(entity.getVisas(), new XForm<KimEntityVisa, KimEntityVisaInfo>() {
150		public KimEntityVisaInfo xform(KimEntityVisa source) {
151	0	return new KimEntityVisaInfo(source);
152		}
153		});
154		}
155	0	}
156
157		/**
158		* {@inheritDoc}
159		* @see KimEntity#getAffiliations()
160		*/
161		public List<KimEntityAffiliationInfo> getAffiliations() {
162		// If our reference is null, assign and return an empty List
163	0	return (affiliations != null) ? affiliations : (affiliations = new ArrayList<KimEntityAffiliationInfo>());
164
165		}
166
167		/**
168		* Setter for this {@link KimEntityInfo}'s affiliations. Note the behavior of {@link #getAffiliations()} if
169		* this is set to null;
170		*/
171		public void setAffiliations(List<KimEntityAffiliationInfo> affiliations) {
172	0	this.affiliations = affiliations;
173	0	}
174
175		/**
176		* {@inheritDoc}
177		* @see KimEntity#getDefaultAffiliation()
178		*/
179		public KimEntityAffiliationInfo getDefaultAffiliation() {
180	0	KimEntityAffiliationInfo result = null;
181	0	if (affiliations != null)
182	0	for (KimEntityAffiliationInfo affiliation : affiliations) {
183	0	if (result == null) {
184	0	result = affiliation;
185		}
186	0	if (affiliation.isDefaultValue()) {
187	0	result = affiliation;
188	0	break;
189		}
190		}
191	0	return result;
192		}
193
194		/**
195		* {@inheritDoc}
196		* @see KimEntity#getBioDemographics()
197		*/
198		public EntityBioDemographics getBioDemographics() {
199	0	return bioDemographics;
200		}
201
202		/**
203		* Setter for this {@link KimEntityInfo}'s demographic information. Note the behavior of
204		* {@link #getBioDemographics()} if this is set to null;
205		*/
206		public void setBioDemographics(EntityBioDemographics bioDemographics) {
207	0	this.bioDemographics = bioDemographics;
208	0	}
209
210		/**
211		* {@inheritDoc}
212		* @see KimEntity#getCitizenships()
213		*/
214		public List<EntityCitizenship> getCitizenships() {
215		// If our reference is null, assign and return an empty List
216	0	return (citizenships != null) ? citizenships : (citizenships = new ArrayList<EntityCitizenship>());
217
218		}
219
220		/**
221		* Setter for this {@link KimEntityInfo}'s demographic information. Note the behavior of
222		* {@link #getCitizenships()} if this is set to null;
223		*/
224		public void setCitizenships(List<EntityCitizenship> citizenships) {
225	0	this.citizenships = citizenships;
226	0	}
227
228		/**
229		* {@inheritDoc}
230		* @see KimEntity#getEmploymentInformation()
231		*/
232		public List<KimEntityEmploymentInformationInfo> getEmploymentInformation() {
233		// If our reference is null, assign and return an empty List
234	0	return (employmentInformation != null) ? employmentInformation
235		: (employmentInformation = new ArrayList<KimEntityEmploymentInformationInfo>());
236		}
237
238		/**
239		* Setter for this {@link KimEntityInfo}'s employment information. Note the behavior of
240		* {@link #getEmploymentInformation()} if this is set to null;
241		*/
242		public void setEmploymentInformation(List<KimEntityEmploymentInformationInfo> employmentInformation) {
243	0	this.employmentInformation = employmentInformation;
244	0	}
245
246		/**
247		* {@inheritDoc}
248		* @see KimEntity#getPrimaryEmployment()
249		*/
250		public KimEntityEmploymentInformationInfo getPrimaryEmployment() {
251	0	KimEntityEmploymentInformationInfo result = null;
252	0	if (employmentInformation != null)
253	0	for (KimEntityEmploymentInformationInfo employment : employmentInformation) {
254	0	if (employment.isPrimary()) {
255	0	result = employment;
256		}
257		}
258	0	return result;
259		}
260
261		/**
262		* {@inheritDoc}
263		* @see KimEntity#getEntityId()
264		*/
265		public String getEntityId() {
266	0	return entityId;
267		}
268
269		/**
270		* Setter for this {@link KimEntityInfo}'s entity id. Note the behavior of
271		* {@link #getEntityId()} if this is set to null;
272		*/
273		public void setEntityId(String entityId) {
274	0	this.entityId = entityId;
275	0	}
276
277		/**
278		* {@inheritDoc}
279		* @see KimEntity#getEntityTypes()
280		*/
281		public List<EntityTypeData> getEntityTypes() {
282		// If our reference is null, assign and return an empty List
283	0	return (entityTypes != null) ? entityTypes : (entityTypes = new ArrayList<EntityTypeData>());
284		}
285
286		/**
287		* Setter for this {@link KimEntityInfo}'s entity types. Note the behavior of
288		* {@link #getEntityTypes()} if this is set to null;
289		*/
290		public void setEntityTypes(List<EntityTypeData> entityTypes) {
291	0	this.entityTypes = entityTypes;
292	0	}
293
294		/**
295		* {@inheritDoc}
296		* @see KimEntity#getExternalIdentifiers()
297		*/
298		public List<KimEntityExternalIdentifierInfo> getExternalIdentifiers() {
299		// If our reference is null, assign and return an empty List
300	0	return (externalIdentifiers != null) ? externalIdentifiers
301		: (externalIdentifiers = new ArrayList<KimEntityExternalIdentifierInfo>());
302		}
303
304		/**
305		* Setter for this {@link KimEntityInfo}'s external identifiers. Note the behavior of
306		* {@link #getExternalIdentifiers()} if this is set to null;
307		*/
308		public void setExternalIdentifiers(List<KimEntityExternalIdentifierInfo> externalIdentifiers) {
309	0	this.externalIdentifiers = externalIdentifiers;
310	0	}
311
312		/**
313		* {@inheritDoc}
314		* @see KimEntity#getNames()
315		*/
316		public List<KimEntityNameInfo> getNames() {
317		// If our reference is null, assign and return an empty List
318	0	return (names != null) ? names : (names = new ArrayList<KimEntityNameInfo>());
319		}
320
321		/**
322		* Setter for this {@link KimEntityInfo}'s names. Note the behavior of
323		* {@link #getNames()} if this is set to null;
324		*/
325		public void setNames(List<KimEntityNameInfo> names) {
326	0	this.names = names;
327	0	}
328
329		/**
330		* {@inheritDoc}
331		* @see KimEntity#getDefaultName()
332		*/
333		public KimEntityNameInfo getDefaultName() {
334	0	KimEntityNameInfo result = null;
335	0	for (KimEntityNameInfo name : this.getNames()) {
336	0	if (result == null) {
337	0	result = name;
338		}
339	0	if (name.isDefaultValue()) {
340	0	result = name;
341	0	break;
342		}
343		}
344	0	return result;
345		}
346
347		/**
348		* {@inheritDoc}
349		* @see KimEntity#getPrincipals()
350		*/
351		public List<Principal> getPrincipals() {
352		// If our reference is null, assign and return an empty List
353	0	return (principals != null) ? principals : (principals = new ArrayList<Principal>());
354		}
355
356		/**
357		* Setter for this {@link KimEntityInfo}'s principals. Note the behavior of
358		* {@link #getPrincipals()} if this is set to null;
359		*/
360		public void setPrincipals(List<Principal> principals) {
361	0	this.principals = principals;
362	0	}
363
364		/**
365		* {@inheritDoc}
366		* @see KimEntity#getPrivacyPreferences()
367		*/
368		public EntityPrivacyPreferences getPrivacyPreferences() {
369	0	return privacyPreferences;
370		}
371
372		/**
373		* Setter for this {@link KimEntityInfo}'s privacy preferences. Note the behavior of
374		* {@link #getPrivacyPreferences()} if this is set to null;
375		*/
376		public void setPrivacyPreferences(EntityPrivacyPreferences privacyPreferences) {
377	0	this.privacyPreferences = privacyPreferences;
378	0	}
379
380		/**
381		* {@inheritDoc}
382		* @see KimEntity#getEthnicities()
383		*/
384		public List<KimEntityEthnicityInfo> getEthnicities() {
385		// If our reference is null, assign and return an empty List
386	0	return (ethnicities != null) ? ethnicities : (ethnicities = new ArrayList<KimEntityEthnicityInfo>());
387		}
388
389		/**
390		* Setter for this {@link KimEntityInfo}'s ethnicities. Note the behavior of
391		* {@link #getEthnicities()} if this is set to null;
392		*/
393		public void setEthnicities(List<KimEntityEthnicityInfo> ethnicities) {
394	0	this.ethnicities = ethnicities;
395	0	}
396
397		/**
398		* {@inheritDoc}
399		* @see KimEntity#getResidencies()
400		*/
401		public List<KimEntityResidencyInfo> getResidencies() {
402		// If our reference is null, assign and return an empty List
403	0	return (residencies != null) ? residencies : (residencies = new ArrayList<KimEntityResidencyInfo>());
404		}
405
406		/**
407		* Setter for this {@link KimEntityInfo}'s residencies. Note the behavior of
408		* {@link #getResidencies()} if this is set to null;
409		*/
410		public void setResidencies(List<KimEntityResidencyInfo> residencies) {
411	0	this.residencies = residencies;
412	0	}
413
414		/**
415		* {@inheritDoc}
416		* @see KimEntity#getVisas()
417		*/
418		public List<KimEntityVisaInfo> getVisas() {
419		// If our reference is null, assign and return an empty List
420	0	return (visas != null) ? visas : (visas = new ArrayList<KimEntityVisaInfo>());
421		}
422
423		/**
424		* Setter for this {@link KimEntityInfo}'s visas. Note the behavior of
425		* {@link #getVisas()} if this is set to null;
426		*/
427		public void setVisas(List<KimEntityVisaInfo> visas) {
428	0	this.visas = visas;
429	0	}
430
431		/**
432		* {@inheritDoc}
433		* @see KimEntity#getEntityExternalIdentifier(String)
434		*/
435		public KimEntityExternalIdentifier getEntityExternalIdentifier(String externalIdentifierTypeCode) {
436	0	KimEntityExternalIdentifier result = null;
437
438	0	List<KimEntityExternalIdentifierInfo> externalIdentifiers = getExternalIdentifiers();
439	0	if (externalIdentifiers != null)
440	0	for (KimEntityExternalIdentifier eid : externalIdentifiers) {
441	0	if (eid.getExternalIdentifierTypeCode().equals(externalIdentifierTypeCode)) {
442	0	result = eid;
443		}
444		}
445	0	return result;
446		}
447
448		/**
449		* {@inheritDoc}
450		* @see KimEntity#getEntityType(String)
451		*/
452		public EntityTypeData getEntityType(String entityTypeCode) {
453	0	EntityTypeData result = null;
454
455	0	if (entityTypes != null)
456	0	for (EntityTypeData eType : entityTypes) {
457	0	if (eType.getEntityTypeCode().equals(entityTypeCode)) {
458	0	result = eType;
459		}
460		}
461	0	return result;
462		}
463
464		/*
465		// utility method converts this monstrous block:
466
467		if (entity.getEntityTypes() != null) {
468		entityTypes = new ArrayList<KimEntityEntityTypeInfo>(entity.getEntityTypes().size());
469
470		for (KimEntityEntityType entityEntityType : entity.getEntityTypes()) if (entityEntityType != null) {
471		entityTypes.add(new KimEntityEntityTypeInfo(entityEntityType));
472		}
473		} else {
474		entityTypes = new ArrayList<KimEntityEntityTypeInfo>();
475		}
476
477		// to this:
478
479		entityTypes = deriveCollection(entity.getEntityTypes(), new XForm<KimEntityEntityType, KimEntityEntityTypeInfo>() {
480		public KimEntityEntityTypeInfo xform(KimEntityEntityType source) {
481		return new KimEntityEntityTypeInfo(source);
482		}
483		});
484
485		// Note that generic type C is required because some of the source collections use wildcards
486		*/
487		private static <A,B,C> List<B> deriveCollection(List<A> source, XForm<C,B> transformer) {
488	0	List<B> result = null;
489	0	if (source != null) {
490	0	result = new ArrayList<B>(source.size());
491
492	0	for (A element : source) if (element != null) {
493	0	B mutant = transformer.xform((C)element);
494	0	if (mutant != null) {
495	0	result.add(mutant);
496		}
497	0	}
498		} else {
499	0	result = new ArrayList();
500		}
501	0	return result;
502		}
503
504		private static interface XForm<A,B> {
505		public B xform(A source);
506		}
507
508		}