src/org/mxchange/jcontacts/contact/UserContact.java

   1 /*
   2  * Copyright (C) 2016 Roland Haeder
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation, either version 3 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17 package org.mxchange.jcontacts.contact;
  18
  19 import java.util.Calendar;
  20 import java.util.Date;
  21 import java.util.Objects;
  22 import javax.annotation.PostConstruct;
  23 import javax.persistence.Basic;
  24 import javax.persistence.CascadeType;
  25 import javax.persistence.Column;
  26 import javax.persistence.Entity;
  27 import javax.persistence.EnumType;
  28 import javax.persistence.Enumerated;
  29 import javax.persistence.FetchType;
  30 import javax.persistence.GeneratedValue;
  31 import javax.persistence.GenerationType;
  32 import javax.persistence.Id;
  33 import javax.persistence.Index;
  34 import javax.persistence.JoinColumn;
  35 import javax.persistence.Lob;
  36 import javax.persistence.OneToOne;
  37 import javax.persistence.Table;
  38 import javax.persistence.Temporal;
  39 import javax.persistence.TemporalType;
  40 import org.mxchange.jcontacts.contact.gender.Gender;
  41 import org.mxchange.jcountry.data.Country;
  42 import org.mxchange.jcountry.data.CountryData;
  43 import org.mxchange.jphone.phonenumbers.cellphone.CellphoneNumber;
  44 import org.mxchange.jphone.phonenumbers.cellphone.DialableCellphoneNumber;
  45 import org.mxchange.jphone.phonenumbers.fax.DialableFaxNumber;
  46 import org.mxchange.jphone.phonenumbers.fax.FaxNumber;
  47 import org.mxchange.jphone.phonenumbers.landline.DialableLandLineNumber;
  48 import org.mxchange.jphone.phonenumbers.landline.LandLineNumber;
  49
  50 /**
  51  * A general contact class which should only be extended.
  52  * <p>
  53  * @author Roland Haeder<roland@mxchange.org>
  54  * @version 0.0
  55  */
  56 @Entity (name = "contacts")
  57 @Table (
  58                 name = "contacts",
  59                 indexes = {
  60                         @Index (
  61                                         name = "contact_gender",
  62                                         columnList = "contact_gender"
  63                         ),
  64                         @Index (
  65                                         name = "contact_email_address",
  66                                         unique = true,
  67                                         columnList = "contact_email_address"
  68                         )
  69                 }
  70 )
  71 public class UserContact implements Contact, Comparable<Contact> {
  72
  73         /**
  74          * Serial number
  75          */
  76         private static final long serialVersionUID = 58_744_284_981_863L;
  77
  78         /**
  79          * Birth day
  80          */
  81         @Column (name = "contact_birthday")
  82         @Temporal (TemporalType.DATE)
  83         private Date contactBirthday;
  84
  85         /**
  86          * Cellphone number
  87          */
  88         @JoinColumn (name = "contact_cellphone_number_id")
  89         @OneToOne (targetEntity = CellphoneNumber.class, cascade = CascadeType.ALL)
  90         private DialableCellphoneNumber contactCellphoneNumber;
  91
  92         /**
  93          * City
  94          */
  95         @Column (name = "contact_city", nullable = false, length = 100)
  96         private String contactCity;
  97
  98         /**
  99          * Optional comments
 100          */
 101         @Lob
 102         @Column (name = "contact_comment")
 103         private String contactComment;
 104
 105         /**
 106          * Country code
 107          */
 108         @JoinColumn (name = "contact_country_id", nullable = false)
 109         @OneToOne (targetEntity = CountryData.class, cascade = CascadeType.MERGE, optional = false, fetch = FetchType.EAGER)
 110         private Country contactCountry;
 111
 112         /**
 113          * When the contact has been created
 114          */
 115         @Basic (optional = false)
 116         @Temporal (TemporalType.TIMESTAMP)
 117         @Column (name = "contact_created", nullable = false)
 118         private Calendar contactCreated;
 119
 120         /**
 121          * Email address
 122          */
 123         @Column (name = "contact_email_address", length = 100, nullable = false)
 124         private String contactEmailAddress;
 125
 126         /**
 127          * Family name
 128          */
 129         @Basic (optional = false)
 130         @Column (name = "contact_family_name", length = 100, nullable = false)
 131         private String contactFamilyName;
 132
 133         /**
 134          * Fax number
 135          */
 136         @JoinColumn (name = "contact_fax_number_id")
 137         @OneToOne (targetEntity = FaxNumber.class, cascade = CascadeType.ALL)
 138         private DialableFaxNumber contactFaxNumber;
 139
 140         /**
 141          * First name
 142          */
 143         @Basic (optional = false)
 144         @Column (name = "contact_first_name", length = 100, nullable = false)
 145         private String contactFirstName;
 146
 147         /**
 148          * Gender instance
 149          */
 150         @Basic (optional = false)
 151         @Column (name = "contact_gender", nullable = false)
 152         @Enumerated (EnumType.STRING)
 153         private Gender contactGender;
 154
 155         /**
 156          * House number
 157          */
 158         @Column (name = "contact_house_number", length = 5, nullable = false)
 159         private Short contactHouseNumber;
 160
 161         /**
 162          * Id number
 163          */
 164         @Id
 165         @GeneratedValue (strategy = GenerationType.IDENTITY)
 166         @Column (name = "contact_id", length = 20, nullable = false, updatable = false)
 167         private Long contactId;
 168
 169         /**
 170          * Flag whether this contact is user's own data
 171          */
 172         @Column (name = "contact_own_contact", nullable = false)
 173         private Boolean contactOwnContact;
 174
 175         /**
 176          * Phone number
 177          */
 178         @JoinColumn (name = "contact_phone_number_id")
 179         @OneToOne (targetEntity = LandLineNumber.class, cascade = CascadeType.ALL)
 180         private DialableLandLineNumber contactPhoneNumber;
 181
 182         /**
 183          * Street
 184          */
 185         @Column (name = "contact_street", nullable = false)
 186         private String contactStreet;
 187
 188         /**
 189          * Title (Doctor, etc)
 190          */
 191         @Column (name = "contact_title")
 192         private String contactTitle;
 193
 194         /**
 195          * When the contact has been updated
 196          */
 197         @Temporal (TemporalType.TIMESTAMP)
 198         @Column (name = "contact_updated")
 199         private Calendar contactUpdated;
 200
 201         /**
 202          * ZIP code
 203          */
 204         @Column (name = "contact_zip_code", nullable = false, length = 6)
 205         private Integer contactZipCode;
 206
 207         /**
 208          * Constructor for contactGender and names
 209          * <p>
 210          * @param contactGender Gender instance
 211          * @param contactFirstName First name
 212          * @param contactFamilyName Family name
 213          */
 214         public UserContact (final Gender contactGender, final String contactFirstName, final String contactFamilyName) {
 215                 // Set all
 216                 this.contactGender = contactGender;
 217                 this.contactFirstName = contactFirstName;
 218                 this.contactFamilyName = contactFamilyName;
 219         }
 220
 221         /**
 222          * Default constructor
 223          */
 224         public UserContact () {
 225         }
 226
 227         /**
 228          * Compares two contacts with each other
 229          * <p>
 230          * @param contact Contact comparator
 231          * <p>
 232          * @return Comparison value
 233          */
 234         @Override
 235         public int compareTo (final Contact contact) {
 236                 // contact should not be null
 237                 if (null == contact) {
 238                         throw new NullPointerException("contact is null"); //NOI18N
 239                 }
 240
 241                 // Is the contactId the same?
 242                 if (Objects.equals(this.getContactId(), contact.getContactId())) {
 243                         // Same contactId, means same contact
 244                         return 0;
 245                 } else if (this.getContactId() > contact.getContactId()) {
 246                         // This contactId is larger than compared to
 247                         return -1;
 248                 }
 249
 250                 // The other contactId is larger
 251                 return 1;
 252         }
 253
 254         @Override
 255         public void copyAll (final Contact contact) {
 256                 // Copy all:
 257                 // - base data
 258                 this.setContactFirstName(contact.getContactFirstName());
 259                 this.setContactFamilyName(contact.getContactFamilyName());
 260                 this.setContactStreet(contact.getContactStreet());
 261                 this.setContactZipCode(contact.getContactZipCode());
 262                 this.setContactCity(contact.getContactCity());
 263                 this.setContactCountry(contact.getContactCountry());
 264
 265                 // - phone, fax, email
 266                 this.setContactPhoneNumber(contact.getContactPhoneNumber());
 267                 this.setContactFaxNumber(contact.getContactFaxNumber());
 268                 this.setContactCellphoneNumber(contact.getContactCellphoneNumber());
 269
 270                 // - other data
 271                 this.setContactBirthday(contact.getContactBirthday());
 272                 this.setContactComment(contact.getContactComment());
 273                 this.setContactCreated(contact.getContactCreated());
 274                 this.setContactUpdated(contact.getContactUpdated());
 275         }
 276
 277         @Override
 278         public boolean equals (final Object object) {
 279                 // Is it same type?
 280                 if (!(object instanceof UserContact)) {
 281                         // Not equal types
 282                         return false;
 283                 } else if (!(object instanceof Contact)) {
 284                         // Not correct interface
 285                         return false;
 286                 }
 287
 288                 // Try to cast
 289                 Contact contact = (Contact) object;
 290
 291                 // Now test some data TODO Definedly needs improvement
 292                 return ((this.getContactGender().equals(contact.getContactGender()))
 293                                 && (this.getContactFirstName().toLowerCase().equals(contact.getContactFirstName().toLowerCase()))
 294                                 && (this.getContactFamilyName().toLowerCase().equals(contact.getContactFamilyName().toLowerCase())));
 295         }
 296
 297         @Override
 298         public Date getContactBirthday () {
 299                 return this.contactBirthday;
 300         }
 301
 302         @Override
 303         public void setContactBirthday (final Date contactBirthday) {
 304                 this.contactBirthday = contactBirthday;
 305         }
 306
 307         @Override
 308         public DialableCellphoneNumber getContactCellphoneNumber () {
 309                 return this.contactCellphoneNumber;
 310         }
 311
 312         @Override
 313         public void setContactCellphoneNumber (final DialableCellphoneNumber contactCellphoneNumber) {
 314                 this.contactCellphoneNumber = contactCellphoneNumber;
 315         }
 316
 317         @Override
 318         public String getContactCity () {
 319                 return this.contactCity;
 320         }
 321
 322         @Override
 323         public void setContactCity (final String contactCity) {
 324                 this.contactCity = contactCity;
 325         }
 326
 327         @Override
 328         public String getContactComment () {
 329                 return this.contactComment;
 330         }
 331
 332         @Override
 333         public void setContactComment (final String contactComment) {
 334                 this.contactComment = contactComment;
 335         }
 336
 337         @Override
 338         public Country getContactCountry () {
 339                 return this.contactCountry;
 340         }
 341
 342         @Override
 343         public void setContactCountry (final Country contactCountry) {
 344                 this.contactCountry = contactCountry;
 345         }
 346
 347         @Override
 348         public Calendar getContactCreated () {
 349                 return this.contactCreated;
 350         }
 351
 352         @Override
 353         public void setContactCreated (final Calendar contactCreated) {
 354                 this.contactCreated = contactCreated;
 355         }
 356
 357         @Override
 358         public String getContactEmailAddress () {
 359                 return this.contactEmailAddress;
 360         }
 361
 362         @Override
 363         public void setContactEmailAddress (final String contactEmailAddress) {
 364                 this.contactEmailAddress = contactEmailAddress;
 365         }
 366
 367         @Override
 368         public String getContactFamilyName () {
 369                 //* NOISY-DEBUG: */ this.getLogger().logTrace("CALLED!");
 370                 return this.contactFamilyName;
 371         }
 372
 373         @Override
 374         public void setContactFamilyName (final String contactFamilyName) {
 375                 this.contactFamilyName = contactFamilyName;
 376         }
 377
 378         @Override
 379         public DialableFaxNumber getContactFaxNumber () {
 380                 return this.contactFaxNumber;
 381         }
 382
 383         @Override
 384         public void setContactFaxNumber (final DialableFaxNumber contactFaxNumber) {
 385                 this.contactFaxNumber = contactFaxNumber;
 386         }
 387
 388         @Override
 389         public String getContactFirstName () {
 390                 return this.contactFirstName;
 391         }
 392
 393         @Override
 394         public void setContactFirstName (final String contactFirstName) {
 395                 this.contactFirstName = contactFirstName;
 396         }
 397
 398         @Override
 399         public Gender getContactGender () {
 400                 return this.contactGender;
 401         }
 402
 403         @Override
 404         public void setContactGender (final Gender contactGender) {
 405                 this.contactGender = contactGender;
 406         }
 407
 408         @Override
 409         public Short getContactHouseNumber () {
 410                 return this.contactHouseNumber;
 411         }
 412
 413         @Override
 414         public void setContactHouseNumber (final Short contactHouseNumber) {
 415                 this.contactHouseNumber = contactHouseNumber;
 416         }
 417
 418         @Override
 419         public Long getContactId () {
 420                 return this.contactId;
 421         }
 422         @Override
 423         public void setContactId (final Long contactId) {
 424                 this.contactId = contactId;
 425         }
 426
 427         @Override
 428         public void setContactOwnContact (final Boolean contactOwnContact) {
 429                 this.contactOwnContact = contactOwnContact;
 430         }
 431
 432         @Override
 433         public DialableLandLineNumber getContactPhoneNumber () {
 434                 return this.contactPhoneNumber;
 435         }
 436
 437         @Override
 438         public void setContactPhoneNumber (final DialableLandLineNumber contactPhoneNumber) {
 439                 this.contactPhoneNumber = contactPhoneNumber;
 440         }
 441
 442         @Override
 443         public String getContactStreet () {
 444                 return this.contactStreet;
 445         }
 446
 447         @Override
 448         public void setContactStreet (final String contactStreet) {
 449                 this.contactStreet = contactStreet;
 450         }
 451
 452         @Override
 453         public String getContactTitle () {
 454                 return this.contactTitle;
 455         }
 456
 457         @Override
 458         public void setContactTitle (final String contactTitle) {
 459                 this.contactTitle = contactTitle;
 460         }
 461
 462         @Override
 463         public Calendar getContactUpdated () {
 464                 return this.contactUpdated;
 465         }
 466
 467         @Override
 468         public void setContactUpdated (final Calendar contactUpdated) {
 469                 this.contactUpdated = contactUpdated;
 470         }
 471
 472         @Override
 473         public Integer getContactZipCode () {
 474                 return this.contactZipCode;
 475         }
 476
 477         @Override
 478         public void setContactZipCode (final Integer contactZipCode) {
 479                 this.contactZipCode = contactZipCode;
 480         }
 481
 482         @Override
 483         public int hashCode () {
 484                 // Validate contactGender instance
 485                 assert (this.getContactGender() instanceof Gender) : "gender is not set."; //NOI18N
 486
 487                 int hash = 7;
 488                 hash = 79 * hash + Objects.hashCode(this.getContactFamilyName());
 489                 hash = 79 * hash + this.getContactGender().hashCode();
 490                 hash = 79 * hash + Objects.hashCode(this.getContactFirstName());
 491                 return hash;
 492         }
 493
 494         /**
 495          * Initialization with fake contactGender UNKNOWN
 496          */
 497         @PostConstruct
 498         public void init () {
 499                 // Fake contactGender
 500                 this.contactGender = Gender.UNKNOWN;
 501         }
 502
 503         @Override
 504         public Boolean isOwnContact () {
 505                 return this.contactOwnContact;
 506         }
 507 }