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 and Description
    --- | ---
    `static String` | `DISCONNECTION_SQL_CODE_PREFIX` Any SQL_STATE starting with this value is considered a fatal disconnect
    `static Set<String>` | `DISCONNECTION_SQL_CODES` SQL codes of fatal connection errors.
    `static boolean` | `IS_SECURITY_ENABLED` Whether the security manager is enabled.

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `static char[]` | `clone(char[] value)` Clones the given char[] if not null.
    `static Properties` | `cloneWithoutCredentials(Properties properties)` Clones the given `Properties` without the standard "user" or "password" entries.
    `static void` | `closeQuietly(AutoCloseable autoCloseable)` Closes the AutoCloseable (which may be null).
    `static String` | `getMessage(String key)` Gets the correct i18n message for the given key.
    `static String` | `getMessage(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 String` | `toString(char[] value)` Converts the given char[] to a String.

    - ### Methods inherited from class java.lang.Object

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

- - ### Field Detail

    - #### IS_SECURITY_ENABLED

          public static final boolean IS_SECURITY_ENABLED

      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

          public static final Set<String> DISCONNECTION_SQL_CODES

      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 given `Properties` without 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

    - #### closeQuietly

          public static void closeQuietly(AutoCloseable autoCloseable)

      Closes the AutoCloseable (which may be null).
      Parameters:
        `autoCloseable` - an AutoCloseable, may be `null`
      Since:
        2.6.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.

Copyright © 2000-2021 Apache Software Foundation. All Rights Reserved.