* The contents of this file are subject to the Mozilla Public License Version 1.1
* See LICENSE.TXT at the top of this package for the full license terms.
*/
-
package eu.etaxonomy.cdm.model.agent;
import java.io.Serializable;
+import java.net.URI;
import java.util.ArrayList;
+import java.util.Collection;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import javax.persistence.Embeddable;
import javax.persistence.FetchType;
import javax.persistence.OneToMany;
+import javax.persistence.Transient;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlSchemaType;
import javax.xml.bind.annotation.XmlType;
-import org.apache.commons.lang.StringUtils;
+import org.apache.commons.lang3.StringUtils;
import org.apache.log4j.Logger;
import org.hibernate.annotations.Cascade;
import org.hibernate.annotations.CascadeType;
import org.hibernate.envers.Audited;
+import eu.etaxonomy.cdm.model.location.Country;
import eu.etaxonomy.cdm.model.location.Point;
-import eu.etaxonomy.cdm.model.location.WaterbodyOrCountry;
import eu.etaxonomy.cdm.strategy.merge.MergeException;
/**
* </ul>
*
* @author m.doering
- * @version 1.0
- * @created 08-Nov-2007 13:06:18
+ * @since 08-Nov-2007 13:06:18
*/
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "Contact", propOrder = {
private static final Logger logger = Logger.getLogger(Contact.class);
+ @XmlElementWrapper(name = "EmailAddresses", nillable = true)
+ @XmlElement(name = "EmailAddress")
+ @ElementCollection(fetch = FetchType.LAZY)
+ @Column(name = "contact_emailaddresses_element")
+ private List<String> emailAddresses = new ArrayList<>();
+
+ @XmlElementWrapper(name = "URLs", nillable = true)
+ @XmlElement(name = "URL")
+ @XmlSchemaType(name = "anyURI")
+ @ElementCollection(fetch = FetchType.LAZY)
+ @Column(name = "contact_urls_element" /*, length=330 */) //length >255 does not work in InnoDB AUD tables for Key length of (REV, id, url) key
+ private final List<String> urls = new ArrayList<>();
+
+ @XmlElementWrapper(name = "PhoneNumbers", nillable = true)
+ @XmlElement(name = "PhoneNumber")
+ @ElementCollection(fetch = FetchType.LAZY)
+ @Column(name = "contact_phonenumbers_element")
+ @Cascade({CascadeType.SAVE_UPDATE, CascadeType.MERGE, CascadeType.DELETE})
+ private List<String> phoneNumbers = new ArrayList<>();
+
+ @XmlElementWrapper(name = "FaxNumbers", nillable = true)
+ @XmlElement(name = "FaxNumber")
+ @ElementCollection(fetch = FetchType.LAZY)
+ @Column(name = "contact_faxnumbers_element")
+ private List<String> faxNumbers = new ArrayList<>();
+
+ @XmlElementWrapper(name = "Addresses", nillable = true)
+ @XmlElement(name = "Address")
+ @OneToMany(fetch = FetchType.LAZY, orphanRemoval=true)
+ @Cascade({CascadeType.SAVE_UPDATE, CascadeType.MERGE})
+ protected Set<Address> addresses = new HashSet<>();
+
public static Contact NewInstance() {
return new Contact();
}
* @return
*/
public static Contact NewInstance(String street, String postcode, String locality,
- WaterbodyOrCountry country, String pobox, String region,
- String email, String faxNumber, String phoneNumber, String url, Point location) {
+ Country country, String pobox, String region,
+ String email, String faxNumber, String phoneNumber, URI url, Point location) {
Contact result = new Contact();
if (country != null || StringUtils.isNotBlank(locality) || StringUtils.isNotBlank(pobox) || StringUtils.isNotBlank(postcode) ||
StringUtils.isNotBlank(region) || StringUtils.isNotBlank(street) ){
}
- public static Contact NewInstance(Set<Address> addresses, List<String> emailAdresses,
- List<String> faxNumbers, List<String> phoneNumbers, List<String> urls) {
+ public static Contact NewInstance(Set<Address> addresses, List<String> emailAddresses,
+ List<String> faxNumbers, List<String> phoneNumbers, List<URI> urls) {
Contact result = new Contact();
if (addresses != null){
result.addresses = addresses;
}
- if (emailAdresses != null){
- result.emailAddresses = emailAdresses;
+ if (emailAddresses != null){
+ result.emailAddresses = emailAddresses;
}
if (faxNumbers != null){
result.faxNumbers = faxNumbers;
result.phoneNumbers = phoneNumbers;
}
if (urls != null){
- result.urls = urls;
+ for (URI uri : urls){
+ result.urls.add(uri.toString());
+ }
}
return result;
}
-
+// ************************ CONSTRUCTOR **************************/
/**
* Class constructor.
*/
public Contact() {
}
- @XmlElementWrapper(name = "EmailAddresses", nillable = true)
- @XmlElement(name = "EmailAddress")
- @ElementCollection(fetch = FetchType.LAZY)
- @Column(name = "contact_emailaddresses_element")
- private List<String> emailAddresses;
-
- @XmlElementWrapper(name = "URLs", nillable = true)
- @XmlElement(name = "URL")
- @XmlSchemaType(name = "anyURI")
- @ElementCollection(fetch = FetchType.LAZY)
- @Column(name = "contact_urls_element")
- private List<String> urls;
-
- @XmlElementWrapper(name = "PhoneNumbers", nillable = true)
- @XmlElement(name = "PhoneNumber")
- @ElementCollection(fetch = FetchType.LAZY)
- @Column(name = "contact_phonenumbers_element")
- private List<String> phoneNumbers;
-
- @XmlElementWrapper(name = "FaxNumbers", nillable = true)
- @XmlElement(name = "FaxNumber")
- @ElementCollection(fetch = FetchType.LAZY)
- @Column(name = "contact_faxnumbers_element")
- private List<String> faxNumbers;
-
- @XmlElementWrapper(name = "Addresses", nillable = true)
- @XmlElement(name = "Address")
- @OneToMany(fetch = FetchType.LAZY)
- @Cascade({CascadeType.SAVE_UPDATE, CascadeType.MERGE, CascadeType.DELETE_ORPHAN})
- protected Set<Address> addresses;
-
+// ************************ MERGE /MATCH ***************************/
public void merge(Contact contact2) throws MergeException{
if (contact2 != null){
mergeList(this.getUrls(), contact2.getUrls());
for (Address address : contact2.getAddresses()){
try {
- this.addresses.add((Address)address.clone());
+ if (this.addresses == null){
+ this.addresses = new HashSet<>();
+ }
+ this.addresses.add(address.clone());
} catch (CloneNotSupportedException e) {
throw new MergeException("Address must implement Cloneable");
}
}
}
-
- /**
+ /**
+ * True, if no contact data exists in any of the lists (email, phone, ...).
+ */
+ @Transient
+ public boolean isEmpty(){
+ if (isEmpty(emailAddresses) && isEmpty(faxNumbers) && isEmpty(phoneNumbers)
+ && isEmpty(urls) && isEmpty(addresses)){
+ return true;
+ }else{
+ return false;
+ }
+ }
+
+ private boolean isEmpty(Collection<? extends Object> collection) {
+ return collection == null || collection.isEmpty();
+ }
+
+ /**
* Returns the set of postal {@link Address addresses} belonging to <i>this</i> contact.
* A {@link Person person} or an {@link Institution institution} cannot have more than one contact,
* but a contact may include several postal addresses.
* @see Address
*/
public Set<Address> getAddresses(){
- if(this.addresses == null) {
- this.addresses = new HashSet<Address>();
- }
return this.addresses;
}
}
}
- public void addAddress(String street, String postcode, String locality,
- WaterbodyOrCountry country, String pobox, String region, Point location){
+ public Address addAddress(String street, String postcode, String locality,
+ Country country, String pobox, String region, Point location){
Address newAddress = Address.NewInstance(country, locality, pobox, postcode, region, street, location);
getAddresses().add(newAddress);
+ return newAddress;
}
/**
*/
public List<String> getEmailAddresses(){
if(this.emailAddresses == null) {
- this.emailAddresses = new ArrayList<String>();
+ this.emailAddresses = new ArrayList<>();
}
return this.emailAddresses;
}
getEmailAddresses().remove(emailAddress);
}
+// /**
+// * Returns the list of {@link URI URIs} representing this contact
+// * included in <i>this</i> contact.
+// */
+// @Transient //TODO preliminary workaround as we get LazyInit Exception in JSON #4444
+// public List<URI> getUrls(){
+// List<URI> result = new ArrayList<URI>();
+// if(this.urls != null) {
+// for (String uri : this.urls){
+// result.add(URI.create(uri));
+// }
+// }
+// return result;
+// }
+
/**
- * Returns the list of strings representing the "Uniform Resource Locators" (urls)
+ * Returns the list of {@link URI URIs} representing this contact
* included in <i>this</i> contact.
*/
public List<String> getUrls(){
- if(this.urls == null) {
- this.urls = new ArrayList<String>();
- }
return this.urls;
}
/**
* @see #getUrls()
*/
- public void addUrl(String url){
- getUrls().add(url);
+ public void addUrl(URI url){
+ this.urls.add(url.toString());
}
/**
* @param url the url of <i>this</i> contact which should be deleted
* @see #getUrls()
*/
- public void removeUrl(String url){
- getUrls().remove(url);
+ public void removeUrl(URI url){
+ this.urls.remove(url.toString());
}
+
/**
* Returns the list of strings representing the phone numbers
* included in <i>this</i> contact.
*/
public List<String> getPhoneNumbers(){
if(this.phoneNumbers == null) {
- this.phoneNumbers = new ArrayList<String>();
+ this.phoneNumbers = new ArrayList<>();
}
return this.phoneNumbers;
}
*/
public List<String> getFaxNumbers(){
if(this.faxNumbers == null) {
- this.faxNumbers = new ArrayList<String>();
+ this.faxNumbers = new ArrayList<>();
}
return this.faxNumbers;
}
* @see java.lang.Object#clone()
*/
@Override
- public Object clone() {
+ public Contact clone() {
try{
Contact result = (Contact) super.clone();
- result.addresses = new HashSet<Address>();
+ result.addresses = new HashSet<>();
for (Address adr : this.addresses){
- result.addAddress((Address)adr.clone());
+ result.addAddress(adr.clone());
}
- //no changes to emailAdresses, faxNumbers, phoneNumbers, urls
+ //no changes to emailAdresses, faxnumbers, phonenumbers, urls
return result;
}catch (CloneNotSupportedException e){
logger.warn("Object does not implement cloneable");
return null;
}
}
-}
\ No newline at end of file
+}