This document contains documentation fragments that should be moved into their appropriate chapters later.

DRAGOS vs. JDBC terminology

In JDBC, DataSources serve as factories for Connections. In DRAGOS, they have connection characteristics themselves, with methods such as open(), close() and createTransaction(). However, one can roughly compare DataSourceTransactions to the Connections in JDBC, since a DataSource can usually support multiple DataSourceTransactions at once (one per thread). It also makes sense implementation-wise to back each DataSourceTransaction with its own Connection, since each Connection can only support one database transaction at a time. See dragos-db-jdbc for example code.