Package org.apache.tomcat.dbcp.dbcp2
Class Utils
- java.lang.Object
-
- org.apache.tomcat.dbcp.dbcp2.Utils
-
public final class Utils extends java.lang.ObjectUtility methods.- Since:
- 2.0
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.StringDISCONNECTION_SQL_CODE_PREFIXAny SQL_STATE starting with this value is considered a fatal disconnectstatic java.util.Set<java.lang.String>DISCONNECTION_SQL_CODESDeprecated.static booleanIS_SECURITY_ENABLEDDeprecated.No replacement.
-
Method Summary
All Methods Static Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static char[]clone(char[] value)Clones the given char[] if not null.static java.util.PropertiescloneWithoutCredentials(java.util.Properties properties)Clones the givenPropertieswithout the standard "user" or "password" entries.static voidclose(java.lang.AutoCloseable autoCloseable, java.util.function.Consumer<java.lang.Exception> exceptionHandler)Closes the givenAutoCloseableand if an exception is caught, then callsexceptionHandler.static voidcloseQuietly(java.lang.AutoCloseable autoCloseable)Closes the AutoCloseable (which may be null).static voidcloseQuietly(java.sql.Connection connection)Deprecated.static voidcloseQuietly(java.sql.ResultSet resultSet)Deprecated.static voidcloseQuietly(java.sql.Statement statement)Deprecated.static java.util.Set<java.lang.String>getDisconnectionSqlCodes()Gets a copy of SQL codes of fatal connection errors.static java.lang.StringgetMessage(java.lang.String key)Gets the correct i18n message for the given key.static java.lang.StringgetMessage(java.lang.String key, java.lang.Object... args)Gets the correct i18n message for the given key with placeholders replaced by the supplied arguments.static char[]toCharArray(java.lang.String value)Converts the given String to a char[].static java.lang.StringtoString(char[] value)Converts the given char[] to a String.static voidvalidateLifetime(PooledObject<?> p, java.time.Duration maxDuration)
-
-
-
Field Detail
-
IS_SECURITY_ENABLED
@Deprecated public static final boolean IS_SECURITY_ENABLED
Deprecated.No replacement.Whether the security manager is enabled.
-
DISCONNECTION_SQL_CODE_PREFIX
public static final java.lang.String DISCONNECTION_SQL_CODE_PREFIX
Any SQL_STATE starting with this value is considered a fatal disconnect- See Also:
- Constant Field Values
-
DISCONNECTION_SQL_CODES
@Deprecated public static final java.util.Set<java.lang.String> DISCONNECTION_SQL_CODES
Deprecated.SQL codes of fatal connection errors.- 57P01 (Admin shutdown)
- 57P02 (Crash shutdown)
- 57P03 (Cannot connect now)
- 01002 (SQL92 disconnect error)
- JZ0C0 (Sybase disconnect error)
- JZ0C1 (Sybase disconnect error)
-
-
Method Detail
-
clone
public static char[] clone(char[] value)
Clones the given char[] if not null.- Parameters:
value- may be null.- Returns:
- a cloned char[] or null.
-
cloneWithoutCredentials
public static java.util.Properties cloneWithoutCredentials(java.util.Properties properties)
Clones the givenPropertieswithout the standard "user" or "password" entries.- Parameters:
properties- may be null- Returns:
- a clone of the input without the standard "user" or "password" entries.
- Since:
- 2.8.0
-
close
public static void close(java.lang.AutoCloseable autoCloseable, java.util.function.Consumer<java.lang.Exception> exceptionHandler)Closes the givenAutoCloseableand if an exception is caught, then callsexceptionHandler.- Parameters:
autoCloseable- The resource to close.exceptionHandler- Consumes exception thrown closing this resource.- Since:
- 2.10.0
-
closeQuietly
public static void closeQuietly(java.lang.AutoCloseable autoCloseable)
Closes the AutoCloseable (which may be null).- Parameters:
autoCloseable- an AutoCloseable, may benull- Since:
- 2.6.0
-
closeQuietly
@Deprecated public static void closeQuietly(java.sql.Connection connection)
Deprecated.Closes the Connection (which may be null).- Parameters:
connection- a Connection, may benull
-
closeQuietly
@Deprecated public static void closeQuietly(java.sql.ResultSet resultSet)
Deprecated.Closes the ResultSet (which may be null).- Parameters:
resultSet- a ResultSet, may benull
-
closeQuietly
@Deprecated public static void closeQuietly(java.sql.Statement statement)
Deprecated.Closes the Statement (which may be null).- Parameters:
statement- a Statement, may benull.
-
getDisconnectionSqlCodes
public static java.util.Set<java.lang.String> getDisconnectionSqlCodes()
Gets a copy of SQL codes of fatal connection errors.- 57P01 (Admin shutdown)
- 57P02 (Crash shutdown)
- 57P03 (Cannot connect now)
- 01002 (SQL92 disconnect error)
- JZ0C0 (Sybase disconnect error)
- JZ0C1 (Sybase disconnect error)
- Returns:
- SQL codes of fatal connection errors.
- Since:
- 2.10.0
-
getMessage
public static java.lang.String getMessage(java.lang.String key)
Gets the correct i18n message for the given key.- Parameters:
key- The key to look up an i18n message.- Returns:
- The i18n message.
-
getMessage
public static java.lang.String getMessage(java.lang.String key, java.lang.Object... args)Gets the correct i18n message for the given key with placeholders replaced by the supplied arguments.- Parameters:
key- A message key.args- The message arguments.- Returns:
- An i18n message.
-
toCharArray
public static char[] toCharArray(java.lang.String value)
Converts the given String to a char[].- Parameters:
value- may be null.- Returns:
- a char[] or null.
-
toString
public static java.lang.String toString(char[] value)
Converts the given char[] to a String.- Parameters:
value- may be null.- Returns:
- a String or null.
-
validateLifetime
public static void validateLifetime(PooledObject<?> p, java.time.Duration maxDuration) throws org.apache.tomcat.dbcp.dbcp2.LifetimeExceededException
- Throws:
org.apache.tomcat.dbcp.dbcp2.LifetimeExceededException
-
-