Adding isBlank method (shekhargulati#89)

deeseja · shekhargulati · commit d04e679b07e5 · 2017-05-20T06:57:21.000+05:30
* added isBlank method, along with junit test and readme update

* removing local files

* adding gitignore with Eclipse specific files ignored

* removed unused imports from Strman.java and split tests out to match current test convention
diff --git a/.gitignore b/.gitignore
@@ -71,3 +71,8 @@ hs_err_pid*
 
 !gradle/wrapper/gradle-wrapper.jar
 
+/bin/
+
+.classpath
+.project
+.settings
diff --git a/README.md b/README.md
@@ -618,6 +618,19 @@ join(new String[]{"hello","world","123"}, ";")
 // result => "hello;world;123")
 ```
 
+## isBlank
+
+isEmpty returns true if a string is blank or null and false otherwise.
+
+```java
+isBlank("")
+// result => true)
+isBlank(null)
+// result => true)
+isBlank("test")
+// result => false)
+```
+
 ## Inspiration
 
 This library is inspired by [dleitee/strman](https://github.com/dleitee/strman).
diff --git a/src/main/java/strman/Strman.java b/src/main/java/strman/Strman.java
@@ -1305,6 +1305,16 @@ public static Map<Character, Long> charsCount(String input) {
                 .mapToObj(c -> (char) c)
                 .collect(groupingBy(identity(), counting()));
     }
+    
+    /**
+     * Checks if string is empty.  This is a null safe check and will return true when string is null.
+     *
+     * @param input The input string
+     * @return true if string is null or empty
+     */
+	public static boolean isBlank(String input) {
+		return input == null || input.isEmpty();
+	}
 
     private static void validate(String value, Predicate<String> predicate, final Supplier<String> supplier) {
         if (predicate.test(value)) {
@@ -1325,5 +1335,6 @@ private static long countSubstr(String value, String subStr, boolean allowOverla
         }
         return countSubstr(value.substring(offset), subStr, allowOverlapping, ++count);
     }
+    
 }
 
diff --git a/src/test/java/strman/StrmanTest.java b/src/test/java/strman/StrmanTest.java
@@ -37,8 +37,6 @@
 import static org.hamcrest.collection.IsArrayWithSize.emptyArray;
 import static org.junit.Assert.*;
 import static strman.Strman.*;
-import static strman.Strman.endsWith;
-import static strman.Strman.format;
 
 public class StrmanTest {
 
@@ -1027,4 +1025,19 @@ public void charsCount_shouldReturnCharsCountWhenInputIsAComplexString(){
 
         assertThat(charsCount("-----abbcccCCCBBA-----"), equalTo(expectedOutput));
     }
+    
+    @Test
+    public void isBlank_shouldReturnTrueIfNull() {
+    	assertTrue(isBlank(null));
+    }
+    
+    @Test
+    public void isBlank_shouldReturnTrueIfEmpty() {
+    	assertTrue(isBlank(""));
+    }
+    
+    @Test
+    public void isBlank_shouldReturnFalseIfNotEmpty() {
+    	assertFalse(isBlank("ac"));
+    }
 }

Original file line number	Diff line number	Diff line change
`@@ -1305,6 +1305,16 @@ public static Map<Character, Long> charsCount(String input) {`
`1305`	`1305`	`.mapToObj(c -> (char) c)`
`1306`	`1306`	`.collect(groupingBy(identity(), counting()));`
`1307`	`1307`	`}`
	`1308`	`+`
	`1309`	`+ /**`
	`1310`	`+ * Checks if string is empty. This is a null safe check and will return true when string is null.`
	`1311`	`+ *`
	`1312`	`+ * @param input The input string`
	`1313`	`+ * @return true if string is null or empty`
	`1314`	`+ */`
	`1315`	`+ public static boolean isBlank(String input) {`
	`1316`	`+ return input == null \|\| input.isEmpty();`
	`1317`	`+ }`
`1308`	`1318`
`1309`	`1319`	`private static void validate(String value, Predicate<String> predicate, final Supplier<String> supplier) {`
`1310`	`1320`	`if (predicate.test(value)) {`
`@@ -1325,5 +1335,6 @@ private static long countSubstr(String value, String subStr, boolean allowOverla`
`1325`	`1335`	`}`
`1326`	`1336`	`return countSubstr(value.substring(offset), subStr, allowOverlapping, ++count);`
`1327`	`1337`	`}`
	`1338`	`+`
`1328`	`1339`	`}`
`1329`	`1340`