2 * Copyright (C) 2016, 2017 Roland Häder
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU Affero General Public License as
6 * published by the Free Software Foundation, either version 3 of the
7 * License, or (at your option) any later version.
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 Affero General Public License for more details.
14 * You should have received a copy of the GNU Affero General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.jcontacts.model.contact;
19 import java.text.MessageFormat;
20 import java.util.Iterator;
21 import java.util.List;
22 import java.util.Objects;
23 import javax.ejb.Stateless;
24 import javax.persistence.NoResultException;
25 import javax.persistence.Query;
26 import org.mxchange.jcontacts.exceptions.ContactNotFoundException;
27 import org.mxchange.jjobs.database.BaseJobsDatabaseBean;
32 * @author Roland Häder<roland@mxchange.org>
34 @Stateless (name = "contact", description = "A bean handling contact data")
35 public class JobsContactSessionBean extends BaseJobsDatabaseBean implements ContactSessionBeanRemote {
40 private static final long serialVersionUID = 542_145_347_916L;
45 public JobsContactSessionBean () {
46 // Call super constructor
51 @SuppressWarnings ("unchecked")
52 public List<Contact> allContacts () {
54 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.getAllContacts - CALLED!", this.getClass().getSimpleName())); //NOI18N
56 // Create query instance
57 final Query query = this.getEntityManager().createNamedQuery("AllContacts"); //NOI18N
60 final List<Contact> contacts = query.getResultList();
63 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.getAllContacts: contacts.size()={1} - EXIT!", this.getClass().getSimpleName(), contacts.size())); //NOI18N
70 @SuppressWarnings ("unchecked")
71 public List<String> allEmailAddresses () {
73 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.getEmailAddressList - CALLED!", this.getClass().getSimpleName())); //NOI18N
75 // Create query instance
76 final Query query = this.getEntityManager().createNamedQuery("AllContactEmailAddresses"); //NOI18N
79 final List<String> emailAddresses = query.getResultList();
82 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.getEmailAddressList: emailAddresses.size()={1} - EXIT!", this.getClass().getSimpleName(), emailAddresses.size())); //NOI18N
85 return emailAddresses;
89 public Contact findContactByEmailAddress (final String emailAddress) throws ContactNotFoundException {
91 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactByEmailAddress: emailAddress={1} - CALLED!", this.getClass().getSimpleName(), emailAddress)); //NOI18N
93 // The parameter must be valid
94 if (null == emailAddress) {
96 throw new NullPointerException("emailAddress is null"); //NOI18N
97 } else if (emailAddress.isEmpty()) {
99 throw new IllegalArgumentException("emailAddress is empty"); //NOI18N
102 // Get query instance
103 final Query query = this.getEntityManager().createNamedQuery("SearchContactByEmailAddress", UserContact.class); //NOI18N
105 // Set parameter and limit
106 query.setParameter("emailAddress", emailAddress); //NOI18N
107 query.setMaxResults(1);
109 // Init contact instance
110 final Contact contact;
112 // Try to find a result
114 // Find a single result
115 contact = (Contact) query.getSingleResult();
118 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactByEmailAddress: Found contact={1}", this.getClass().getSimpleName(), contact)); //NOI18N
119 } catch (final NoResultException ex) {
121 throw new ContactNotFoundException(emailAddress, ex);
125 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactByEmailAddress: contact={1} - EXIT!", this.getClass().getSimpleName(), contact)); //NOI18N
127 // Return found instance
132 public Contact findContactById (final Long contactId) throws ContactNotFoundException {
134 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactById: contactId={1} - CALLED!", this.getClass().getSimpleName(), contactId)); //NOI18N
136 // The parameter must be valid
137 if (null == contactId) {
139 throw new NullPointerException("contactId is null"); //NOI18N
140 } else if (contactId < 1) {
142 throw new IllegalArgumentException(MessageFormat.format("contactId={0} is not valid", contactId)); //NOI18N
145 // Get query instance
146 final Query query = this.getEntityManager().createNamedQuery("SearchContactById", UserContact.class); //NOI18N
149 query.setParameter("contactId", contactId); //NOI18N
150 query.setMaxResults(1);
152 // Init contact instance
153 final Contact contact;
155 // Try to find a result
157 // Find a single result
158 contact = (Contact) query.getSingleResult();
161 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactById: Found contact={1}", this.getClass().getSimpleName(), contact)); //NOI18N
162 } catch (final NoResultException ex) {
164 throw new ContactNotFoundException(contactId, ex);
168 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.findContactById: contact={1} - EXIT!", this.getClass().getSimpleName(), contact)); //NOI18N
170 // Return found instance
175 public boolean isEmailAddressRegistered (final String emailAddress) {
177 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.isEmailAddressRegistered: emailAddress={1} - CALLED!", this.getClass().getSimpleName(), emailAddress)); //NOI18N
179 // The email address should be valid
180 if (null == emailAddress) {
182 throw new NullPointerException("emailAddress is null"); //NOI18N
183 } else if (emailAddress.isEmpty()) {
185 throw new IllegalArgumentException("emailAddress is empty"); //NOI18N
188 // Default is not found
189 boolean isFound = false;
192 // Ask other method for contact instance
193 final Contact contact = this.findContactByEmailAddress(emailAddress);
196 this.getLoggerBeanLocal().logDebug(MessageFormat.format("{0}.isEmailAddressRegistered: Found contact={1} for emailAddress={2}", this.getClass().getSimpleName(), contact, emailAddress)); //NOI18N
200 } catch (final ContactNotFoundException ex) {
201 // @TODO Was not found, log exception for spam check?
205 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.isEmailAddressRegistered: isFound={1} - EXIT!", this.getClass().getSimpleName(), isFound)); //NOI18N
212 public Contact lookupContact (final Contact contact) {
214 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.isContactFound: contact={1} - CALLED!", this.getClass().getSimpleName(), contact)); //NOI18N
216 // Parameter should be valid
217 if (null == contact) {
219 throw new NullPointerException("contact is null"); //NOI18N
220 } else if (contact.getContactId() > 0) {
222 // Id set, ask other method
223 return this.findContactById(contact.getContactId());
224 } catch (final ContactNotFoundException ex) {
225 // Not found, should not happen
226 throw new IllegalStateException(MessageFormat.format("contact.contactId={0} is set, but not found.", contact.getContactId()), ex); //NOI18N
230 // Default is not found
231 Contact foundContact = null;
234 final List<Contact> contacts = this.allContacts();
236 // Is the list empty?
237 if (contacts.isEmpty()) {
239 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.isContactFound: No contacts registered, returning NULL ...", this.getClass().getSimpleName())); //NOI18N
244 final Iterator<Contact> iterator = contacts.iterator();
247 while (iterator.hasNext()) {
249 Contact next = iterator.next();
252 if ((Objects.equals(contact, next)) || (ContactUtils.isSameContact(contact, next))) {
254 this.getLoggerBeanLocal().logDebug(MessageFormat.format("{0}.isContactFound: Found same contact: contactId={1}", this.getClass().getSimpleName(), next.getContactId())); //NOI18N
263 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.isContactFound: foundContact={1} - EXIT!", this.getClass().getSimpleName(), foundContact)); //NOI18N
265 // Return found contact
270 public Contact updateContactData (final Contact contact, final boolean isCellphoneUnlinked, final boolean isLandlineUnlinked, final boolean isFaxUnlinked) {
272 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.updateContactData: contact={1},isCellphoneUnlinked={2},isLandlineUnlinked={3},isFaxUnlinked={4} - CALLED!", this.getClass().getSimpleName(), contact, isCellphoneUnlinked, isLandlineUnlinked, isFaxUnlinked)); //NOI18N
274 // The contact instance must be valid
275 if (null == contact) {
277 throw new NullPointerException("contact is null"); //NOI18N
278 } else if (contact.getContactId() == null) {
280 throw new NullPointerException("contact.contactId is null"); //NOI18N
281 } else if (contact.getContactId() < 1) {
283 throw new IllegalStateException(MessageFormat.format("contact.contactId={0} is not valid.", contact.getContactId())); //NOI18N
286 // Set updated timestamp
287 this.setAllContactPhoneEntriesUpdated(contact, isCellphoneUnlinked, isLandlineUnlinked, isFaxUnlinked);
289 // Merge mobile, land-line and fix
290 Contact detachedContact = this.mergeContactData(contact);
293 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.updateContactData: detachedContact={1} - EXIT!", this.getClass().getSimpleName(), detachedContact)); //NOI18N
296 return detachedContact;
300 public Contact updateContactData (final Contact contact) {
302 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.updateContactData: contact={1} - CALLED!", this.getClass().getSimpleName(), contact)); //NOI18N
304 // The contact instance must be valid
305 if (null == contact) {
307 throw new NullPointerException("contact is null"); //NOI18N
308 } else if (contact.getContactId() == null) {
310 throw new NullPointerException("contact.contactId is null"); //NOI18N
311 } else if (contact.getContactId() < 1) {
313 throw new IllegalStateException(MessageFormat.format("contact.contactId={0} is not valid.", contact.getContactId())); //NOI18N
316 // Is cell phone/land-line/fax number unlinked?
317 boolean isCellphoneUnlinked = (contact.getContactMobileNumber() == null);
318 boolean isLandLineUnlinked = (contact.getContactLandLineNumber() == null);
319 boolean isFaxUnlinked = (contact.getContactFaxNumber() == null);
322 Contact detachedContact = this.updateContactData(contact, isCellphoneUnlinked, isLandLineUnlinked, isFaxUnlinked);
325 this.getLoggerBeanLocal().logTrace(MessageFormat.format("{0}.updateContactData: detachedContact={1} - EXIT!", this.getClass().getSimpleName(), detachedContact)); //NOI18N
328 return detachedContact;