Package org.apache.qpid.server.util

Class Strings

  • public final class Strings
extends java.lang.Object
    String utilities

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  Strings.ChainedResolver
      Chains two resolvers trying to resolve variable against first one and if unsuccessful against second one
      static class  Strings.MapResolver
      Resolves variable from a map.
      static interface  Strings.Resolver
      Resolver variable using supplied resolver

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static Strings.Resolver chain​(Strings.Resolver... resolvers)
      Chains several resolvers into a ChainedResolver instance
      static void clearByteArray​(byte[]... bytes)
      Fills byte arrays with blank characters
      static Strings.Resolver createSubstitutionResolver​(java.lang.String prefix, java.util.LinkedHashMap<java.lang.String,​java.lang.String> substitutions)
      Creates substitution resolver
      static byte[] decodeBase64​(java.lang.String base64String)
      Decodes base64 encoded string into a byte array
      static byte[] decodeCharArray​(char[] base64Chars, java.lang.String description)
      Decodes base64 encoded char array into a byte array
      static byte[] decodePrivateBase64​(java.lang.String base64String, java.lang.String description)
      Decodes base64 encoded string into a byte array
      static java.lang.String expand​(java.lang.String input, boolean failOnUnresolved, Strings.Resolver... resolvers)
      Expands string replacing variables it contains with variable values
      static java.lang.String expand​(java.lang.String input, Strings.Resolver resolver)
      Expands string replacing variables it contains with variable values
      static java.lang.String hexDump​(java.nio.ByteBuffer buf)
      Dumps bytes in the textual format used by UNIX od(1) in hex (x4) mode i.e.
      static java.lang.String join​(java.lang.String sep, java.lang.Iterable<?> items)
      Joins string representation of an object iterable
      static java.lang.String join​(java.lang.String sep, java.lang.Object[] items)
      Joins string representation of an object array
      static java.util.List<java.lang.String> split​(java.lang.String listAsString)
      Splits source string into a liast of tokens separated by comma
      static ClearableCharSequence toCharSequence​(java.lang.Object object)
      Converts an object to the ClearableCharSequence
      static byte[] toUTF8​(java.lang.String str)
      Converts string to the UTF8 encoded byte array

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • ENV_VARS_RESOLVER

        public static final Strings.Resolver ENV_VARS_RESOLVER
        Environment variable resolver

      • JAVA_SYS_PROPS_RESOLVER

        public static final Strings.Resolver JAVA_SYS_PROPS_RESOLVER
        System property resolver

      • SYSTEM_RESOLVER

        public static final Strings.Resolver SYSTEM_RESOLVER
        System resolver chaining environment variable and system property resolvers

    • Method Detail

      • chain

        public static Strings.Resolver chain​(Strings.Resolver... resolvers)
        Chains several resolvers into a ChainedResolver instance
        Parameters:
        resolvers - Resolvers to be chained
        Returns:
        Resulting ChainedResolver

      • toUTF8

        public static byte[] toUTF8​(java.lang.String str)
        Converts string to the UTF8 encoded byte array
        Parameters:
        str - Source string
        Returns:
        Byte array

      • decodePrivateBase64

        public static byte[] decodePrivateBase64​(java.lang.String base64String,
                                         java.lang.String description)
        Decodes base64 encoded string into a byte array
        Parameters:
        base64String - Base64 encoded string
        description - String description provided for logging purposes
        Returns:
        Resulting byte array

      • decodeCharArray

        public static byte[] decodeCharArray​(char[] base64Chars,
                                     java.lang.String description)
        Decodes base64 encoded char array into a byte array
        Parameters:
        base64Chars - Base64 encoded char array
        description - String description provided for logging purposes
        Returns:
        Resulting byte array

      • clearByteArray

        public static void clearByteArray​(byte[]... bytes)
        Fills byte arrays with blank characters
        Parameters:
        bytes - Byte arrays to be cleared

      • toCharSequence

        public static ClearableCharSequence toCharSequence​(java.lang.Object object)
        Converts an object to the ClearableCharSequence
        Parameters:
        object - Object to convert
        Returns:
        ClearableCharSequence instance

      • decodeBase64

        public static byte[] decodeBase64​(java.lang.String base64String)
        Decodes base64 encoded string into a byte array
        Parameters:
        base64String - Base64 encoded string
        Returns:
        Resulting byte array

      • expand

        public static java.lang.String expand​(java.lang.String input,
                                      Strings.Resolver resolver)
        Expands string replacing variables it contains with variable values
        Parameters:
        input - Source string
        resolver - Resolver to use
        Returns:
        Expanded string

      • expand

        public static java.lang.String expand​(java.lang.String input,
                                      boolean failOnUnresolved,
                                      Strings.Resolver... resolvers)
        Expands string replacing variables it contains with variable values
        Parameters:
        input - Source string
        failOnUnresolved - Boolean flag defining if an exception should be thrown in case of failed resolution
        resolvers - Resolvers to use
        Returns:
        Expanded string

      • join

        public static java.lang.String join​(java.lang.String sep,
                                    java.lang.Iterable<?> items)
        Joins string representation of an object iterable
        Parameters:
        sep - Separator
        items - Object iterable
        Returns:
        Resulting string

      • join

        public static java.lang.String join​(java.lang.String sep,
                                    java.lang.Object[] items)
        Joins string representation of an object array
        Parameters:
        sep - Separator
        items - Object array
        Returns:
        Resulting string

      • split

        public static java.util.List<java.lang.String> split​(java.lang.String listAsString)
        Splits source string into a liast of tokens separated by comma
        Parameters:
        listAsString - Source string
        Returns:
        List of tokens

      • hexDump

        public static java.lang.String hexDump​(java.nio.ByteBuffer buf)
        Dumps bytes in the textual format used by UNIX od(1) in hex (x4) mode i.e. od -Ax -tx1 -v. This format is understood by Wireshark "Import from HexDump" feature so is useful for dumping buffers containing AMQP 1.0 byte-streams for diagnostic purposes.
        Parameters:
        buf - - buffer to be dumped. Buffer will be unchanged.

      • createSubstitutionResolver

        public static Strings.Resolver createSubstitutionResolver​(java.lang.String prefix,
                                                          java.util.LinkedHashMap<java.lang.String,​java.lang.String> substitutions)
        Creates substitution resolver
        Parameters:
        prefix - Substitution prefix
        substitutions - Map of substituitions
        Returns:
        StringSubstitutionResolver