Package org.apache.jackrabbit.oak.segment

Class SegmentBlob

java.lang.Object

org.apache.jackrabbit.oak.segment.SegmentBlob

All Implemented Interfaces:

Blob

public class SegmentBlob
extends Object
implements Blob

A BLOB (stream of bytes). This is a record of type "VALUE".

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object object)
@Nullable String	getBlobId()
static Iterable<SegmentId>	getBulkSegmentIds(Blob blob)
String	getContentIdentity()	A unique identifier of the content of this value.
@NotNull GCGeneration	getGcGeneration()	Get the underlying segment's gc generation.
@NotNull InputStream	getNewStream()	Returns a new stream for this blob.
RecordId	getRecordId()	Returns the identifier of this record.
protected int	getRecordNumber()
@Nullable String	getReference()	Returns a secure reference to this blob, or null if such a reference is not available.
protected Segment	getSegment()	Returns the segment that contains this record.
int	hashCode()
boolean	isExternal()
boolean	isInlined()	Checks if the external blob is inlined in the id itself
long	length()	Returns the length of this blob or -1 if unknown.
static @Nullable String	readBlobId(@NotNull Segment segment, int recordNumber)
static @Nullable String	readBlobId(@NotNull Segment segment, int recordNumber, Map<SegmentId,Segment> recoveredSegments)
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getBulkSegmentIds

public static Iterable<SegmentId> getBulkSegmentIds(Blob blob)

getNewStream

@NotNull
public @NotNull InputStream getNewStream()

Description copied from interface: Blob

Returns a new stream for this blob. The streams returned from multiple calls to this method are byte wise equals. That is, subsequent calls to read return the same sequence of bytes as long as neither call throws an exception.

Specified by:

getNewStream in interface Blob

Returns:

a new stream for this blob

length

public long length()

Description copied from interface: Blob

Returns the length of this blob or -1 if unknown.

Specified by:

length in interface Blob

Returns:

the length of this blob.

getReference

@Nullable
public @Nullable String getReference()

Description copied from interface: Blob

Returns a secure reference to this blob, or null if such a reference is not available.

Specified by:

getReference in interface Blob

Returns:

binary reference, or null

See Also:

OAK-834

getContentIdentity

public String getContentIdentity()

Description copied from interface: Blob

A unique identifier of the content of this value. Usually this is a message digest of the content (a cryptographically secure one-way hash). This allows to avoid processing large binary values multiple times.

This method returns null if the identifier is unknown. The identifier may not always be available, for example if the value has not yet been saved or processed. Once an identifier is available, it will never change because values are immutable.

If two values have the same identifier, the content of the value is guaranteed to be the same. However it is not guaranteed that two values with the same content will return the same identifier.

The identifier is opaque, meaning it can have any format and size.

Specified by:

getContentIdentity in interface Blob

Returns:

the unique identifier or null

isInlined

public boolean isInlined()

Description copied from interface: Blob

Checks if the external blob is inlined in the id itself

Specified by:

isInlined in interface Blob

Returns:

isExternal

public boolean isExternal()

getBlobId

@Nullable
public @Nullable String getBlobId()

readBlobId

@Nullable
public static @Nullable String readBlobId(@NotNull
                                          @NotNull Segment segment,
                                          int recordNumber)

readBlobId

@Nullable
public static @Nullable String readBlobId(@NotNull
                                          @NotNull Segment segment,
                                          int recordNumber,
                                          Map<SegmentId,Segment> recoveredSegments)

equals

public boolean equals(Object object)

hashCode

public int hashCode()

getSegment

protected Segment getSegment()

Returns the segment that contains this record.

Returns:

segment that contains this record

getRecordNumber

protected int getRecordNumber()

getRecordId

public RecordId getRecordId()

Returns the identifier of this record.

Returns:

record identifier

getGcGeneration

@NotNull
public @NotNull GCGeneration getGcGeneration()

Get the underlying segment's gc generation. Might cause the segment to get loaded if the generation info is missing

Returns:

the segment's gc generation

toString

public String toString()

Overrides:

toString in class Object