XStream

XStream remote data connector

The runner and designer use this self-contained connector for DACP remote catalogs and Item views. Its public package is xstream.connector.dacp.client. It depends on XStream libraries and the bundled wire schema, without a DACP checkout or server artifact.

import xstream.connector.dacp.client.{Source, TlsConfig}
import java.nio.file.Path
import scala.util.Using

val tls = TlsConfig(ca = Some(Path.of("ca.crt")),
  tokenFile = Some(Path.of("reader.token")))
val directory = Source.datasets("dacp://data.example.org:8815", tls)
Using.resource(Source.open("dacp://data.example.org:8815/weather", tls)) { dataset =>
  println(dataset.list("/"))
}

Anonymous public metadata can be listed without credentials. Protected reads use the configured token; CA trust uses TlsConfig.ca or system roots. Client certificates, when supplied, require both certificate and key. Close datasets and Item readers, including on early exit. Arrow roots are borrowed and reused: consume or copy batches before advancing.

Transport failures become DacpException with stable error codes. Failed reads must be reopened. The DACP SDK and Shell provide remote Job submission; the local engine uses this connector only for data access.

(cd connectors/xstream-dacp-client && sbt test)

Tests use local protocol fixtures; a running DACP service is not required. See engine configuration.

All connections, including anonymous catalog access, verify the server certificate and hostname. Platform trust roots are used by default; configure private or self-signed CAs through TlsConfig.ca or DACP_CA. Verification cannot be disabled.