Updated copyright, changes in 2018 did take happen ...

[jcore-utils.git] / src / org / mxchange / jcoreee / utils / FacesUtils.java

diff --git a/src/org/mxchange/jcoreee/utils/FacesUtils.java b/src/org/mxchange/jcoreee/utils/FacesUtils.java
index a7e20d3d6a088079e89f840862d9d36dcb905a2c..674b8f1bd1752619d63288876be96247ccbf6e7a 100644 (file)
--- a/src/org/mxchange/jcoreee/utils/FacesUtils.java
+++ b/src/org/mxchange/jcoreee/utils/FacesUtils.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2016 Cho-Time GmbH
+ * Copyright (C) 2016 - 2018 Free Software Foundation
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -22,7 +22,7 @@ import javax.faces.context.FacesContext;
 /**
  * An utilities class for JSF
  * <p>
- * @author Roland Haeder<rhaeder@cho-time.de>
+ * @author Roland Häder<roland@mxchange.org>
  */
 public class FacesUtils {
 
@@ -78,6 +78,66 @@ public class FacesUtils {
                return baseUrl;
        }
 
+       /**
+        * Compares both string with null-safety. This method is based on the
+        * example from
+        * https://codereview.stackexchange.com/questions/20191/comparing-two-strings-which-could-be-null-or-blank-in-a-comparator
+        * <p>
+        * @param str0 First string
+        * @param str1 Second string
+        * <p>
+        * @return Comparison value, 0 means equals, -1 means str0 smaller str2 and
+        *         2 means str0 bigger str2
+        */
+       @SuppressWarnings ("null")
+       public static int comareTo (final String str0, final String str1) {
+               // Check both strings for null and empty
+               boolean isStr0Empty = (str0 == null || str0.isEmpty());
+               boolean isStr1Empty = (str1 == null || str1.isEmpty());
+
+               // Check conditions
+               if (isStr0Empty && isStr1Empty) {
+                       return 0;
+               } else if (isStr0Empty) {
+                       return -1;
+               } else if (isStr1Empty) {
+                       return 1;
+               }
+
+               // Compare both
+               return str0.compareTo(str1);
+       }
+
+       /**
+        * Compares both string with null-safety, ignoring case-sensitivity. This
+        * method is based on the example from
+        * https://codereview.stackexchange.com/questions/20191/comparing-two-strings-which-could-be-null-or-blank-in-a-comparator
+        * <p>
+        * @param str0 First string
+        * @param str1 Second string
+        * <p>
+        * @return Comparison value, 0 means equals, -1 means str0 smaller str2 and
+        *         2 means str0 bigger str2
+        */
+       @SuppressWarnings ("null")
+       public static int comareToIgnoreCase (final String str0, final String str1) {
+               // Check both strings for null and empty
+               boolean isStr0Empty = (str0 == null || str0.isEmpty());
+               boolean isStr1Empty = (str1 == null || str1.isEmpty());
+
+               // Check conditions
+               if (isStr0Empty && isStr1Empty) {
+                       return 0;
+               } else if (isStr0Empty) {
+                       return -1;
+               } else if (isStr1Empty) {
+                       return 1;
+               }
+
+               // Compare both
+               return str0.compareToIgnoreCase(str1);
+       }
+
        /**
         * No instances from this class are required
         */