Class Database

java.lang.Object
   |
   +----Database

public class Database
extends Object
Cette classe représente une base de données, elle possède toutes les fonctions nécessaires à l'ouverture, à la fermeture, à la modification et à l'interrogation de la base de données.

Version:
1.0 -- Last update : 21/08/97
Author:
Stéphane CABAGNO -- Copyright © 1997 PrologIA
See Also:
Connect, NetworkClassLoader, Server

Constructor Index

 o Database()
 o Database(String, String, String)
Construit une nouvelle connexion avec la base de données en utilisant le pont "JDBC-ODBC Bridge" de SUN.

Method Index

 o close()
Ferme la connexion avec la base de données.
 o databaseModification(String)
Cette fonction est utilisée pour exécuter des requêtes de type INSERT, UPDATE ou DELETE et également des requêtes de type SQL DDL (Data Definition Language) comme CREATE TABLE ou DROP TABLE.
 o listResultSet(ResultSet)
Transforme l'ensemble résultat en une liste de listes Prolog.
 o selectQuery(String)
Envoie une requête SQL de type SELECT à la base de données.

Constructors

 o Database
 Database()
 o Database
 public Database(String url,
                 String userID,
                 String password) throws SQLException, Exception
Construit une nouvelle connexion avec la base de données en utilisant le pont "JDBC-ODBC Bridge" de SUN.

Parameters:
url - l'URL de la base de données, de la forme jdbc:subprotocol:subname. Attention, le subprotocol utilisé doit être odbc.
userID - le nom d'utilisateur de la base de données
password - le mot de passe de l'utilisateur
Throws: SQLException
si on a une erreur de type SQL
Throws: Exception
si on a tout autre type d'exception

Methods

 o selectQuery
 public ResultSet selectQuery(String query) throws SQLException
Envoie une requête SQL de type SELECT à la base de données.

Parameters:
query - la requête SQL qui doit être exécutée
Returns:
un ensemble résultat (objet "ResultSet") qui contient toutes les lignes qui satisfont les conditions de la requête SQL
Throws: SQLException
si une erreur apparaît lors de l'exécution de la requête
 o databaseModification
 public int databaseModification(String modification) throws SQLException
Cette fonction est utilisée pour exécuter des requêtes de type INSERT, UPDATE ou DELETE et également des requêtes de type SQL DDL (Data Definition Language) comme CREATE TABLE ou DROP TABLE.

Parameters:
modification - la requête SQL à exécuter
Returns:
le nombre de lignes qui ont été affectées si c'était une requête de type INSERT, UPDATE ou DELETE et retourne zéro si c'était une requête de type CREATE ou DROP.
Par conséquent, quand la valeur de retour de cette fonction vaut zéro, cela peut signifier deux choses : soit la requête exécutée est de type INSERT, UPDATE ou DELETE mais n'a affecté aucune ligne, soit la requête SQL exécutée était une requête de type SQL DDL.
Throws: SQLException
si une erreur apparaît lorsqu'on exécute la modification
 o close
 public void close() throws SQLException, NullPointerException
Ferme la connexion avec la base de données.

Throws: SQLException
si on a une erreur de type SQL
Throws: NullPointerException
si on cherche à fermer une base de données qui n'est pas ouverte
 o listResultSet
 public PrologDot listResultSet(ResultSet rs) throws SQLException
Transforme l'ensemble résultat en une liste de listes Prolog. Chaque liste correspond à une ligne du résultat. Les éléments composant chaque ligne du résultat sont donnés sous une forme se rapprochant le plus possible de leur type : les entiers (Integer et Long) sont enregistrés sous forme de PrologInt, les flottants (Float et Double) sont enregistrés sous forme de PrologFloat et tous les autres types sont enregistrés sous forme de chaînes de caractères.

Parameters:
rs - l'ensemble résultat à transformer
Returns:
la liste de listes représentant l'ensemble résultat
Throws: SQLException
si on a une erreur de type SQL