Keywords: JSR169-only features, Derby's support for

# JDBC Package for Connected Device Configuration/Foundation Profile (JSR169)

Derby supports the JDBC API defined for the Connected Device Configuration/Foundation Profile, also known as JSR169. The features supported are a subset of the JDBC 3.0 specification. Support for JSR169 is limited to the embedded driver. Derby does not support using the Network Server under JSR169.

To obtain a connection under JSR169 specifications, use the `org.apache.derby.jdbc.EmbeddedSimpleDataSource` class. This class is identical in implementation to the `org.apache.derby.jdbc.EmbeddedDataSource` class. See the Java DB Developer's Guide for information on using the properties of the `org.apache.derby.jdbc.EmbeddedDataSource` class.

Some other features to note concerning the JSR169 implementation using Derby:

- Applications must get and set `DECIMAL` values using alternate JDBC `getXXX` and `setXXX` methods, such as `getString()` and `setString()`. Any alternate method that works against a DECIMAL type with JDBC 2.0 or 3.0 will work in JSR169.
- Java functions and procedures that use server-side JDBC parameters such as `CONTAINS SQL`, `READS SQL DATA` or `MODIFIES SQL DATA` are not supported in JSR169.
- The standard API used to obtain a connection (`jdbc:default:connection`) is not supported in JSR169. A runtime error may occur when the routine tries to obtain a connection using `jdbc:default:connection`.
- Diagnostic tables are not supported.
- Triggers are not supported.
- Encrypted databases are not supported.
- DriverManager is not supported. You cannot use DriverManager.getConnection() to obtain a connection.

Parent topic: JDBC reference
Related concepts
Core JDBC java.sql classes, interfaces, and methods
Related reference
java.sql.Driver interface
java.sql.DriverManager.getConnection method
java.sql.Connection interface
java.sql.DatabaseMetaData interface
java.sql.Statement interface
java.sql.CallableStatement interface
java.sql.SQLException class
java.sql.PreparedStatement interface
java.sql.ResultSet interface
java.sql.ResultSetMetaData interface
java.sql.SQLWarning class
java.sql.SQLXML interface
Mapping of java.sql.Types to SQL types
JDBC 2.0 features
java.sql.BatchUpdateException class
JDBC 3.0 features
JDBC 4.0-only features
JDBC escape syntax