Class ActorRdfJoinMultiBind

A comunica Multi-way Bind RDF Join Actor.

Hierarchy (View Summary)

ActorRdfJoin<IActorRdfJoinMultiBindTestSideData>
- ActorRdfJoinMultiBind

Constructors

constructor

new ActorRdfJoinMultiBind(
args: IActorRdfJoinMultiBindArgs,
): ActorRdfJoinMultiBind
Parameters
- args: IActorRdfJoinMultiBindArgs
Returns ActorRdfJoinMultiBind
Overrides ActorRdfJoin.constructor
- Defined in actor-rdf-join-inner-multi-bind/lib/ActorRdfJoinMultiBind.ts:38

Properties

`Readonly`beforeActors

beforeActors: Actor<
    IActionRdfJoin,
    IMediatorTypeJoinCoefficients,
    IQueryOperationResultBindings,
    IActorRdfJoinMultiBindTestSideData,
>[] = []

Actor that must be registered in the bus before this actor.

`Readonly`bindOrder

bindOrder: BindOrder

`Readonly`bus

bus: Bus<
    Actor<
        IActionRdfJoin,
        IMediatorTypeJoinCoefficients,
        IQueryOperationResultBindings,
        IActorRdfJoinMultiBindTestSideData,
    >,
    IActionRdfJoin,
    IMediatorTypeJoinCoefficients,
    IQueryOperationResultBindings,
    IActorRdfJoinMultiBindTestSideData,
>

The bus this actor subscribes to.

`Protected` `Readonly`canHandleUndefs

canHandleUndefs: boolean

If this actor can handle undefs overlapping variable bindings.

includeInLogs

includeInLogs: boolean = true

If this actor will be logged in the debugger and physical query plan logger

`Protected` `Readonly`isLeaf

isLeaf: boolean

If this join operator will not invoke any other join or query operations below, and can therefore be considered a leaf of the join plan.

`Protected` `Readonly`limitEntries

limitEntries: number

Can be used by subclasses to indicate the max or min number of streams that can be joined. 0 for infinity. By default, this indicates the max number, but can be inverted by setting limitEntriesMin to true.

`Protected` `Readonly`limitEntriesMin

limitEntriesMin: boolean

If true, the limitEntries field is a lower limit, otherwise, it is an upper limit.

`Readonly`mediatorMergeBindingsContext

mediatorMergeBindingsContext: MediatorMergeBindingsContext

`Readonly`mediatorQueryOperation

mediatorQueryOperation: MediatorQueryOperation

`Readonly`minMaxCardinalityRatio

minMaxCardinalityRatio: number

`Readonly`name

name: string

The name for this actor.

Default

{<rdf:subject>}

`Readonly`physicalName

physicalName: string

`Protected` `Optional` `Readonly`requiresVariableOverlap

requiresVariableOverlap?: boolean

If this join operator must only be used for join entries with (at least partially) common variables.

`Readonly`selectivityModifier

selectivityModifier: number

Methods

canBindWithOperation

canBindWithOperation(operation: Operation): boolean
Parameters
- operation: Operation
Returns boolean
- Defined in actor-rdf-join-inner-multi-bind/lib/ActorRdfJoinMultiBind.ts:171

constructResultMetadata

constructResultMetadata(
    entries: IJoinEntry[],
    metadatas: MetadataBindings[],
    context: IActionContext,
    partialMetadata?: Partial<MetadataBindings>,
    optional?: boolean,
): Promise<MetadataBindings>
Helper function to create a new metadata object for the join result. For required metadata entries that are not provided, sane defaults are calculated.
Parameters
- entries: IJoinEntry[]
  Join entries.
- metadatas: MetadataBindings[]
  Metadata of the join entries.
- context: IActionContext
  The action context.
- partialMetadata: Partial<MetadataBindings> = {}
  Partial metadata entries.
- optional: boolean = false
  If metadata for an optional operation must be calculated.
Returns Promise<MetadataBindings>
Inherited from ActorRdfJoin.constructResultMetadata
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:235

constructState

constructState(metadatas: MetadataBindings[]): MetadataValidationState
Construct a metadata validation state for the given metadata entries.
Parameters
- metadatas: MetadataBindings[]
  An array of checked metadata.
Returns MetadataValidationState
Inherited from ActorRdfJoin.constructState
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:216

