com.bigdata.rdf.internal.encoder

Interface IBindingSetDecoder

All Known Implementing Classes:

IVBindingSetEncoder, IVBindingSetEncoderWithIVCache, IVSolutionSetDecoder

public interface IBindingSetDecoder

Interface for decoding IBindingSets comprised of IVs.

Version:

$Id$

Author:

Bryan Thompson

See Also:

IBindingSetEncoder

Method Summary

Methods

Modifier and Type	Method and Description
IBindingSet	decodeSolution(byte[] val, int off, int len, boolean resolveCachedValues) Decode an IBindingSet.
boolean	isValueCache() Return true iff the IVCache associations are preserved by the encoder.
void	release() Release the state associated with the IVBindingSetDecoder.
void	resolveCachedValues(IBindingSet bset) Resolve any IVs in the solution for which there are cached BigdataValues to those values.

Method Detail

isValueCache

boolean isValueCache()

Return true iff the IVCache associations are preserved by the encoder.

decodeSolution

IBindingSet decodeSolution(byte[] val,
                         int off,
                         int len,
                         boolean resolveCachedValues)

Decode an IBindingSet.

The resolution step can be deferred when the decoded IBindingSet does not require the resolved IVCache associations. For example, we do not need the IVCache association in order to decide if two IBindingSets can join. However, once we have a solution from a join, we may need to resolve the IVCache metadata for the joined solution.

Parameters:

val - The encoded IV[].

off - The starting offset.

len - The #of bytes of data to be decoded.

resolveCachedValues - When true, any decoded IVs will have their IVCache association resolved before the IBindingSet is returned to the caller. When false, the resolution step is not performed.

Returns:

The decoded IBindingSet.

See Also:

resolveCachedValues(IBindingSet)

resolveCachedValues

void resolveCachedValues(IBindingSet bset)

Resolve any IVs in the solution for which there are cached BigdataValues to those values. This method may be used to resolve IVCache associations for IBindingSets NOT produced by decodeSolution(byte[], int, int, boolean). For example, when joining a decoded solution with another solution, the resolution step may be deferred until we know whether or not the join was successful.

Parameters:

bset - A solution having IVs which need to be reunited with their cached BigdataValues.

release

void release()

Release the state associated with the IVBindingSetDecoder.