J. D. B. C.

Java DataBase Connectivity.

Besoin

• plug : permettre aux fournisseurs de SGBDR de s'intégrer avec des environnements Java de manière standard
• play : permettre aux applications Java d'exploiter des SGBDR de manière standard

Conception

Architecture

L'ensemble de ces interfaces JDBC est implémenté par les éditeurs sous forme de pilotes (drivers), classés selons 4 catégories :

1. Pont JDBC-ODBC si vous avez un pilote ODBC et pas de pilote JDBC
2. Client natif si vous maîtrisez le poste client
3. Serveur
   1. si vous accédez à un SGBDR derrière un pare-feu
   2. si votre pilote JDBC ne supporte pas la mutualisation de connexions
   3. si vous souhaitez accéder à des SGBDR différents
4. Client Java si vous ne maîtrisez pas le poste client

API

JDBC est une API de J2SE comprenant :

• un coeur définissant les notions de :
  • connexion à une base de données, sur laquelle peuvent être émises :
    • des requêtes
      • de type
        • basique
        • précompilées (SQL dynamique)
        • procédure stockée en base
      • retournant éventuellement des résultat éventuel de cette requête (contenant des données lues dans la base typiquement) que l'on peut :
        • parcourir en avant, arrière, absolu
        • de manière isolée ou non (des modifications extérieures)
        • mettre à jour
• une extension ajoutant la notion de :
  • sources de données abstraites
    • accessibles via JNDI
    • fournissant généralement une mutualisation (pooling) des connexions
  • transactions globales ou distribuées (support de XA)

Le coeur de l'API de JDBC est intégrée à J2SE depuis J2SE 1.1. Son extension est requise par J2EE.

Implémentation

JDBC		Version	1			2		3		Commentaire
Partie	Technologie	Release	0	1	2	0	1	0
Plate-forme	J2SE		1.1			1.2		1.3	1.4	Plate-forme Java intégrante
Core	DriverManager				Oui					Coeur obligatoire
	Connection				Oui					Connexion
	Statement				Oui					Requête
		getGeneratedKeys	Non					Oui		Clés auto-générées
		getMoreResults	Non					Oui
		getConnection	Non			Oui
		Batch updates	Non			Optionnel				Ajoute une requête SQL pour executeBatch
		resultSetType	Non			Oui				En avant seulement, en avant/arrière, et isolé ou non
		resultSetConcurrency	Non			Oui				Modifiable ou en lecture seule
		fetchDirection	Non			Oui
		fetchSize	Non			Oui				Nombre de lignes pour une page
	PreparedStatement				Oui					Requête précompilée (SQL dynamique)
	CallableStatement				Oui					Procédure stockée
	ResultSet	ARRAY	Non		getArray					java.sql.Array
			Non						updateArray
		TINYINT			getByte
		SMALLINT			getShort
		SMALLINT			getInt
		BIGINT			getLong
		REAL			getFloat
		FLOAT			getDouble
		DOUBLE
		DECIMAL			getBigDecimal					java.math.BigDecimal
		NUMERIC
		BIT			getBoolean
		VARCHAR			getString
		CHAR
		VARBINARY			getBytes					byte[]
		BINARY
		DATE	Non		getDate					java.sql.Date
		TIME	Non		getTime					java.sql.Time
		TIMESTAMP	Non		getTimeStamp					java.sql.TimeStamp
		LONGVARCHAR			getAsciiStream					Retourne un java.io.InputStream pour un
					getUnicodeStream					Retourne un java.io.InputStream pour un
		LONGVARBINARY			getBinaryStream					Retourne un java.io.InputStream pour un
		Tous			getObject					Le type SQL est retourné comme un java.lang.Objet
		Indice de ligne	Non		getRow					Numéro de ligne courant
		Type structuré	Non		getRef					Référence sur un type structuré (object) SQL3. Peut être lazy
			Non						updateRef
		BLOB	Non						updateBlob	Binary Large Object
		CLOB	Non						updateClob	Binary Character Object
		URL	Non						getURL
Extension	DataSource		Non			Oui				Optionnel
	ConnectionEvent		Non			Oui
	RowSet		Non			Oui

Limitations

• Les requêtes sont exprimées en texte libre (SQL à priori), laissant la possibilité d'émettre des requêtes propriétaires.
• A moins de besoins simples, le développement peut se révéler lourd, fastidieux et difficile à mettre au point.
• Possibilité d'écrire des requêtes propriétaires (ne fonctionnant que sur un SGBDR particulier)

Exemples

Des exemples de pilotes JDBC sont :

• IBM DB2 (type 2)
• Oracle OCI et (2) "thin" (4)
• Sybase JConnect
• Cloudscape (type 4)
• Sun JDBC-ODBC (1)
• Microsoft JDBC-ODBC (1)

Un exemple de code JDBC en environnement J2EE est :

Context namingContext = new InitialContext();
DataSource dataSource = (DataSource) namingContext.lookup ("java:comp/env/jdbc/MyDataSource");

Connection dataSourceConnection = dataSource.getConnection();

try {
  PreparedStatement selectStatement = connection.prepareStatement ("SELECT ID, SHORT_NAME, RELATIONSHIPS.TYPE FROM SKILL, RELATIONSHIPS WHERE ID=RELATIONSHIPS.ID_TO AND RELATIONSHIPS.ID_FROM=?");
  selectStatement.setInt    (1, 123);
  selectStatement.setString (2, "UnType");

  ResultSet skillSet = selectStatement.executeQuery();

  List linkedSkills = new ArrayList();
  while (skillSet.next()) {
    int    id        = skillSet.getInt    ("ID");
    String shortName = skillSet.getString ("SHORT_NAME");
    Skill  newSkill  = new SkillImpl (id, shortName);
    linkedSkills.add (newSkill);
  }

  return linkedSkills;
}
finally {
  connection.close();  // Ferme le statement et le ResultSet
}

Voir

• Pilotes JDBC
• Tutoriaux
• SQLJ - Une simplification de JDBC