Package org.apache.tomcat.dbcp.dbcp2
Class Utils
- java.lang.Object
-
- org.apache.tomcat.dbcp.dbcp2.Utils
-
public final class Utils extends Object
Utility methods.- Since:
- 2.0
-
-
Field Summary
Fields Modifier and Type Field Description static StringDISCONNECTION_SQL_CODE_PREFIXAny SQL_STATE starting with this value is considered a fatal disconnectstatic Set<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 PropertiescloneWithoutCredentials(Properties properties)Clones the givenPropertieswithout the standard "user" or "password" entries.static voidclose(AutoCloseable autoCloseable, Consumer<Exception> exceptionHandler)Closes the givenAutoCloseableand if an exception is caught, then callsexceptionHandler.static voidcloseQuietly(AutoCloseable autoCloseable)Closes the AutoCloseable (which may be null).static voidcloseQuietly(Connection connection)Deprecated.static voidcloseQuietly(ResultSet resultSet)Deprecated.static voidcloseQuietly(Statement statement)Deprecated.static Set<String>getDisconnectionSqlCodes()Gets a copy of SQL codes of fatal connection errors.static StringgetMessage(String key)Gets the correct i18n message for the given key.static StringgetMessage(String key, Object... args)Gets the correct i18n message for the given key with placeholders replaced by the supplied arguments.static char[]toCharArray(String value)Converts the given String to a char[].static StringtoString(char[] value)Converts the given char[] to a String.static voidvalidateLifetime(PooledObject<?> p, 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 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 Set<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 Properties cloneWithoutCredentials(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(AutoCloseable autoCloseable, Consumer<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(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(Connection connection)
Deprecated.Closes the Connection (which may be null).- Parameters:
connection- a Connection, may benull
-
closeQuietly
@Deprecated public static void closeQuietly(ResultSet resultSet)
Deprecated.Closes the ResultSet (which may be null).- Parameters:
resultSet- a ResultSet, may benull
-
closeQuietly
@Deprecated public static void closeQuietly(Statement statement)
Deprecated.Closes the Statement (which may be null).- Parameters:
statement- a Statement, may benull.
-
getDisconnectionSqlCodes
public static Set<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 String getMessage(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 String getMessage(String key, 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(String value)
Converts the given String to a char[].- Parameters:
value- may be null.- Returns:
- a char[] or null.
-
toString
public static 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, Duration maxDuration) throws org.apache.tomcat.dbcp.dbcp2.LifetimeExceededException
- Throws:
org.apache.tomcat.dbcp.dbcp2.LifetimeExceededException
-
-