StringUtils (aliyun-java-core 0.0.7-beta API)

java.lang.Object
- com.aliyun.core.utils.StringUtils

```
public class StringUtils
extends Object
```
Operations on String that are null safe.

Field Summary

Fields
Modifier and Type Field and Description

static String EMPTY
The empty String "".

Fields
Modifier and Type	Field and Description
`static String`	`EMPTY` The empty String `""`.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`equals(String cs1, String cs2)` Compares two Strings, returning `true` if they represent equal sequences of characters.
`static String`	`fromBytes(byte[] bytes, Charset charset)` Encode the given bytes as a string using the given charset
`static boolean`	`isBlank(CharSequence cs)` Checks if a CharSequence is empty (""), null or whitespace only.
`static boolean`	`isEmpty(CharSequence cs)` Checks if a CharSequence is empty ("") or null.
`static boolean`	`isEmpty(Object object)` Checks if a object is empty or null.
`static String`	`join(String delimiter, Iterable<? extends String> elements)` Join any Strings.
`static String`	`lowerCase(String str)` Converts a String to lower case as per `String.toLowerCase()`.
`static boolean`	`safeStringToBoolean(String value)` Convert a string to boolean safely (as opposed to the less strict `Boolean.parseBoolean(String)`).
`static boolean`	`startsWithIgnoreCase(String str, String prefix)` Tests if this string starts with the specified prefix ignoring case considerations.
`static String`	`substring(String str, int start, int end)` Gets a substring from the specified String avoiding exceptions.
`static String`	`toAliString(String className, Map<String,Object> fieldMap)` Create a to-string result for the given class name and field map.
`static byte[]`	`toBytes(String str)`
`static String`	`toString(byte[] bytes)` Convert a bytes to string(utf8)
`static String`	`trim(String str)` The String is trimmed using `String.trim()`.
`static String`	`upperCase(String str)` Converts a String to upper case as per `String.toUpperCase()`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - EMPTY
```
public static final String EMPTY
```
    The empty String "".
    
    See Also:
    
    Constant Field Values
- Method Detail
  - isEmpty
```
public static boolean isEmpty(CharSequence cs)
```
    Checks if a CharSequence is empty ("") or null.
    
    Parameters:
    
    cs - the CharSequence to check, may be null
    
    Returns:
    
    true if the CharSequence is empty or null
  - isEmpty
```
public static boolean isEmpty(Object object)
```
    Checks if a object is empty or null.
    
    Parameters:
    
    object - the String.valueOf(object) to check, may be null
    
    Returns:
    
    true if the String.valueOf(object) is empty or null
  - isBlank
```
public static boolean isBlank(CharSequence cs)
```
    Checks if a CharSequence is empty (""), null or whitespace only.
    Whitespace is defined by Character.isWhitespace(char).
    
    Parameters:
    
    cs - the CharSequence to check, may be null
    
    Returns:
    
    true if the CharSequence is null, empty or whitespace only
  - trim
```
public static String trim(String str)
```
    The String is trimmed using String.trim(). Trim removes start and end characters <= 32.
    
    Parameters:
    
    str - the String to be trimmed, may be null
    
    Returns:
    
    the trimmed string, null if null String input
  - equals
```
public static boolean equals(String cs1,
                             String cs2)
```
    Compares two Strings, returning true if they represent equal sequences of characters.
    
    Parameters:
    
    cs1 - the first String, may be null
    
    cs2 - the second String, may be null
    
    Returns:
    
    true if the Strings are equal (case-sensitive), or both null
    
    See Also:
    
    Object.equals(Object)
  - join
```
public static String join(String delimiter,
                          Iterable<? extends String> elements)
```
    Join any Strings.
    
    Parameters:
    
    delimiter - the delimiter which split two Strings, should not be null
    
    elements - the Strings Iterable, should not be null
    
    Returns:
    
    String
  - substring
```
public static String substring(String str,
                               int start,
                               int end)
```
    Gets a substring from the specified String avoiding exceptions.
    
    Parameters:
    
    str - the String to get the substring from, may be null
    
    start - the position to start from, negative means count back from the end of the String by this many characters
    
    end - the position to end at (exclusive), negative means count back from the end of the String by this many characters
    
    Returns:
    
    substring from start position to end position, null if null String input
  - upperCase
```
public static String upperCase(String str)
```
    Converts a String to upper case as per String.toUpperCase().
    This uses "ENGLISH" as the locale.
    
    Parameters:
    
    str - the String to upper case, may be null
    
    Returns:
    
    the upper cased String, null if null String input
  - lowerCase
```
public static String lowerCase(String str)
```
    Converts a String to lower case as per String.toLowerCase().
    This uses "ENGLISH" as the locale.
    
    Parameters:
    
    str - the String to lower case, may be null
    
    Returns:
    
    the lower cased String, null if null String input
  - fromBytes
```
public static String fromBytes(byte[] bytes,
                               Charset charset)
                        throws UncheckedIOException
```
    Encode the given bytes as a string using the given charset
    
    Throws:
    
    UncheckedIOException - with a CharacterCodingException as the cause if the bytes cannot be encoded using the provided charset.
  - startsWithIgnoreCase
```
public static boolean startsWithIgnoreCase(String str,
                                           String prefix)
```
    Tests if this string starts with the specified prefix ignoring case considerations.
    
    Parameters:
    
    str - the string to be tested
    
    prefix - the prefix
    
    Returns:
    
    true if the string starts with the prefix ignoring case
  - safeStringToBoolean
```
public static boolean safeStringToBoolean(String value)
```
    Convert a string to boolean safely (as opposed to the less strict Boolean.parseBoolean(String)). If a customer specifies a boolean value it should be "true" or "false" (case insensitive) or an exception will be thrown.
  - toAliString
```
public static String toAliString(String className,
                                 Map<String,Object> fieldMap)
```
    Create a to-string result for the given class name and field map.
    
    Parameters:
    
    className - The name of the class being toString.
    
    fieldMap - The key and value of the field. Value is ignored if null.
  - toBytes
```
public static byte[] toBytes(String str)
```
  - toString
```
public static String toString(byte[] bytes)
```
    Convert a bytes to string(utf8)
    
    Returns:
    
    the return string

Class StringUtils

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

EMPTY

Method Detail

isEmpty

isEmpty

isBlank

trim

equals

join

substring

upperCase

lowerCase

fromBytes

startsWithIgnoreCase

safeStringToBoolean

toAliString

toBytes

toString