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