cn.sexycode.util.core.str

类 StringHelper

java.lang.Object

cn.sexycode.util.core.str.StringHelper

public final class StringHelper
extends Object

作者:

qinzaizhen

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	StringHelper.Renderer<T>

字段概要

字段

限定符和类型	字段和说明
static String	BATCH_ID_PLACEHOLDER
(专用程序包) byte[]	BYTES_NEW_LINE
(专用程序包) String[]	EMPTY_ARRAY
static String[]	EMPTY_STRINGS
static int	INDEX_NOT_FOUND Represents a failed index search.
static String	WHITESPACE

方法概要

限定符和类型	方法和说明
static String[]	add(String[] x, String sep, String[] y)
static boolean	booleanValue(String tfString)
static String	camelhumpToUnderline(String str) 将驼峰风格替换为下划线风格
static String	collapse(String name) Collapses a name.
static String	collapseQualifier(String qualifier, boolean includeDots) Given a qualifier, collapse it.
static String	collapseQualifierBase(String name, String qualifierBase) Cross between collapse(java.lang.String) and partiallyUnqualify(java.lang.String, java.lang.String).
static String	convertByStyle(String str, Style style) 根据指定的样式进行转换
static int	countUnquoted(String string, char character)
static int	firstIndexOfChar(String sqlString, BitSet keys, int startindex)
static int	firstIndexOfChar(String sqlString, String string, int startindex)
static String	generateAlias(String description)
static String	generateAlias(String description, int unique) Generate a nice alias for the given class name or collection role name and unique integer.
static char	getFirstNonWhitespaceCharacter(String str)
static char	getLastNonWhitespaceCharacter(String str)
static int	indexOf(CharSequence seq, CharSequence searchSeq) Finds the first index within a CharSequence, handling null.
static int	indexOf(CharSequence seq, CharSequence searchSeq, int startPos) Finds the first index within a CharSequence, handling null.
static boolean	isEmpty(CharSequence string)
static boolean	isEmptyOrWhiteSpace(String string)
static boolean	isLowercaseAlpha(char c)
static boolean	isNotEmpty(CharSequence string)
static boolean	isQuoted(String name) Determine if the given string is quoted (wrapped by '`' characters at beginning and end).
static boolean	isUppercaseAlpha(char c)
static <T> String	join(Collection<T> values, StringHelper.Renderer<T> renderer)
static String	join(String separator, Iterable objects)
static String	join(String seperator, Iterator objects)
static String	join(String seperator, String[] strings)
static <T> String	join(T[] values, StringHelper.Renderer<T> renderer)
static String	joinWithQualifierAndSuffix(String[] values, String qualifier, String suffix, String deliminator)
static int	lastIndexOf(CharSequence seq, CharSequence searchSeq) Finds the last index within a CharSequence, handling null.
static int	lastIndexOf(CharSequence seq, int searchChar) Returns the index within seq of the last occurrence of the specified character.
static int	lastIndexOf(CharSequence seq, int searchChar, int startPos) Returns the index within seq of the last occurrence of the specified character, searching backward starting at the specified index.
static int	lastIndexOfLetter(String string)
static int[]	locateUnquoted(String string, char character)
static String	moveAndToBeginning(String filter)
static String[]	multiply(String string, Iterator placeholders, Iterator replacements)
static String	nullIfEmpty(String value)
static List<String>	parseCommaSeparatedString(String incomingString)
static String	partiallyUnqualify(String name, String qualifierBase) Partially unqualifies a qualified name.
static String	qualifier(String qualifiedName)
static String	qualify(String prefix, String name)
static String[]	qualify(String prefix, String[] names)
static String	qualifyConditionally(String prefix, String name)
static String[]	qualifyIfNot(String prefix, String[] names)
static String	quote(String name) Return a representation of the given name ensuring quoting (wrapped with '`' characters).
static String	repeat(char character, int times)
static String	repeat(String string, int times)
static String	repeat(String string, int times, String deliminator)
static String[]	replace(String[] templates, String placeholder, String replacement)
static String	replace(String template, String placeholder, String replacement)
static String	replace(String template, String placeholder, String replacement, boolean wholeWords)
static String	replace(String template, String placeholder, String replacement, boolean wholeWords, boolean encloseInParensIfNecessary)
static String	replace(String beforePlaceholder, String afterPlaceholder, String placeholder, String replacement, boolean wholeWords, boolean encloseInParensIfNecessary)
static String	replaceOnce(String template, String placeholder, String replacement)
static String	root(String qualifiedName)
static String[]	split(String separators, String list)
static String[]	split(String separators, String list, boolean include)
static String[]	splitTrimmingTokens(String separators, String list, boolean include)
static String	substring(String str, int start) Gets a substring from the specified String avoiding exceptions.
static String	substring(String str, int start, int end) Gets a substring from the specified String avoiding exceptions.
static String[]	suffix(String[] columns, String suffix)
static String[]	toArrayElement(String s) Takes a String s and returns a new String[1] with s as the only element.
static char	toLowerAscii(char c)
static String	toString(Object[] array)
static char	toUpperAscii(char c)
static String	truncate(String string, int length)
static String	underlineToCamelhump(String str) 将下划线风格替换为驼峰风格
static String	unqualify(String qualifiedName)
static String	unqualifyEntityName(String entityName)
static String	unquote(String name) Return the unquoted version of name (stripping the start and end '`' characters if present).
static String	unroot(String qualifiedName)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

