Module com.darkcollective.relix.lang.ast

Package com.darkcollective.relix.lang.ast.source

package com.darkcollective.relix.lang.ast.source

Source-declaration AST — the configuration types that describe how a virtual relation retrieves its data.

Source hierarchy

 SourceConfig (sealed)
 ├── HttpSourceConfig     — HTTP/REST API (JSON or CSV response)
 ├── DatabaseSourceConfig — JDBC-accessible table or view
 └── CsvFileSourceConfig  — local CSV file
 

Column specs

Each source type carries a list of ColumnSpecs that describe the relation's schema as seen by queries. A column is either:

• ColumnDirection.IN — an input parameter pushed into the request (e.g. a URL query parameter). Only meaningful for HttpSourceConfig.
• ColumnDirection.OUT — a value extracted from the response or result set.

Column bindings

ColumnBinding is a sealed interface describing how a column maps to the transport:

• QueryParamBinding — URL query parameter (as query("q")).
• PathParamBinding — URL path segment (as path("id")).
• HeaderBinding — request header (as header("X-City")).
• ExtractPathBinding — JSONPath into the response body (at "$.main.temp").

Related Packages

Package	Description
com.darkcollective.relix.lang.ast	Root scripting-language AST — the Script node and the Statement hierarchy.
com.darkcollective.relix.lang.ast.table	Inline table AST nodes — the two surface formats for embedding relation data directly in a .relix script.

Class	Description
ApiKeyAuth	API-key authentication: the connector sends a named key either as a request header or as a URL query parameter.
ApiKeyAuth.ApiKeyLocation	Where an ApiKeyAuth key is placed in the request.
AuthSpec	Sealed root for an HTTP source's authentication shorthand.
BasicAuth	HTTP basic authentication: the connector sends Authorization: Basic <base64(username:password)>.
BearerAuth	Bearer-token authentication: the connector sends Authorization: Bearer <token>.
ColumnBinding	Sealed interface describing how a column maps to the underlying transport.
ColumnDirection	Indicates whether a column spec describes an input parameter or an output value.
ColumnReference	One entry of a references: block on a database or connection-table source — a foreign-key style arrow from columns of the declaring source to columns of another relation:
ColumnSpec	Describes one column in a source declaration's schema.
ConnectionTableSourceConfig	Configuration for a source bound to a table within a named connection, e.g.
CsvExtractSpec	Extracts tabular data from a CSV response body.
CsvFileSourceConfig	Configuration for a local CSV file source.
DatabaseConnectionConfig	Configuration for a named database connection — the JDBC coordinates shared by every table referenced through it.
DatabaseSourceConfig	Configuration for a database-backed source (JDBC table or view).
ExtractPathBinding	Binds an OUT column to a JSONPath expression within the response body.
ExtractSpec	Sealed interface describing how to extract tabular data from an HTTP response.
GeneratorSourceConfig	Configuration for a generator source — a leaf relation whose rows are produced by engine code rather than read from a file or database.
HeaderBinding	Binds an IN column to an HTTP request header.
HttpMethod	HTTP request method for an HttpSourceConfig.
HttpSourceConfig	Configuration for an HTTP/REST API source.
JsonExtractSpec	Extracts tabular data from a JSON response body.
JsonFileSourceConfig	Transport configuration for a local JSON file source.
PaginateEntry	Maps a logical pagination concept to a URL query parameter.
PaginateSpec	Declares how an HTTP source's pagination maps to URL parameters.
PathParamBinding	Binds an IN column to a URL path segment.
QueryParamBinding	Binds an IN column to a URL query parameter.
SourceConfig	Sealed root interface for the transport configuration of a source declaration.