`Protected`getDefaultLogData

getDefaultLogData(context: IActionContext, data?: () => any): any
Parameters
- context: IActionContext
- Optionaldata: () => any
Returns any
Inherited from ActorRdfJoin.getDefaultLogData
- Defined in core/lib/Actor.ts:95

getJoinCoefficients

getJoinCoefficients(
    action: IActionRdfJoin,
    sideData: IActorRdfJoinTestSideData,
): Promise<
    TestResult<
        IMediatorTypeJoinCoefficients,
        IActorRdfJoinMultiBindTestSideData,
    >,
>
Calculate the join coefficients.
Parameters
- action: IActionRdfJoin
  Join action
- sideData: IActorRdfJoinTestSideData
  The test side data.
Returns Promise<
    TestResult<
        IMediatorTypeJoinCoefficients,
        IActorRdfJoinMultiBindTestSideData,
    >,
>
The join coefficient estimates.
Overrides ActorRdfJoin.getJoinCoefficients
- Defined in actor-rdf-join-inner-multi-bind/lib/ActorRdfJoinMultiBind.ts:187

getOutput

getOutput(
action: IActionRdfJoin,
sideData: IActorRdfJoinMultiBindTestSideData,
): Promise<IActorRdfJoinOutputInner>
Returns the resulting output for joining the given entries. This is called after removing the trivial cases in run.
Parameters
- action: IActionRdfJoin
- sideData: IActorRdfJoinMultiBindTestSideData
  Side data from the test method
Returns Promise<IActorRdfJoinOutputInner>
Overrides ActorRdfJoin.getOutput
- Defined in actor-rdf-join-inner-multi-bind/lib/ActorRdfJoinMultiBind.ts:102

`Protected`logDebug

