org.apache.jackrabbit.oak.segment

Interface SegmentReader

All Known Implementing Classes:

CachingSegmentReader

public interface SegmentReader

Instances of SegmentReader are responsible for reading records from segments.

Passing a record id that cannot be resolved to any of the read methods will eventually result in a SegmentNotFoundException. Implementations are however free to choose to defer such an exception. For example by returning cached data or a thunk to a specific record such that the exception is only thrown when actually accessing the returned record.

The behaviour of the read methods is implementation specific when passing a record id that does not match the type of the expected record.

Method Summary

Modifier and Type	Method and Description
@NotNull SegmentBlob	readBlob(@NotNull RecordId id) Read the blob identified by id.
@NotNull SegmentNodeState	readHeadState(@NotNull Revisions revisions) Read the current head state based on the head of revisions
@NotNull MapRecord	readMap(@NotNull RecordId id) Read the map identified by id.
@NotNull SegmentNodeState	readNode(@NotNull RecordId id) Read the node identified by id.
@NotNull SegmentPropertyState	readProperty(@NotNull RecordId id, @NotNull PropertyTemplate template) Read the property identified by id and template
@NotNull java.lang.String	readString(@NotNull RecordId id) Read the string identified by id.
@NotNull Template	readTemplate(@NotNull RecordId id) Read the template identified by id.

Method Detail

readString

@NotNull
@NotNull java.lang.String readString(@NotNull
                                              @NotNull RecordId id)

Read the string identified by id.

Throws:

SegmentNotFoundException - see class comment for exception semantics

readMap

@NotNull
@NotNull MapRecord readMap(@NotNull
                                    @NotNull RecordId id)

Read the map identified by id.

Throws:

SegmentNotFoundException - see class comment for exception semantics

readTemplate

@NotNull
@NotNull Template readTemplate(@NotNull
                                        @NotNull RecordId id)

Read the template identified by id.

Throws:

SegmentNotFoundException - see class comment for exception semantics

readNode

@NotNull
@NotNull SegmentNodeState readNode(@NotNull
                                            @NotNull RecordId id)

Read the node identified by id.

Throws:

SegmentNotFoundException - see class comment for exception semantics

readHeadState

@NotNull
@NotNull SegmentNodeState readHeadState(@NotNull
                                                 @NotNull Revisions revisions)

Read the current head state based on the head of revisions

Parameters:

revisions -

Throws:

SegmentNotFoundException - see class comment for exception semantics

readProperty

@NotNull
@NotNull SegmentPropertyState readProperty(@NotNull
                                                    @NotNull RecordId id,
                                                    @NotNull
                                                    @NotNull PropertyTemplate template)

Read the property identified by id and template

Throws:

SegmentNotFoundException - see class comment for exception semantics

readBlob

@NotNull
@NotNull SegmentBlob readBlob(@NotNull
                                       @NotNull RecordId id)

Read the blob identified by id.

Throws:

SegmentNotFoundException - see class comment for exception semantics