Module com.darkcollective.relix.processor

Package com.darkcollective.relix.processor.connector

package com.darkcollective.relix.processor.connector

The connector provider interface, and connector plugin provisioning.

A RelixConnector reads one kind of external source, configured by a ConnectorConfig; connectors are discovered with ServiceLoader or registered on a session. ConnectorProvisioner downloads a plugin a host asks for, from the ConnectorCatalog, through a Fetcher.

Related Packages

Package	Description
com.darkcollective.relix.processor	Row: one row of a result, a tuple of Values read by position or by column name.
com.darkcollective.relix.processor.connector.internal	The engine-side machinery behind com.darkcollective.relix.processor.connector: not exported by the published artifact.
com.darkcollective.relix.processor.eval	Scalar expression and predicate evaluation for query execution.
com.darkcollective.relix.processor.exec	Execution operators for the relix processor.
com.darkcollective.relix.processor.generator	Generator relations — leaf relations whose rows are produced by engine code rather than read from a file or database.
com.darkcollective.relix.processor.internal	The engine-side machinery behind com.darkcollective.relix.processor: not exported by the published artifact.
com.darkcollective.relix.processor.provenance	A relation annotated over a semiring, as Relation.provenance returns it.

Class	Description
Artifact	One downloadable JAR — a URL and its expected SHA-256 (lower-case hex) — shared by the connector-plugin catalog (ConnectorCatalog) and the JDBC driver catalog a connector provider keeps (DriverCatalog, in relix-connectors-std).
ConnectorCatalog	A catalog of downloadable connector plugins — the SPI-side analogue of the JDBC DriverCatalog.
ConnectorCatalog.Entry	A connector plugin: the type token it provides and the artifacts to download.
ConnectorConfig	The raw, type-agnostic configuration for one connector-backed relation — the key/value pairs from a connection or source declaration, already environment-substituted.
ConnectorProvisioner	Provisions a connector plugin on demand: when a connection names a connectorType for which no RelixConnector is registered, this looks the plugin up in the ConnectorCatalog, downloads its artifacts (the connector JAR + its driver/runtime JARs, each checksum-verified) into the connector directory, and reports the outcome — the caller then rebuilds its ConnectorRegistry to pick up the new plugin.
ConnectorProvisioner.Outcome	The result of a provisioning attempt (the caller checks the registry for "already present").
ConnectorProvisioner.Result	A provisioning outcome plus a human-readable explanation.
Fetcher	Fetches the bytes at a URI — the network seam for DriverDownloader.
RelixConnector	The plug-in boundary for an external data source — the open seam that replaces the closed CSV/JSON/JDBC dispatch.