Module com.darkcollective.relix.connectors.std

Package com.darkcollective.relix.connectors.std.internal

package com.darkcollective.relix.connectors.std.internal

The engine-side machinery behind com.darkcollective.relix.connectors.std: not exported by the published artifact. What follows describes the package as a whole, as it stood before the split. The standard library of DataSourceConnector implementations — CSV, JSON files, HTTP/JSON endpoints and JDBC databases — plus the JDBC driver provisioning they need.

Each connector bridges one external data-source kind to the query executor's Row model:

• CsvDataSourceConnector — local CSV files declared with source X from csv("path/to/file.csv") { … };
• JsonFileDataSourceConnector — local JSON documents;
• HttpDataSourceConnector — read-only HTTP/JSON endpoints;
• JdbcDataSourceConnector — relational databases over JDBC, with JdbcCatalogProvider supplying table schemas and statistics.

All connectors receive a fully-validated SemanticModel at construction time so they can look up the transport-level configuration (path, column schema, header flag, etc.) stored in SemanticModel.sources().

This is a provider, not part of the engine: it compiles against the connector SPI the engine publishes and is discovered at runtime, exactly as an out-of-tree connector plugin is. Nothing here is privileged, which is why the engine itself needs neither a JDBC stack nor an HTTP client.

Related Packages

Package	Description
com.darkcollective.relix.connectors.std	JDBC driver provisioning for the standard connectors.

Class	Description
ConnectionPool	A small pool of reusable JDBC Connections, keyed by DatabaseConnectionConfig, so repeated scans and queries against the same connection avoid the cost of opening a fresh physical connection each time.
ConnectionProvider	Turns a declared connection into a live JDBC Connection.
ConnectorCatalogProvider	A CatalogProvider that asks the connector to describe its own tables.
CsvConnector	Built-in RelixConnector for local CSV files — the reference implementation of the connector SPI.
CsvDataSourceConnector	A DataSourceConnector that reads data from local CSV files.
DataSourceRegistry	Binds connection names to live JDBC DataSource handles, so a program can hand the engine a database it already has open.
FileResolver	The one answer to give me a local file for this connection, for every connector that reads a file.
GedcomConnector	Reads a GEDCOM genealogy file as a pair of relations.
HttpDataSourceConnector	Executes source … from http { … } relations: it issues the configured HTTP request, parses the JSON response, and yields one Row per record.
HttpDataSourceConnector.HttpFetchResult	The result of an HTTP exchange: the status code and the response body.
HttpDataSourceConnector.HttpRequestSpec	The fully-resolved request the connector wants to send.
HttpDataSourceConnector.HttpTransport	The I/O boundary — sends a request and returns the response.
JdbcCatalogProvider	A CatalogProvider that introspects table schemas from a live database over JDBC, used when a connection.table reference declares no schema.
JdbcDataSourceConnector	A DataSourceConnector that reads connection-backed tables over JDBC.
JsonFileDataSourceConnector	A DataSourceConnector that reads rows from a local JSON file as open (schema-on-read) documents — the first native nested-data source.
LogConnector	Reads a web server's access log as a relation: connection X from log { … }.
RelixDriverLoader	Loads JDBC drivers from JAR files in an external driver directory, rather than bundling them into the executable at build time.