logDebug(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logDebug
- Defined in core/lib/Actor.ts:108

`Protected`logError

logError(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logError
- Defined in core/lib/Actor.ts:129

`Protected`logFatal

logFatal(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logFatal
- Defined in core/lib/Actor.ts:136

`Protected`logInfo

logInfo(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logInfo
- Defined in core/lib/Actor.ts:115

`Protected`logTrace

logTrace(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logTrace
- Defined in core/lib/Actor.ts:101

`Protected`logWarn

logWarn(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorRdfJoin.logWarn
- Defined in core/lib/Actor.ts:122

run

run(
action: IActionRdfJoin,
sideData: IActorRdfJoinTestSideData,
): Promise<IQueryOperationResultBindings>
Returns default input for 0 or 1 entries. Calls the getOutput function otherwise
Parameters
- action: IActionRdfJoin
- sideData: IActorRdfJoinTestSideData
  Side data from the test method
Returns Promise<IQueryOperationResultBindings>
A bindings result.
Inherited from ActorRdfJoin.run
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:375

runObservable

runObservable(
action: IActionRdfJoin,
sideData: IActorRdfJoinMultiBindTestSideData,
): Promise<IQueryOperationResultBindings>
Run the given action on this actor AND invokes the Bus#onRun method.
Parameters
- action: IActionRdfJoin
  The action to run.
- sideData: IActorRdfJoinMultiBindTestSideData
Returns Promise<IQueryOperationResultBindings>
A promise that resolves to the run result.
Inherited from ActorRdfJoin.runObservable
- Defined in core/lib/Actor.ts:87

test

test(
    action: IActionRdfJoin,
): Promise<
    TestResult<
        IMediatorTypeJoinCoefficients,
        IActorRdfJoinMultiBindTestSideData,
    >,
>
Default test function for join actors. Checks whether all iterators have metadata. If yes: call the abstract getIterations method, if not: return Infinity.
Parameters
- action: IActionRdfJoin
  The input action containing the relevant iterators
Returns Promise<
    TestResult<
        IMediatorTypeJoinCoefficients,
        IActorRdfJoinMultiBindTestSideData,
    >,
>
The join coefficients.
Inherited from ActorRdfJoin.test
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:321

`Static`createBindStream

createBindStream(
    bindOrder: BindOrder,
    baseStream: BindingsStream,
    operations: Operation[],
    operationBinder: (
        boundOperations: Operation[],
        operationBindings: Bindings,
    ) => Promise<BindingsStream>,
    optional: boolean,
    algebraFactory: Factory,
    bindingsFactory: BindingsFactory,
): BindingsStream
Create a new bindings stream that takes every binding of the base stream and binds it to the remaining patterns, evaluates those patterns, and emits all their bindings.
Parameters
- bindOrder: BindOrder
  The order in which elements should be bound.
- baseStream: BindingsStream
  The base stream.
- operations: Operation[]
  The operations to bind with each binding of the base stream.
- operationBinder: (
  boundOperations: Operation[],
  operationBindings: Bindings,
  ) => Promise<BindingsStream>
  A callback to retrieve the bindings stream of bound operations.
- optional: boolean
  If the original bindings should be emitted when the resulting bindings stream is empty.
- algebraFactory: Factory
- bindingsFactory: BindingsFactory
Returns BindingsStream
- Defined in actor-rdf-join-inner-multi-bind/lib/ActorRdfJoinMultiBind.ts:58

`Static`getCardinality

getCardinality(metadata: MetadataBindings): QueryResultCardinality
Get the estimated number of items from the given metadata.
Parameters
- metadata: MetadataBindings
  A metadata object.
Returns QueryResultCardinality
The estimated number of items, or Infinity if cardinality is falsy.
Inherited from ActorRdfJoin.getCardinality
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:174

`Static`getContextLogger

getContextLogger(context: IActionContext): undefined | Logger
Get the logger from the given context.
Parameters
- context: IActionContext
  An optional context.
Returns undefined | Logger
The logger or undefined.
Inherited from ActorRdfJoin.getContextLogger
- Defined in core/lib/Actor.ts:56

`Static`getEntriesWithMetadatas

getEntriesWithMetadatas(
entries: IJoinEntry[],
): Promise<IJoinEntryWithMetadata[]>
Obtain the join entries witt metadata from all given join entries.
Parameters
- entries: IJoinEntry[]
  Join entries.
Returns Promise<IJoinEntryWithMetadata[]>
Inherited from ActorRdfJoin.getEntriesWithMetadatas
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:190

`Static`getMetadatas

getMetadatas(entries: IJoinEntry[]): Promise<MetadataBindings[]>
Obtain the metadata from all given join entries.
Parameters
- entries: IJoinEntry[]
  Join entries.
Returns Promise<MetadataBindings[]>
Inherited from ActorRdfJoin.getMetadatas
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:182

`Static`getRequestInitialTimes

getRequestInitialTimes(metadatas: MetadataBindings[]): number[]
Calculate the time to initiate a request for the given metadata entries.
Parameters
- metadatas: MetadataBindings[]
  An array of checked metadata.
Returns number[]
Inherited from ActorRdfJoin.getRequestInitialTimes
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:199

`Static`getRequestItemTimes

getRequestItemTimes(metadatas: MetadataBindings[]): number[]
Calculate the time to receive a single item for the given metadata entries.
Parameters
- metadatas: MetadataBindings[]
  An array of checked metadata.
Returns number[]
Inherited from ActorRdfJoin.getRequestItemTimes
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:207

`Static`joinBindings

joinBindings(...bindings: Bindings[]): null | Bindings
Returns the result of joining bindings, or null if no join is possible.
Parameters
- ...bindings: Bindings[]
Returns null | Bindings
Inherited from ActorRdfJoin.joinBindings
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:150

`Static`joinVariables

joinVariables(
    dataFactory: ComunicaDataFactory,
    metadatas: MetadataBindings[],
    optional?: boolean,
): MetadataVariable[]
Returns the variables that will occur in the joined bindings.
Parameters
- dataFactory: ComunicaDataFactory
  The data factory.
- metadatas: MetadataBindings[]
  An array of metadata objects for the entries.
- optional: boolean = false
  If an optional join is being performed.
Returns MetadataVariable[]
An array of joined variables.
Inherited from ActorRdfJoin.joinVariables
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:126

`Static`overlappingVariables

overlappingVariables(metadatas: MetadataBindings[]): MetadataVariable[]
Returns an array containing all the variable names that occur in all bindings streams.
Parameters
- metadatas: MetadataBindings[]
  An array of optional metadata objects for the entries.
Returns MetadataVariable[]
An array of variables.
Inherited from ActorRdfJoin.overlappingVariables
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:98

`Static`sortJoinEntries

sortJoinEntries(
    mediatorJoinEntriesSort: MediatorRdfJoinEntriesSort,
    entries: IJoinEntryWithMetadata[],
    context: IActionContext,
): Promise<TestResult<IJoinEntryWithMetadata[]>>
Order the given join entries using the join-entries-sort bus.
Parameters
- mediatorJoinEntriesSort: MediatorRdfJoinEntriesSort
  A mediator for sorting join entries.
- entries: IJoinEntryWithMetadata[]
  An array of join entries.
- context: IActionContext
  The action context.
Returns Promise<TestResult<IJoinEntryWithMetadata[]>>
The sorted join entries.
Inherited from ActorRdfJoin.sortJoinEntries
- Defined in bus-rdf-join/lib/ActorRdfJoin.ts:275

Class ActorRdfJoinMultiBind

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ActorRdfJoinMultiBind

Properties

ReadonlybeforeActors

ReadonlybindOrder

Readonlybus

Protected ReadonlycanHandleUndefs

includeInLogs

Protected ReadonlyisLeaf

Protected ReadonlylimitEntries

Protected ReadonlylimitEntriesMin

ReadonlylogicalType

ReadonlymediatorJoinEntriesSort

ReadonlymediatorJoinSelectivity

ReadonlymediatorMergeBindingsContext

ReadonlymediatorQueryOperation

ReadonlyminMaxCardinalityRatio

Readonlyname

Default

ReadonlyphysicalName

Protected Optional ReadonlyrequiresVariableOverlap

ReadonlyselectivityModifier

Methods

canBindWithOperation

Parameters

Returns boolean

constructResultMetadata

Parameters

Returns Promise<MetadataBindings>

constructState

Parameters

Returns MetadataValidationState

ProtectedgetDefaultLogData

Parameters

Returns any

getJoinCoefficients

Parameters

Returns Promise< TestResult< IMediatorTypeJoinCoefficients, IActorRdfJoinMultiBindTestSideData, >,>

getOutput

Parameters

Returns Promise<IActorRdfJoinOutputInner>

ProtectedlogDebug

Parameters

Returns void

ProtectedlogError

Parameters

Returns void

ProtectedlogFatal

Parameters

Returns void

ProtectedlogInfo

Parameters

Returns void

ProtectedlogTrace

Parameters

Returns void

ProtectedlogWarn

Parameters

Returns void

run

Parameters

Returns Promise<IQueryOperationResultBindings>

runObservable

Parameters

Returns Promise<IQueryOperationResultBindings>

test

Parameters

Returns Promise< TestResult< IMediatorTypeJoinCoefficients, IActorRdfJoinMultiBindTestSideData, >,>

StaticcreateBindStream

Parameters

Returns BindingsStream

StaticgetCardinality

`Readonly`beforeActors

`Readonly`bindOrder

`Readonly`bus

`Protected` `Readonly`canHandleUndefs

`Protected` `Readonly`isLeaf

`Protected` `Readonly`limitEntries

`Protected` `Readonly`limitEntriesMin

`Readonly`logicalType

`Readonly`mediatorJoinEntriesSort

`Readonly`mediatorJoinSelectivity

`Readonly`mediatorMergeBindingsContext

`Readonly`mediatorQueryOperation

`Readonly`minMaxCardinalityRatio

`Readonly`name

`Readonly`physicalName

`Protected` `Optional` `Readonly`requiresVariableOverlap

`Readonly`selectivityModifier

`Protected`getDefaultLogData

Returns Promise<
TestResult<
IMediatorTypeJoinCoefficients,
IActorRdfJoinMultiBindTestSideData,
>,
>

`Protected`logDebug

`Protected`logError

`Protected`logFatal

`Protected`logInfo

`Protected`logTrace

`Protected`logWarn

Returns Promise<
TestResult<
IMediatorTypeJoinCoefficients,
IActorRdfJoinMultiBindTestSideData,
>,
>

`Static`createBindStream

`Static`getCardinality

`Static`getContextLogger

`Static`getEntriesWithMetadatas

`Static`getMetadatas

`Static`getRequestInitialTimes

`Static`getRequestItemTimes

`Static`joinBindings

`Static`joinVariables

`Static`overlappingVariables

`Static`sortJoinEntries