org.elasticsearch.common.bytes

Class BytesReference

java.lang.Object

org.elasticsearch.common.bytes.BytesReference

All Implemented Interfaces:

java.lang.Comparable<BytesReference>, org.apache.lucene.util.Accountable

Direct Known Subclasses:

BytesArray, CompositeBytesReference, PagedBytesReference

public abstract class BytesReference
extends java.lang.Object
implements org.apache.lucene.util.Accountable, java.lang.Comparable<BytesReference>

A reference to bytes.

Constructor Summary

Constructors

Constructor and Description
BytesReference()

Method Summary

Modifier and Type	Method and Description
int	compareTo(BytesReference other)
boolean	equals(java.lang.Object other)
abstract byte	get(int index) Returns the byte at the specified index.
int	hashCode()
org.apache.lucene.util.BytesRefIterator	iterator() Returns a BytesRefIterator for this BytesReference.
abstract int	length() The length.
abstract BytesReference	slice(int from, int length) Slice the bytes from the from index up to length.
StreamInput	streamInput() A stream input of the bytes.
static byte[]	toBytes(BytesReference reference) Returns a compact array from the given BytesReference.
abstract org.apache.lucene.util.BytesRef	toBytesRef() Converts to Lucene BytesRef.
java.lang.String	utf8ToString() Interprets the referenced bytes as UTF8 bytes, returning the resulting string
void	writeTo(java.io.OutputStream os) Writes the bytes directly to the output stream.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.lucene.util.Accountable

getChildResources, ramBytesUsed

Constructor Detail

BytesReference

public BytesReference()

Method Detail

get

public abstract byte get(int index)

Returns the byte at the specified index. Need to be between 0 and length.

length

public abstract int length()

The length.

slice

public abstract BytesReference slice(int from,
                                     int length)

Slice the bytes from the from index up to length.

streamInput

public StreamInput streamInput()
                        throws java.io.IOException

A stream input of the bytes.

Throws:

java.io.IOException

writeTo

public void writeTo(java.io.OutputStream os)
             throws java.io.IOException

Writes the bytes directly to the output stream.

Throws:

java.io.IOException

utf8ToString

public java.lang.String utf8ToString()

Interprets the referenced bytes as UTF8 bytes, returning the resulting string

toBytesRef

public abstract org.apache.lucene.util.BytesRef toBytesRef()

Converts to Lucene BytesRef.

iterator

public org.apache.lucene.util.BytesRefIterator iterator()

Returns a BytesRefIterator for this BytesReference. This method allows access to the internal pages of this reference without copying them. Use with care!

See Also:

BytesRefIterator

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toBytes

public static byte[] toBytes(BytesReference reference)

Returns a compact array from the given BytesReference. The returned array won't be copied unless necessary. If you need to modify the returned array use BytesRef.deepCopyOf(reference.toBytesRef() instead

compareTo

public int compareTo(BytesReference other)

Specified by:

compareTo in interface java.lang.Comparable<BytesReference>