INDEX_NOT_FOUND

public static final int INDEX_NOT_FOUND

Represents a failed index search.

从以下版本开始:

2.1

另请参阅:

常量字段值

EMPTY_ARRAY

String[] EMPTY_ARRAY

BYTES_NEW_LINE

byte[] BYTES_NEW_LINE

WHITESPACE

public static final String WHITESPACE

另请参阅:

常量字段值

EMPTY_STRINGS

public static final String[] EMPTY_STRINGS

BATCH_ID_PLACEHOLDER

public static final String BATCH_ID_PLACEHOLDER

另请参阅:

常量字段值

方法详细资料

lastIndexOfLetter

public static int lastIndexOfLetter(String string)

join

public static String join(String seperator,
                          String[] strings)

joinWithQualifierAndSuffix

public static String joinWithQualifierAndSuffix(String[] values,
                                                String qualifier,
                                                String suffix,
                                                String deliminator)

join

public static String join(String seperator,
                          Iterator objects)

join

public static String join(String separator,
                          Iterable objects)

add

public static String[] add(String[] x,
                           String sep,
                           String[] y)

repeat

public static String repeat(String string,
                            int times)

repeat

public static String repeat(String string,
                            int times,
                            String deliminator)

repeat

public static String repeat(char character,
                            int times)

replace

public static String replace(String template,
                             String placeholder,
                             String replacement)

replace

public static String[] replace(String[] templates,
                               String placeholder,
                               String replacement)

replace

public static String replace(String template,
                             String placeholder,
                             String replacement,
                             boolean wholeWords)

replace

public static String replace(String template,
                             String placeholder,
                             String replacement,
                             boolean wholeWords,
                             boolean encloseInParensIfNecessary)

replace

public static String replace(String beforePlaceholder,
                             String afterPlaceholder,
                             String placeholder,
                             String replacement,
                             boolean wholeWords,
                             boolean encloseInParensIfNecessary)

getLastNonWhitespaceCharacter

public static char getLastNonWhitespaceCharacter(String str)

getFirstNonWhitespaceCharacter

public static char getFirstNonWhitespaceCharacter(String str)

replaceOnce

public static String replaceOnce(String template,
                                 String placeholder,
                                 String replacement)

split

public static String[] split(String separators,
                             String list)

split

public static String[] split(String separators,
                             String list,
                             boolean include)

splitTrimmingTokens

public static String[] splitTrimmingTokens(String separators,
                                           String list,
                                           boolean include)

unqualify

public static String unqualify(String qualifiedName)

qualifier

public static String qualifier(String qualifiedName)

collapse

public static String collapse(String name)

Collapses a name. Mainly intended for use with classnames, where an example might serve best to explain. Imagine you have a class named 'org.hibernate.internal.util.StringHelper'; calling collapse on that classname will result in 'o.h.u.StringHelper'.

参数:

name - The name to collapse.

返回:

The collapsed name.

collapseQualifier

public static String collapseQualifier(String qualifier,
                                       boolean includeDots)

Given a qualifier, collapse it.

参数:

qualifier - The qualifier to collapse.

includeDots - Should we include the dots in the collapsed form?

返回:

