public abstract class ObjectUtils
extends java.lang.Object
主にフレームワーク内での内部使用向け。
このクラスにいくつかの機能強化を提供してくれた Alex Ruiz に感謝します!
ClassUtils
, CollectionUtils
, StringUtils
コンストラクターと説明 |
---|
ObjectUtils() |
修飾子と型 | メソッドと説明 |
---|---|
static <A,O extends A> | addObjectToArray(A[] array, O obj) 指定されたオブジェクトを指定された配列に追加し、入力配列の内容と指定されたオブジェクトで構成される新しい配列を返します。 |
static <E extends java.lang.Enum<?>> | caseInsensitiveValueOf(E[] enumValues, java.lang.String constant) Enum.valueOf(Class, String) の大文字と小文字を区別しない代替。 |
static boolean | containsConstant(java.lang.Enum<?>[] enumValues, java.lang.String constant) 列挙定数の指定された配列に指定された名前の定数が含まれているかどうかを確認し、一致を判断するときに大文字と小文字を無視します。 |
static boolean | containsConstant(java.lang.Enum<?>[] enumValues, java.lang.String constant, boolean caseSensitive) 指定された列挙定数の配列に、指定された名前の定数が含まれているかどうかを確認します。 |
static boolean | containsElement(java.lang.Object[] array, java.lang.Object element) 指定された配列に指定された要素が含まれているかどうかを確認します。 |
static java.lang.String | getDisplayString(java.lang.Object obj) obj が null でない場合、コンテンツベースの文字列表現を返します。それ以外の場合は、空の文字列を返します。 |
static java.lang.String | getIdentityHexString(java.lang.Object obj) オブジェクトの ID ハッシュコードの 16 進文字列形式を返します。 |
static int | hashCode(boolean bool) 使用すべきではありません。 Spring Framework 5.0 以降、ネイティブの JDK 8 バリアントを推奨 |
static int | hashCode(double dbl) 使用すべきではありません。 Spring Framework 5.0 以降、ネイティブの JDK 8 バリアントを推奨 |
static int | hashCode(float flt) 使用すべきではありません。 Spring Framework 5.0 以降、ネイティブの JDK 8 バリアントを推奨 |
static int | hashCode(long lng) 使用すべきではありません。 Spring Framework 5.0 以降、ネイティブの JDK 8 バリアントを推奨 |
static java.lang.String | identityToString(java.lang.Object obj) オブジェクトの全体的なアイデンティティの文字列表現を返します。 |
static boolean | isArray(java.lang.Object obj) 指定されたオブジェクトが配列であるかどうかを判別します。オブジェクト配列またはプリミティブ配列のいずれかです。 |
static boolean | isCheckedException(java.lang.Throwable ex) 指定されたスロー可能オブジェクトがチェックされた例外であるかどうかを返します。つまり、RuntimeException でもエラーでもありません。 |
static boolean | isCompatibleWithThrowsClause(java.lang.Throwable ex, java.lang.Class<?>... declaredExceptions) 指定された例外が、throws 節で宣言されているように、指定された例外型と互換性があるかどうかを確認します。 |
static boolean | isEmpty(java.lang.Object obj) 指定されたオブジェクトが空かどうかを判別します。 |
static boolean | isEmpty(java.lang.Object[] array) 指定された配列が空かどうかを判断します: すなわち |
static java.lang.String | nullSafeClassName(java.lang.Object obj) 指定されたオブジェクトのクラス名を決定します。 |
static boolean | nullSafeEquals(java.lang.Object o1, java.lang.Object o2) 指定されたオブジェクトが等しいかどうかを判別し、両方が null の場合は true を返し、一方のみが null の場合は false を返します。 |
static int | nullSafeHashCode(boolean[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(byte[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(char[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(double[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(float[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(int[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(long[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(java.lang.Object obj) 指定されたオブジェクトのハッシュコードとして返します。通常は Object#hashCode() } の値です。 |
static int | nullSafeHashCode(java.lang.Object[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static int | nullSafeHashCode(short[] array) 指定された配列の内容に基づいてハッシュコードを返します。 |
static java.lang.String | nullSafeToString(boolean[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(byte[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(char[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(double[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(float[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(int[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(long[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(java.lang.Object obj) 指定されたオブジェクトの文字列表現を返します。 |
static java.lang.String | nullSafeToString(java.lang.Object[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.String | nullSafeToString(short[] array) 指定された配列の内容のストリング表現を返します。 |
static java.lang.Object[] | toObjectArray(java.lang.Object source) 指定された配列(プリミティブ配列の場合があります)をオブジェクト配列に変換します(プリミティブラッパーオブジェクトの場合)。 |
static java.lang.Object | unwrapOptional(java.lang.Object obj) 潜在的に Optional である指定されたオブジェクトをアンラップします。 |
public static boolean isCheckedException(java.lang.Throwable ex)
ex
- チェックするスロー可能オブジェクト Exception
、RuntimeException
、Error
public static boolean isCompatibleWithThrowsClause(java.lang.Throwable ex, @Nullable java.lang.Class<?>... declaredExceptions)
ex
- チェックする例外 declaredExceptions
- throws 句で宣言された例外型 public static boolean isArray(@Nullable java.lang.Object obj)
obj
- チェックするオブジェクト public static boolean isEmpty(@Nullable java.lang.Object[] array)
null
または長さがゼロです。array
- チェックする配列 isEmpty(Object)
public static boolean isEmpty(@Nullable java.lang.Object obj)
このメソッドは、次のオブジェクト型をサポートしています。
Optional
: Optional.empty()
の場合は空と見なされます Array
: 長さがゼロの場合は空と見なされます CharSequence
: 長さがゼロの場合は空と見なされます Collection
: Collection.isEmpty()
へのデリゲート Map
: Map.isEmpty()
へのデリゲート 指定されたオブジェクトが null でなく、前述のサポートされている型のいずれでもない場合、このメソッドは false
を返します。
obj
- チェックするオブジェクト null
または空の場合は true
Optional.isPresent()
, isEmpty(Object[])
, StringUtils.hasLength(CharSequence)
, StringUtils.isEmpty(Object)
, CollectionUtils.isEmpty(java.util.Collection)
, CollectionUtils.isEmpty(java.util.Map)
@Nullable public static java.lang.Object unwrapOptional(@Nullable java.lang.Object obj)
Optional
である指定されたオブジェクトをアンラップします。obj
- 候補オブジェクト Optional
内に保持されている値、Optional
が空の場合は null
、単に指定されたオブジェクトをそのまま public static boolean containsElement(@Nullable java.lang.Object[] array, java.lang.Object element)
array
- チェックする配列 (null
の場合があります。その場合、戻り値は常に false
になります。)element
- チェックする要素 public static boolean containsConstant(java.lang.Enum<?>[] enumValues, java.lang.String constant)
enumValues
- チェックする列挙値、通常は MyEnum.values() の呼び出しの結果 constant
- 検索する定数名 (null または空の文字列であってはなりません)public static boolean containsConstant(java.lang.Enum<?>[] enumValues, java.lang.String constant, boolean caseSensitive)
enumValues
- チェックする列挙値、通常は MyEnum.values() の呼び出しの結果 constant
- 検索する定数名 (null または空の文字列であってはなりません)caseSensitive
- 大文字と小文字が一致を判断する上で重要かどうか public static <E extends java.lang.Enum<?>> E caseInsensitiveValueOf(E[] enumValues, java.lang.String constant)
Enum.valueOf(Class, String)
の大文字と小文字を区別しない代替。E
- 具体的な列挙型 enumValues
- 問題のすべての Enum 定数の配列、通常は Enum.values() ごと constant
- 列挙値を取得する定数 java.lang.IllegalArgumentException
- 指定された定数が指定された列挙値の配列で見つからない場合この例外を回避するには、containsConstant(Enum[], String)
をガードとして使用してください。public static <A,O extends A> A[] addObjectToArray(@Nullable A[] array, @Nullable O obj)
array
- 追加する配列 (null
にすることができます)obj
- 追加するオブジェクト null
)public static java.lang.Object[] toObjectArray(@Nullable java.lang.Object source)
null
ソース値は空のオブジェクト配列に変換されます。
source
- (潜在的にプリミティブな)配列 null
)java.lang.IllegalArgumentException
- パラメーターが配列でない場合 public static boolean nullSafeEquals(@Nullable java.lang.Object o1, @Nullable java.lang.Object o2)
null
の場合は true
を返し、一方のみが null
の場合は false
を返します。 配列を Arrays.equals
と比較し、配列参照ではなく配列要素に基づいて等価性チェックを実行します。
o1
- 比較する最初のオブジェクト o2
- 比較する 2 番目のオブジェクト Object.equals(Object)
, Arrays.equals(long[], long[])
public static int nullSafeHashCode(@Nullable java.lang.Object obj)
Object#hashCode()
} の値です。オブジェクトが配列の場合、このメソッドは、このクラスの配列の nullSafeHashCode
メソッドのいずれかに委譲します。オブジェクトが null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable java.lang.Object[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable boolean[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable byte[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable char[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable double[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable float[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable int[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable long[] array)
array
が null
の場合、このメソッドは 0 を返します。public static int nullSafeHashCode(@Nullable short[] array)
array
が null
の場合、このメソッドは 0 を返します。@Deprecated public static int hashCode(boolean bool)
Boolean.hashCode(boolean)
} と同じ値を返します。@Deprecated public static int hashCode(double dbl)
Double.hashCode(double)
} と同じ値を返します。@Deprecated public static int hashCode(float flt)
Float.hashCode(float)
} と同じ値を返します。@Deprecated public static int hashCode(long lng)
Long.hashCode(long)
} と同じ値を返します。public static java.lang.String identityToString(@Nullable java.lang.Object obj)
obj
- オブジェクト (null
の場合があります)null
の場合は空の String public static java.lang.String getIdentityHexString(java.lang.Object obj)
obj
- オブジェクト public static java.lang.String getDisplayString(@Nullable java.lang.Object obj)
obj
が null
でない場合、コンテンツベースの文字列表現を返します。それ以外の場合は、空の文字列を返します。null
値に対して "null" ではなく空の文字列を返す点で、nullSafeToString(Object)
とは異なります。
obj
- 表示文字列を構築するオブジェクト obj
の表示文字列表現 nullSafeToString(Object)
public static java.lang.String nullSafeClassName(@Nullable java.lang.Object obj)
obj
が null
の場合、"null"
を返します。
obj
- イントロスペクトするオブジェクト (null
の場合があります)public static java.lang.String nullSafeToString(@Nullable java.lang.Object obj)
配列の場合、コンテンツの文字列表現を構築します。obj
が null
の場合、"null"
を返します。
obj
- 文字列表現を構築するオブジェクト obj
の文字列表現 public static java.lang.String nullSafeToString(@Nullable java.lang.Object[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable boolean[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable byte[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable char[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable double[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable float[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable int[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable long[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現 public static java.lang.String nullSafeToString(@Nullable short[] array)
文字列表現は、波括弧("{}"
)で囲まれた配列の要素のリストで構成されます。隣接する要素は、文字 ", "
(コンマの後にスペースが続く)で区切られます。array
が null
の場合、"null"
を返します。
array
- 文字列表現を構築する配列 array
の文字列表現