next.jdbc.protocols — seancorfield/next.jdbc 1.0.0-alpha7

This is the extensible core of the next generation java.jdbc library.

Sourceable protocol: get-datasource -- turn something into a javax.sql.DataSource; implementations are provided for strings, hash maps (db-spec structures), and also a DataSource (which just returns itself).

Connectable protocol: get-connection -- create a new JDBC connection that should be closed when you are finished with it; implementations are provided for DataSource, PreparedStatement, and Object, on the assumption that an Object can possibly be turned into a DataSource.

Executable protocol: -execute -- given SQL and parameters, produce a 'reducible' that, when reduced, executes the SQL and produces a ResultSet that can be processed; implementations are provided for Connection, DataSource, PreparedStatement, and Object (on the assumption that an Object can be turned into a DataSource and therefore used to get a Connection).

-execute-one -- given SQL and parameters, executes the SQL and produces the first row of the ResultSet as a datafiable hash map (by default); implementations are provided for Connection, DataSource, PreparedStatement, and Object (on the assumption that an Object can be turned into a DataSource and therefore used to get a Connection).

-execute-all -- given SQL and parameters, executes the SQL and produces either a vector of datafiable hash maps from the ResultSet (default) or a vector of column names followed by vectors of row values; implementations are provided for Connection, DataSource, PreparedStatement, and Object (on the assumption that an Object can be turned into a DataSource and therefore used to get a Connection).

Preparable protocol: prepare -- given SQL and parameters, produce a PreparedStatement that can be executed (by -execute above); implementation is provided for Connection only.

Transactable protocol: -transact -- given a function (presumably containing SQL operations), run the function inside a SQL transaction; implementations are provided for Connection, DataSource, and Object (on the assumption that an Object can be turned into a DataSource).

Connectable clj protocol

get-connection clj

(get-connection this opts)

Executable clj protocol

-execute clj

(-execute this sql-params opts)

-execute-all clj

(-execute-all this sql-params opts)

-execute-one clj

(-execute-one this sql-params opts)

Preparable clj protocol

prepare clj

(prepare this sql-params opts)

Sourceable clj protocol

get-datasource clj

(get-datasource this)

Transactable clj protocol

-transact clj

(-transact this body-fn opts)