ArrayByteSource (OpenGamma Strata Collect)

java.lang.Object
- com.google.common.io.ByteSource
- - com.opengamma.strata.collect.io.BeanByteSource
  - - com.opengamma.strata.collect.io.ArrayByteSource

All Implemented Interfaces:

Serializable, org.joda.beans.Bean, org.joda.beans.ImmutableBean
```
public final class ArrayByteSource
extends BeanByteSource
implements org.joda.beans.ImmutableBean, Serializable
```
A byte source implementation that explicitly wraps a byte array.
This implementation allows IOException to be avoided in many cases, and to be able to create and retrieve the internal array unsafely.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static ArrayByteSource EMPTY
An empty source.

Fields
Modifier and Type	Field and Description
`static ArrayByteSource`	`EMPTY` An empty source.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`CharSource`	`asCharSourceUtf8UsingBom()` Returns a `CharSource` for the same bytes, converted to UTF-8 using a Byte-Order Mark if available.
`boolean`	`contentEquals(ByteSource other)`
`static ArrayByteSource`	`copyOf(byte[] array)` Creates an instance, copying the array.
`static ArrayByteSource`	`copyOf(byte[] array, int fromIndex)` Obtains an instance by copying part of an array.
`static ArrayByteSource`	`copyOf(byte[] array, int fromIndexInclusive, int toIndexExclusive)` Obtains an instance by copying part of an array.
`long`	`copyTo(OutputStream output)`
`boolean`	`equals(Object obj)`
`static ArrayByteSource`	`from(ByteSource other)` Creates an instance from another byte source.
`static ArrayByteSource`	`from(CheckedSupplier<InputStream> inputStreamSupplier)` Creates an instance from an input stream.
`static ArrayByteSource`	`fromBase64(String base64)` Creates an instance from a base-64 encoded string.
`static ArrayByteSource`	`fromHex(String hex)` Creates an instance from a hex encoded string, sometimes referred to as base-16.
`HashCode`	`hash(HashFunction hashFunction)`
`int`	`hashCode()`
`boolean`	`isEmpty()` Checks if the byte source is empty, throwing an unchecked exception.
`org.joda.beans.MetaBean`	`metaBean()`
`static ArrayByteSource`	`ofUnsafe(byte[] array)` Creates an instance, not copying the array.
`static ArrayByteSource`	`ofUtf8(String str)` Creates an instance from a string using UTF-8.
`ByteArrayInputStream`	`openBufferedStream()`
`ByteArrayInputStream`	`openStream()`
`byte[]`	`read()` Reads the source as a byte array, throwing an unchecked exception.
`<T> T`	`read(ByteProcessor<T> processor)`
`byte[]`	`readUnsafe()` Returns the underlying array.
`String`	`readUtf8()` Reads the source, converting to UTF-8.
`String`	`readUtf8UsingBom()` Reads the source, converting to UTF-8 using a Byte-Order Mark if available.
`long`	`size()` Gets the size of the byte source, throwing an unchecked exception.
`Optional<Long>`	`sizeIfKnown()` Gets the size, which is always known.
`ArrayByteSource`	`slice(long offset, long length)`
`ArrayByteSource`	`toBase64()` Encodes the byte source using base-64.
`String`	`toBase64String()` Encodes the byte source using base-64, returning a string.
`String`	`toHexString()` Encodes the byte source using hex, sometimes referred to as base-16, returning a string.
`ArrayByteSource`	`toMd5()` Returns the MD5 hash of the bytes.
`ArrayByteSource`	`toSha512()` Returns the SHA-512 hash of the bytes.
`String`	`toString()`

Methods inherited from class com.opengamma.strata.collect.io.BeanByteSource
asCharSourceUtf8, load

Methods inherited from class com.google.common.io.ByteSource
asCharSource, concat, concat, concat, copyTo, empty, wrap

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.joda.beans.Bean
property, propertyNames

- Field Detail
  - EMPTY
```
public static final ArrayByteSource EMPTY
```
    An empty source.
- Method Detail
  - copyOf
```
public static ArrayByteSource copyOf(byte[] array)
```
    Creates an instance, copying the array.
    
    Parameters:
    
    array - the array, copied
    
    Returns:
    
    the byte source
  - copyOf
