src/org/mxchange/jcontacts/contact/gender/GenderUtils.java

   1 /*
   2  * Copyright (C) 2015 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.gender;
  18
  19 import java.text.MessageFormat;
  20 import java.util.LinkedList;
  21 import java.util.List;
  22 import org.mxchange.jcontacts.contact.Contact;
  23 import org.mxchange.jcore.BaseFrameworkSystem;
  24
  25 /**
  26  * Gender utils class
  27  * <p>
  28  * @author Roland Haeder<roland@mxchange.org>
  29  */
  30 public class GenderUtils extends BaseFrameworkSystem {
  31
  32         /**
  33          * Translates contact's gender to human-readable
  34          * <p>
  35          * @param contact Contact instance
  36          * <p>
  37          * @return Translates value (from bundle)
  38          */
  39         public static String getTranslatedGender (final Contact contact) {
  40                 // Init instance
  41                 GenderUtils utils = new GenderUtils();
  42
  43                 // contact must be set
  44                 if (null == contact) {
  45                         // Abort here
  46                         throw new NullPointerException("contact is null");
  47                 } else if (contact.getContactGender() == null) {
  48                         // Gender is not set
  49                         throw new NullPointerException(MessageFormat.format("contact {0} has no gender set.", contact));
  50                 }
  51
  52                 // Get key from it
  53                 String key = contact.getContactGender().getMessageKey();
  54
  55                 // Translate and return it
  56                 return utils.getMessageStringFromKey(key);
  57         }
  58
  59         /**
  60          * Private contructor as this is an utility class
  61          */
  62         private GenderUtils () {
  63         }
  64
  65         /**
  66          * All selectable genders (not UNKNOWN)
  67          * <p>
  68          * @return Selectable genders (not UNKNOWN)
  69          */
  70         public static List<Gender> selectableGenders () {
  71                 // Init list
  72                 List<Gender> list = new LinkedList<>();
  73
  74                 // Walk through all genders
  75                 for (final Gender gender : Gender.values()) {
  76                         // Is it not UNKNOWN
  77                         if (!gender.equals(Gender.UNKNOWN)) {
  78                                 // Add it
  79                                 boolean added = list.add(gender);
  80
  81                                 // Has it been added?
  82                                 assert (added) : MessageFormat.format("gender {0} not added.", gender); //NOI18N
  83                         }
  84                 }
  85
  86                 // Return it
  87                 return list;
  88         }
  89 }