Package org.apache.shiro.util

Class ByteSource.Util

  • Enclosing interface:
    ByteSource
    public static final class ByteSource.Util
extends Object
    Utility class that can construct ByteSource instances. This is slightly nicer than needing to know the ByteSource implementation class to use.
    Since:
    1.2

    • Constructor Detail

      • Util

        public Util()

    • Method Detail

      • bytes

        public static ByteSource bytes​(byte[] bytes)
        Returns a new ByteSource instance representing the specified byte array.
        Parameters:
        bytes - the bytes to represent as a ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified byte array.

      • bytes

        public static ByteSource bytes​(char[] chars)
        Returns a new ByteSource instance representing the specified character array's bytes. The byte array is obtained assuming UTF-8 encoding.
        Parameters:
        chars - the character array to represent as a ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified character array's bytes.

      • bytes

        public static ByteSource bytes​(String string)
        Returns a new ByteSource instance representing the specified string's bytes. The byte array is obtained assuming UTF-8 encoding.
        Parameters:
        string - the string to represent as a ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified string's bytes.

      • bytes

        public static ByteSource bytes​(ByteSource source)
        Returns a new ByteSource instance representing the specified ByteSource.
        Parameters:
        source - the ByteSource to represent as a new ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified ByteSource.

      • bytes

        public static ByteSource bytes​(File file)
        Returns a new ByteSource instance representing the specified File's bytes.
        Parameters:
        file - the file to represent as a ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified File's bytes.

      • bytes

        public static ByteSource bytes​(InputStream stream)
        Returns a new ByteSource instance representing the specified InputStream's bytes.
        Parameters:
        stream - the InputStream to represent as a ByteSource instance.
        Returns:
        a new ByteSource instance representing the specified InputStream's bytes.

      • isCompatible

        public static boolean isCompatible​(Object source)
        Returns true if the specified object can be easily represented as a ByteSource using the ByteSource.Util's default heuristics, false otherwise.

        This implementation merely returns SimpleByteSource.isCompatible(source).

        Parameters:
        source - the object to test to see if it can be easily converted to ByteSource instances using default heuristics.
        Returns:
        true if the specified object can be easily represented as a ByteSource using the ByteSource.Util's default heuristics, false otherwise.

      • bytes

        public static ByteSource bytes​(Object source)
                        throws IllegalArgumentException
        Returns a ByteSource instance representing the specified byte source argument. If the argument cannot be easily converted to bytes (as is indicated by the isCompatible(Object) JavaDoc), this method will throw an IllegalArgumentException.
        Parameters:
        source - the byte-backed instance that should be represented as a ByteSource instance.
        Returns:
        a ByteSource instance representing the specified byte source argument.
        Throws:
        IllegalArgumentException - if the argument cannot be easily converted to bytes (as indicated by the isCompatible(Object) JavaDoc)