View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *      http://www.apache.org/licenses/LICENSE-2.0
10   *
11   * Unless required by applicable law or agreed to in writing, software
12   * distributed under the License is distributed on an "AS IS" BASIS,
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   * See the License for the specific language governing permissions and
15   * limitations under the License.
16   */
17  package org.apache.commons.lang3;
18  
19  import static org.junit.jupiter.api.Assertions.assertEquals;
20  import static org.junit.jupiter.api.Assertions.assertFalse;
21  import static org.junit.jupiter.api.Assertions.assertNull;
22  import static org.junit.jupiter.api.Assertions.assertTrue;
23  
24  import org.junit.jupiter.api.Test;
25  
26  /**
27   * Unit tests {@link org.apache.commons.lang3.StringUtils} - Empty/Blank methods
28   */
29  public class StringUtilsEmptyBlankTest extends AbstractLangTest {
30  
31      @Test
32      public void testFirstNonBlank() {
33          assertNull(StringUtils.firstNonBlank());
34          assertNull(StringUtils.firstNonBlank((String[]) null));
35          assertNull(StringUtils.firstNonBlank(null, null, null));
36          assertNull(StringUtils.firstNonBlank(null, "", " "));
37          assertNull(StringUtils.firstNonBlank(null, null, " "));
38          assertEquals("zz", StringUtils.firstNonBlank(null, "zz"));
39          assertEquals("abc", StringUtils.firstNonBlank("abc"));
40          assertEquals("xyz", StringUtils.firstNonBlank(null, "xyz"));
41          assertEquals("xyz", StringUtils.firstNonBlank(null, "xyz", "abc"));
42      }
43  
44      @Test
45      public void testFirstNonEmpty() {
46          assertNull(StringUtils.firstNonEmpty());
47          assertNull(StringUtils.firstNonEmpty((String[]) null));
48          assertNull(StringUtils.firstNonEmpty(null, null, null));
49          assertEquals(" ", StringUtils.firstNonEmpty(null, "", " "));
50          assertNull(StringUtils.firstNonEmpty(null, null, ""));
51          assertEquals("zz", StringUtils.firstNonEmpty(null, "zz"));
52          assertEquals("abc", StringUtils.firstNonEmpty("abc"));
53          assertEquals("xyz", StringUtils.firstNonEmpty(null, "xyz"));
54          assertEquals("xyz", StringUtils.firstNonEmpty(null, "xyz", "abc"));
55      }
56  
57      @Test
58      public void testIsAllBlank() {
59          assertTrue(StringUtils.isAllBlank((String) null));
60          assertTrue(StringUtils.isAllBlank((String[]) null));
61          assertTrue(StringUtils.isAllBlank(null, null));
62          assertTrue(StringUtils.isAllBlank(null, " "));
63          assertFalse(StringUtils.isAllBlank(null, "foo"));
64          assertFalse(StringUtils.isAllBlank("", "bar"));
65          assertFalse(StringUtils.isAllBlank("bob", ""));
66          assertFalse(StringUtils.isAllBlank("  bob  ", null));
67          assertFalse(StringUtils.isAllBlank(" ", "bar"));
68          assertFalse(StringUtils.isAllBlank("foo", "bar"));
69      }
70  
71      @Test
72      public void testIsAllEmpty() {
73          assertTrue(StringUtils.isAllEmpty());
74          assertTrue(StringUtils.isAllEmpty());
75          assertTrue(StringUtils.isAllEmpty((String) null));
76          assertTrue(StringUtils.isAllEmpty((String[]) null));
77          assertFalse(StringUtils.isAllEmpty(null, "foo"));
78          assertFalse(StringUtils.isAllEmpty("", "bar"));
79          assertFalse(StringUtils.isAllEmpty("bob", ""));
80          assertFalse(StringUtils.isAllEmpty("  bob  ", null));
81          assertFalse(StringUtils.isAllEmpty(" ", "bar"));
82          assertFalse(StringUtils.isAllEmpty("foo", "bar"));
83          assertTrue(StringUtils.isAllEmpty("", null));
84      }
85  
86      @Test
87      public void testIsAnyBlank() {
88          assertTrue(StringUtils.isAnyBlank((String) null));
89          assertFalse(StringUtils.isAnyBlank((String[]) null));
90          assertTrue(StringUtils.isAnyBlank(null, "foo"));
91          assertTrue(StringUtils.isAnyBlank(null, null));
92          assertTrue(StringUtils.isAnyBlank("", "bar"));
93          assertTrue(StringUtils.isAnyBlank("bob", ""));
94          assertTrue(StringUtils.isAnyBlank("  bob  ", null));
95          assertTrue(StringUtils.isAnyBlank(" ", "bar"));
96          assertFalse(StringUtils.isAnyBlank("foo", "bar"));
97      }
98  
99      @Test
100     public void testIsAnyEmpty() {
101         assertTrue(StringUtils.isAnyEmpty((String) null));
102         assertFalse(StringUtils.isAnyEmpty((String[]) null));
103         assertTrue(StringUtils.isAnyEmpty(null, "foo"));
104         assertTrue(StringUtils.isAnyEmpty("", "bar"));
105         assertTrue(StringUtils.isAnyEmpty("bob", ""));
106         assertTrue(StringUtils.isAnyEmpty("  bob  ", null));
107         assertFalse(StringUtils.isAnyEmpty(" ", "bar"));
108         assertFalse(StringUtils.isAnyEmpty("foo", "bar"));
109     }
110 
111     @Test
112     public void testIsBlank() {
113         assertTrue(StringUtils.isBlank(null));
114         assertTrue(StringUtils.isBlank(""));
115         assertTrue(StringUtils.isBlank(StringUtilsTest.WHITESPACE));
116         assertFalse(StringUtils.isBlank("foo"));
117         assertFalse(StringUtils.isBlank("  foo  "));
118     }
119 
120     @Test
121     public void testIsEmpty() {
122         assertTrue(StringUtils.isEmpty(null));
123         assertTrue(StringUtils.isEmpty(""));
124         assertFalse(StringUtils.isEmpty(" "));
125         assertFalse(StringUtils.isEmpty("foo"));
126         assertFalse(StringUtils.isEmpty("  foo  "));
127     }
128 
129     @Test
130     public void testIsNoneBlank() {
131         assertFalse(StringUtils.isNoneBlank((String) null));
132         assertTrue(StringUtils.isNoneBlank((String[]) null));
133         assertFalse(StringUtils.isNoneBlank(null, "foo"));
134         assertFalse(StringUtils.isNoneBlank(null, null));
135         assertFalse(StringUtils.isNoneBlank("", "bar"));
136         assertFalse(StringUtils.isNoneBlank("bob", ""));
137         assertFalse(StringUtils.isNoneBlank("  bob  ", null));
138         assertFalse(StringUtils.isNoneBlank(" ", "bar"));
139         assertTrue(StringUtils.isNoneBlank("foo", "bar"));
140     }
141 
142     @Test
143     public void testIsNoneEmpty() {
144         assertFalse(StringUtils.isNoneEmpty((String) null));
145         assertTrue(StringUtils.isNoneEmpty((String[]) null));
146         assertFalse(StringUtils.isNoneEmpty(null, "foo"));
147         assertFalse(StringUtils.isNoneEmpty("", "bar"));
148         assertFalse(StringUtils.isNoneEmpty("bob", ""));
149         assertFalse(StringUtils.isNoneEmpty("  bob  ", null));
150         assertTrue(StringUtils.isNoneEmpty(" ", "bar"));
151         assertTrue(StringUtils.isNoneEmpty("foo", "bar"));
152     }
153 
154     @Test
155     public void testIsNotBlank() {
156         assertFalse(StringUtils.isNotBlank(null));
157         assertFalse(StringUtils.isNotBlank(""));
158         assertFalse(StringUtils.isNotBlank(StringUtilsTest.WHITESPACE));
159         assertTrue(StringUtils.isNotBlank("foo"));
160         assertTrue(StringUtils.isNotBlank("  foo  "));
161     }
162 
163     @Test
164     public void testIsNotEmpty() {
165         assertFalse(StringUtils.isNotEmpty(null));
166         assertFalse(StringUtils.isNotEmpty(""));
167         assertTrue(StringUtils.isNotEmpty(" "));
168         assertTrue(StringUtils.isNotEmpty("foo"));
169         assertTrue(StringUtils.isNotEmpty("  foo  "));
170     }
171 }