```
public static ArrayByteSource copyOf(byte[] array,
                                     int fromIndex)
```
    Obtains an instance by copying part of an array.
    The input array is copied and not mutated.
    
    Parameters:
    
    array - the array to copy
    
    fromIndex - the offset from the start of the array
    
    Returns:
    
    an array containing the specified values
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - copyOf
```
public static ArrayByteSource copyOf(byte[] array,
                                     int fromIndexInclusive,
                                     int toIndexExclusive)
```
    Obtains an instance by copying part of an array.
    The input array is copied and not mutated.
    
    Parameters:
    
    array - the array to copy
    
    fromIndexInclusive - the start index of the input array to copy from
    
    toIndexExclusive - the end index of the input array to copy to
    
    Returns:
    
    an array containing the specified values
    
    Throws:
    
    IndexOutOfBoundsException - if the index is invalid
  - ofUnsafe
```
public static ArrayByteSource ofUnsafe(byte[] array)
```
    Creates an instance, not copying the array.
    This method is inherently unsafe as it relies on good behavior by callers. Callers must never make any changes to the passed in array after calling this method. Doing so would violate the immutability of this class.
    
    Parameters:
    
    array - the array, not copied
    
    Returns:
    
    the byte source
  - ofUtf8
```
public static ArrayByteSource ofUtf8(String str)
```
    Creates an instance from a string using UTF-8.
    
    Parameters:
    
    str - the string to store using UTF-8
    
    Returns:
    
    the byte source
  - from
```
public static ArrayByteSource from(ByteSource other)
```
    Creates an instance from another byte source.
    
    Parameters:
    
    other - the other byte source
    
    Returns:
    
    the byte source
    
    Throws:
    
    UncheckedIOException - if an IO error occurs
  - from
```
public static ArrayByteSource from(CheckedSupplier<InputStream> inputStreamSupplier)
```
    Creates an instance from an input stream.
    This method use the supplier to open the input stream, extract the bytes and close the stream. It is intended that invoking the supplier opens the stream. It is not intended that an already open stream is supplied.
    
    Parameters:
    
    inputStreamSupplier - the supplier of the input stream
    
    Returns:
    
    the byte source
    
    Throws:
    
    UncheckedIOException - if an IO error occurs
  - fromBase64
```
public static ArrayByteSource fromBase64(String base64)
```
    Creates an instance from a base-64 encoded string.
    
    Parameters:
    
    base64 - the base64 string to convert
    
    Returns:
    
    the decoded byte source
    
    Throws:
    
    IllegalArgumentException - if the input is not Base64 encoded
  - fromHex
```
public static ArrayByteSource fromHex(String hex)
```
    Creates an instance from a hex encoded string, sometimes referred to as base-16.
    
    Parameters:
    
    hex - the hex string to convert
    
    Returns:
    
    the decoded byte source
    
    Throws:
    
    IllegalArgumentException - if the input is not hex encoded
  - metaBean
```
public org.joda.beans.MetaBean metaBean()
```
    Specified by:
    
    metaBean in interface org.joda.beans.Bean
  - readUnsafe
```
public byte[] readUnsafe()
```
    Returns the underlying array.
    This method is inherently unsafe as it relies on good behavior by callers. Callers must never make any changes to the array returned by this method. Doing so would violate the immutability of this class.
    
    Returns:
    
    the raw array
  - readUtf8
```
public String readUtf8()
```
    Reads the source, converting to UTF-8.
    
    Overrides:
    
    readUtf8 in class BeanByteSource
    
    Returns:
    
    the UTF-8 string
  - readUtf8UsingBom
```
public String readUtf8UsingBom()
```
    Reads the source, converting to UTF-8 using a Byte-Order Mark if available.
    
    Overrides:
    
    readUtf8UsingBom in class BeanByteSource
    
    Returns:
    
    the UTF-8 string
  - asCharSourceUtf8UsingBom