The collapsed form.

partiallyUnqualify

public static String partiallyUnqualify(String name,
                                        String qualifierBase)

Partially unqualifies a qualified name. For example, with a base of 'org.hibernate' the name 'org.hibernate.internal.util.StringHelper' would become 'util.StringHelper'.

参数:

name - The (potentially) qualified name.

qualifierBase - The qualifier base.

返回:

The name itself, or the partially unqualified form if it begins with the qualifier base.

collapseQualifierBase

public static String collapseQualifierBase(String name,
                                           String qualifierBase)

Cross between collapse(java.lang.String) and partiallyUnqualify(java.lang.String, java.lang.String). Functions much like collapse(java.lang.String) except that only the qualifierBase is collapsed. For example, with a base of 'org.hibernate' the name 'org.hibernate.internal.util.StringHelper' would become 'o.h.util.StringHelper'.

参数:

name - The (potentially) qualified name.

qualifierBase - The qualifier base.

返回:

The name itself if it does not begin with the qualifierBase, or the properly collapsed form otherwise.

suffix

public static String[] suffix(String[] columns,
                              String suffix)

root

public static String root(String qualifiedName)

unroot

public static String unroot(String qualifiedName)

booleanValue

public static boolean booleanValue(String tfString)

toString

public static String toString(Object[] array)

multiply

public static String[] multiply(String string,
                                Iterator placeholders,
                                Iterator replacements)

countUnquoted

public static int countUnquoted(String string,
                                char character)

locateUnquoted

public static int[] locateUnquoted(String string,
                                   char character)

isNotEmpty

public static boolean isNotEmpty(CharSequence string)

isEmpty

public static boolean isEmpty(CharSequence string)

isEmptyOrWhiteSpace

public static boolean isEmptyOrWhiteSpace(String string)

qualify

public static String qualify(String prefix,
                             String name)

qualifyConditionally

public static String qualifyConditionally(String prefix,
                                          String name)

qualify

public static String[] qualify(String prefix,
                               String[] names)

qualifyIfNot

public static String[] qualifyIfNot(String prefix,
                                    String[] names)

firstIndexOfChar

public static int firstIndexOfChar(String sqlString,
                                   BitSet keys,
                                   int startindex)

firstIndexOfChar

public static int firstIndexOfChar(String sqlString,
                                   String string,
                                   int startindex)

truncate

public static String truncate(String string,
                              int length)

generateAlias

public static String generateAlias(String description)

generateAlias

public static String generateAlias(String description,
                                   int unique)

Generate a nice alias for the given class name or collection role name and unique integer. Subclasses of Loader do not have to use aliases of this form.

参数:

description - The base name (usually an entity-name or collection-role)

unique - A uniquing value

返回:

an alias of the form foo1_

unqualifyEntityName

public static String unqualifyEntityName(String entityName)

moveAndToBeginning

public static String moveAndToBeginning(String filter)

isQuoted

public static boolean isQuoted(String name)

Determine if the given string is quoted (wrapped by '`' characters at beginning and end).

参数:

name - The name to check.

返回:

True if the given string starts and ends with '`'; false otherwise.

quote

public static String quote(String name)

Return a representation of the given name ensuring quoting (wrapped with '`' characters). If already wrapped return name.

参数:

name - The name to quote.

返回:

The quoted version.

unquote

public static String unquote(String name)

Return the unquoted version of name (stripping the start and end '`' characters if present).

参数:

name - The name to be unquoted.

返回:

The unquoted version.

toArrayElement

public static String[] toArrayElement(String s)

Takes a String s and returns a new String[1] with s as the only element. If s is null or "", return String[0].

参数:

s -

返回:

String[]

nullIfEmpty

public static String nullIfEmpty(String value)

parseCommaSeparatedString

public static List<String> parseCommaSeparatedString(String incomingString)

join

public static <T> String join(Collection<T> values,
                              StringHelper.Renderer<T> renderer)

join

public static <T> String join(T[] values,
                              StringHelper.Renderer<T> renderer)

convertByStyle

public static String convertByStyle(String str,
                                    Style style)

根据指定的样式进行转换

参数:

str -

style -

返回:

camelhumpToUnderline

public static String camelhumpToUnderline(String str)

将驼峰风格替换为下划线风格

underlineToCamelhump

