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.

  • 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.