```
public CharSource asCharSourceUtf8UsingBom()
```
    Returns a CharSource for the same bytes, converted to UTF-8 using a Byte-Order Mark if available.
    
    Overrides:
    
    asCharSourceUtf8UsingBom in class BeanByteSource
    
    Returns:
    
    the equivalent CharSource
  - toMd5
```
public ArrayByteSource toMd5()
```
    Returns the MD5 hash of the bytes.
    
    Returns:
    
    the MD5 hash
  - toSha512
```
public ArrayByteSource toSha512()
```
    Returns the SHA-512 hash of the bytes.
    
    Returns:
    
    the SHA-512 hash
  - toBase64
```
public ArrayByteSource toBase64()
```
    Encodes the byte source using base-64.
    
    Returns:
    
    the base-64 encoded form
  - toBase64String
```
public String toBase64String()
```
    Encodes the byte source using base-64, returning a string.
    Equivalent to toBase64().readUtf8().
    
    Returns:
    
    the base-64 encoded string
  - toHexString
```
public String toHexString()
```
    Encodes the byte source using hex, sometimes referred to as base-16, returning a string.
    
    Returns:
    
    the hex encoded string
  - openStream
```
public ByteArrayInputStream openStream()
```
    Specified by:
    
    openStream in class ByteSource
  - openBufferedStream
```
public ByteArrayInputStream openBufferedStream()
```
    Overrides:
    
    openBufferedStream in class ByteSource
  - isEmpty
```
public boolean isEmpty()
```
    Description copied from class: BeanByteSource
    
    Checks if the byte source is empty, throwing an unchecked exception.
    This overrides ByteSource to throw UncheckedIOException instead of IOException.
    
    Overrides:
    
    isEmpty in class BeanByteSource
  - sizeIfKnown
```
public Optional<Long> sizeIfKnown()
```
    Gets the size, which is always known.
    
    Overrides:
    
    sizeIfKnown in class ByteSource
    
    Returns:
    
    the size, which is always known
  - size
```
public long size()
```
    Description copied from class: BeanByteSource
    
    Gets the size of the byte source, throwing an unchecked exception.
    This overrides ByteSource to throw UncheckedIOException instead of IOException.
    
    Overrides:
    
    size in class BeanByteSource
  - slice
```
public ArrayByteSource slice(long offset,
                             long length)
```
    Overrides:
    
    slice in class ByteSource
  - copyTo
```
public long copyTo(OutputStream output)
            throws IOException
```
    Overrides:
    
    copyTo in class ByteSource
    
    Throws:
    
    IOException
  - read
```
public byte[] read()
```
    Description copied from class: BeanByteSource
    
    Reads the source as a byte array, throwing an unchecked exception.
    This overrides ByteSource to throw UncheckedIOException instead of IOException.
    
    Overrides:
    
    read in class BeanByteSource
    
    Returns:
    
    the byte array
  - read
```
public <T> T read(ByteProcessor<T> processor)
           throws IOException
```
    Overrides:
    
    read in class ByteSource
    
    Throws:
    
    IOException
  - hash
```
public HashCode hash(HashFunction hashFunction)
```
    Overrides:
    
    hash in class ByteSource
  - contentEquals
```
public boolean contentEquals(ByteSource other)
                      throws IOException
```
    Overrides:
    
    contentEquals in class ByteSource
    
    Throws:
    
    IOException
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Copyright 2009-Present by OpenGamma Inc. and individual contributors
Apache v2 licensed
Additional documentation can be found at strata.opengamma.io.

Class ArrayByteSource

Field Summary

Method Summary

Methods inherited from class com.opengamma.strata.collect.io.BeanByteSource

Methods inherited from class com.google.common.io.ByteSource

Methods inherited from class java.lang.Object

Methods inherited from interface org.joda.beans.Bean

Field Detail

EMPTY

Method Detail

copyOf

copyOf

copyOf

ofUnsafe

ofUtf8

from

from

fromBase64

fromHex

metaBean

readUnsafe

readUtf8

readUtf8UsingBom

asCharSourceUtf8UsingBom

toMd5

toSha512

toBase64

toBase64String

toHexString

openStream

openBufferedStream

isEmpty

sizeIfKnown

size

slice

copyTo

read

read

hash

contentEquals

equals

hashCode

toString