public static String underlineToCamelhump(String str)

将下划线风格替换为驼峰风格

isUppercaseAlpha

public static boolean isUppercaseAlpha(char c)

isLowercaseAlpha

public static boolean isLowercaseAlpha(char c)

toUpperAscii

public static char toUpperAscii(char c)

toLowerAscii

public static char toLowerAscii(char c)

indexOf

public static int indexOf(CharSequence seq,
                          CharSequence searchSeq,
                          int startPos)

Finds the first index within a CharSequence, handling null. This method uses String.indexOf(String, int) if possible.

A null CharSequence will return -1. A negative start position is treated as zero. An empty ("") search CharSequence always matches. A start position greater than the string length only matches an empty search CharSequence.

 StringUtils.indexOf(null, *, *)          = -1
 StringUtils.indexOf(*, null, *)          = -1
 StringUtils.indexOf("", "", 0)           = 0
 StringUtils.indexOf("", *, 0)            = -1 (except when * = "")
 StringUtils.indexOf("aabaabaa", "a", 0)  = 0
 StringUtils.indexOf("aabaabaa", "b", 0)  = 2
 StringUtils.indexOf("aabaabaa", "ab", 0) = 1
 StringUtils.indexOf("aabaabaa", "b", 3)  = 5
 StringUtils.indexOf("aabaabaa", "b", 9)  = -1
 StringUtils.indexOf("aabaabaa", "b", -1) = 2
 StringUtils.indexOf("aabaabaa", "", 2)   = 2
 StringUtils.indexOf("abc", "", 9)        = 3
 

参数:

seq - the CharSequence to check, may be null

searchSeq - the CharSequence to find, may be null

startPos - the start position, negative treated as zero

返回:

the first index of the search CharSequence (always ≥ startPos), -1 if no match or null string input

从以下版本开始:

2.0, 3.0 Changed signature from indexOf(String, String, int) to indexOf(CharSequence, CharSequence, int)

indexOf

public static int indexOf(CharSequence seq,
                          CharSequence searchSeq)

Finds the first index within a CharSequence, handling null. This method uses String.indexOf(String, int) if possible.

A null CharSequence will return -1.

 StringUtils.indexOf(null, *)          = -1
 StringUtils.indexOf(*, null)          = -1
 StringUtils.indexOf("", "")           = 0
 StringUtils.indexOf("", *)            = -1 (except when * = "")
 StringUtils.indexOf("aabaabaa", "a")  = 0
 StringUtils.indexOf("aabaabaa", "b")  = 2
 StringUtils.indexOf("aabaabaa", "ab") = 1
 StringUtils.indexOf("aabaabaa", "")   = 0
 

参数:

seq - the CharSequence to check, may be null

searchSeq - the CharSequence to find, may be null

返回:

the first index of the search CharSequence, -1 if no match or null string input

从以下版本开始:

2.0, 3.0 Changed signature from indexOf(String, String) to indexOf(CharSequence, CharSequence)

lastIndexOf

public static int lastIndexOf(CharSequence seq,
                              int searchChar)

Returns the index within seq of the last occurrence of the specified character. For values of searchChar in the range from 0 to 0xFFFF (inclusive), the index (in Unicode code units) returned is the largest value k such that:

 this.charAt(k) == searchChar
 

is true. For other values of searchChar, it is the largest value k such that:

 this.codePointAt(k) == searchChar
 

is true. In either case, if no such character occurs in this string, then -1 is returned. Furthermore, a null or empty ("") CharSequence will return -1. The seq CharSequence object is searched backwards starting at the last character.

 StringUtils.lastIndexOf(null, *)         = -1
 StringUtils.lastIndexOf("", *)           = -1
 StringUtils.lastIndexOf("aabaabaa", 'a') = 7
 StringUtils.lastIndexOf("aabaabaa", 'b') = 5
 

参数:

seq - the CharSequence to check, may be null

searchChar - the character to find

返回:

the last index of the search character, -1 if no match or null string input

从以下版本开始:

2.0, 3.0 Changed signature from lastIndexOf(String, int) to lastIndexOf(CharSequence, int), 3.6 Updated CharSequenceUtils call to behave more like String

lastIndexOf

public static int lastIndexOf(CharSequence seq,
                              int searchChar,
                              int startPos)

Returns the index within seq of the last occurrence of the specified character, searching backward starting at the specified index. For values of searchChar in the range from 0 to 0xFFFF (inclusive), the index returned is the largest value k such that:

 (this.charAt(k) == searchChar) && (k <= startPos)
 

is true. For other values of searchChar, it is the largest value k such that:

 (this.codePointAt(k) == searchChar) && (k <= startPos)
 

is true. In either case, if no such character occurs in seq at or before position startPos, then -1 is returned. Furthermore, a null or empty ("") CharSequence will return -1. A start position greater than the string length searches the whole string. The search starts at the startPos and works backwards; matches starting after the start position are ignored.

All indices are specified in char values (Unicode code units).

 StringUtils.lastIndexOf(null, *, *)          = -1
 StringUtils.lastIndexOf("", *,  *)           = -1
 StringUtils.lastIndexOf("aabaabaa", 'b', 8)  = 5
 StringUtils.lastIndexOf("aabaabaa", 'b', 4)  = 2
 StringUtils.lastIndexOf("aabaabaa", 'b', 0)  = -1
 StringUtils.lastIndexOf("aabaabaa", 'b', 9)  = 5
 StringUtils.lastIndexOf("aabaabaa", 'b', -1) = -1
 StringUtils.lastIndexOf("aabaabaa", 'a', 0)  = 0
 

参数:

seq - the CharSequence to check, may be null

searchChar - the character to find

startPos - the start position

返回:

the last index of the search character (always ≤ startPos), -1 if no match or null string input

从以下版本开始:

2.0, 3.0 Changed signature from lastIndexOf(String, int, int) to lastIndexOf(CharSequence, int, int)

lastIndexOf

public static int lastIndexOf(CharSequence seq,
                              CharSequence searchSeq)

Finds the last index within a CharSequence, handling null. This method uses String.lastIndexOf(String) if possible.

A null CharSequence will return -1.

 StringUtils.lastIndexOf(null, *)          = -1
 StringUtils.lastIndexOf(*, null)          = -1
 StringUtils.lastIndexOf("", "")           = 0
 StringUtils.lastIndexOf("aabaabaa", "a")  = 7
 StringUtils.lastIndexOf("aabaabaa", "b")  = 5
 StringUtils.lastIndexOf("aabaabaa", "ab") = 4
 StringUtils.lastIndexOf("aabaabaa", "")   = 8
 

参数:

seq - the CharSequence to check, may be null

searchSeq - the CharSequence to find, may be null

返回:

the last index of the search String, -1 if no match or null string input

从以下版本开始:

2.0, 3.0 Changed signature from lastIndexOf(String, String) to lastIndexOf(CharSequence, CharSequence)

substring

public static String substring(String str,
                               int start)

Gets a substring from the specified String avoiding exceptions.

A negative start position can be used to start n characters from the end of the String.

A null String will return null. An empty ("") String will return "".

 StringUtils.substring(null, *)   = null
 StringUtils.substring("", *)     = ""
 StringUtils.substring("abc", 0)  = "abc"
 StringUtils.substring("abc", 2)  = "c"
 StringUtils.substring("abc", 4)  = ""
 StringUtils.substring("abc", -2) = "bc"
 StringUtils.substring("abc", -4) = "abc"
 

参数:

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

返回:

substring from start position, null if null String input

substring

public static String substring(String str,
                               int start,
                               int end)

Gets a substring from the specified String avoiding exceptions.

A negative start position can be used to start/end n characters from the end of the String.

The returned substring starts with the character in the start position and ends before the end position. All position counting is zero-based -- i.e., to start at the beginning of the string use start = 0. Negative start and end positions can be used to specify offsets relative to the end of the String.

If start is not strictly to the left of end, "" is returned.

 StringUtils.substring(null, *, *)    = null
 StringUtils.substring("", * ,  *)    = "";
 StringUtils.substring("abc", 0, 2)   = "ab"
 StringUtils.substring("abc", 2, 0)   = ""
 StringUtils.substring("abc", 2, 4)   = "c"
 StringUtils.substring("abc", 4, 6)   = ""
 StringUtils.substring("abc", 2, 2)   = ""
 StringUtils.substring("abc", -2, -1) = "b"
 StringUtils.substring("abc", -4, 2)  = "ab"
 

参数:

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

返回:

substring from start position to end position, null if null String input