Framework Serveur J2EE ACube V3.1.0
CLASSE PRECEDANTE CLASSE SUIVANTE
SOMMAIRE: ATTR CONSTR METH DETAIL: ATTR CONSTR METH

acube.framework.technical.jdbc
Classe JDBCWrapper
java.lang.Object
  acube.framework.technical.jdbc.JDBCWrapper
Sous classes directement connues:

public class JDBCWrapper
hérite de Object
Classe d'encapsulation des accès à la base de données via l'API JDBC. Drivers recommandés :
Version:
1.0

Sommaire des Attributs
private boolean
_autoCommit
Valeur de l'autocommit
private CallableStatement
_call
CallableStatement
protected static Configuration
_configServer
Configuration : Donnees specifiques au serveur.
private Connection
_connection
Connexion à la base de données
protected String
_dataSourceName
Nom Jndi de la DataSource à utiliser
protected boolean
_dataSourceType
Type de datasource true : datasource serveur d'app via JNDI false : datasource dans server.properties
private boolean
_isConnected
Si true alors JDBCWrapper a déjà une connexion vers la base ouverte
private PreparedStatement
_prep
Statement
private ResultSet
_rset
Recordset contenant les données récupérées par la requête
protected static final String
BASE_UNIQUE
Clé à utiliser en cas de base unique (compatibilité avec anciennes version)
protected static Hashtable
dataSources
configuration : gestionnaire de la configuration chargée
private static Hashtable
hTypes
hTypes Table de hashage contenant les identifiants des différents types.
protected boolean
inTransaction
variable indiquant l'état de la transaction
protected static final org.apache.log4j.Logger
logger
logger: Definition du logger
protected static Object
mutexDataSource
Mutex permettant de proteger la Hashtable de datasources
private ArrayList
private Vector
outParamProc
outParamProc Vecteur en retour contenant les elements de type OUT et IN_OUT passes en parametre des procedure stockees.
private static final String
THIS_CLASS
THIS_CLASS: Définition de la classe utilisée par le logger
static final String
TYPE_DATE_DATE
TYPE_DATE_DATE selectionne le format Date comme retour de getDate()
static final String
TYPE_DATE_TIMESTAMP
TYPE_DATE_TIMESTAMP selectionne le format Timestamp comme retour de getDate()
static final int
TYPE_LOB_BLOB
TYPE_LOB_BLOB selectionne la mise en base d'un BLOB pour la méthode saveOracleLob
static final int
TYPE_LOB_CLOB
TYPE_LOB_CLOB selectionne la mise en base d'un CLOB pour la méthode saveOracleLob
static final int
TYPE_REQUETE_EXECUTE
TYPE_REQUETE_EXECUTE appel d'une methode execute() sur le statement qui renvoie un boolean : celui-ci est converti pour le retour de la façon suivante : true -> 1 et false -> 0.
static final int
TYPE_REQUETE_QUERY
TYPE_REQUETE_QUERY appel d'une methode executeQuery() sur le statement qui valorise un ResultSet qui sera accede par la suite via une methode du JDBCWrapper : en consequence cette fonctionnalite renvoie toujours un int de valeur 0 pour signifier que tout c'est bien deroule.
static final int
TYPE_REQUETE_UPDATE
TYPE_REQUETE_UPDATE appel d'une methode executeUpdate() sur le statement qui renvoie un int correspondant au nombre de lignes impactees par la requete : il s'agit de requetes de type update, delete ou insert.
Sommaire des Constructeurs
JDBCWrapper()
Constructeur par defaut de l'objet JDBCWrapper.
JDBCWrapper(String dataSourceName)
Constructeur de l'objet JDBCWrapper.
JDBCWrapper(String dataSourceName, boolean type)
Constructeur de l'objet JDBCWrapper.
Sommaire des Méthodes
static String
addCriteria(String sSql, String sSqlCritere)
Ajouter un critère à la requête en construction
private void
beforeExecute()
Cette méthode permet de préparer l'exécution d'une requête en fermant éventuellement le PreparedStatement et/ou le RecordSet préalablement ouverts.
private Integer
bigDecimalToInteger(BigDecimal big)
void
close()
Ferme la connexion à la base de données ainsi que les éventuels objets afférents (ResultSet et PreparedStatement).
private void
closeCallableStatement()
Ferme le CallableStatement
void
closeOtherCnx()
Cloture des connextions non standard.
private void
closePreparedStatement()
Ferme le PreparedStatement
void
commit()
Commit manuel.
protected int
decodeClassName(String className)
Retourne le type dépendant du nom d'une class contenu dans la table da hashage
int
execute(String sql, int type)
Execute une requete
int
execute(String sql, int type, String param)
Execute une requete avec un paramètre en type String Remet le paramètre dans un vecteur.
int
execute(String sql, int type, Vector params)
Execute une requete avec un vecteur de paramètres
int
executeProcedure(String sql, int type, Vector params)
Execute une procedure
protected void
finalize()
Methode exécutée avant de décharger l'objet JDBCWrapper de la mémoire.
static String
formatCriteria(String sNomCritere, String sValeurCritere)
Formate un critère pour les requêtes SQL
protected CallableStatement
protected static Configuration
protected String
protected PreparedStatement
protected ResultSet
BigDecimal
getBigDecimal(int index)
Récupération de la valeur d'un champ de type BigDecimal, resultant d'une requête SQL
BigDecimal
getBigDecimal(String champ)
Récupération de la valeur d'un champ de type BigDecimal, résultant d'une requête SQL
InputStream
getBinaryStream(String champ)
Récupération d'un flux de données binaires (utilisé pour récupérer les images stockées en base)
InputStream
getBlob(String champ)
Récupération d'un flux de données binaires (utilisé pour récupérer les images stockées en base)
boolean
getBoolean(int index)
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
boolean
getBoolean(String champ)
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Connection
getConnection()
Récupération d'une connexion à la base de données.
protected synchronized DataSource
getDataSource()
Récupération d'une des sources de données mises en cache pour améliorer les performances.
private DataSource
getDataSourceInProperties(String name)
Permet de récupérer une datasource dans le fichier de properties
static Hashtable
Date
getDate(int index)
Récupération de la valeur d'un champ de type Date, resultant d'une requête SQL
Date
getDate(String champ)
Récupération de la valeur d'un champ de type Date, resultant d'une requête SQL
double
getDouble(int index)
Récupération de la valeur d'un champ de type double, resultant d'une requête SQL
double
getDouble(String champ)
Récupération de la valeur d'un champ de type double, résultant d'une requête SQL
float
getFloat(int index)
Récupération de la valeur d'un champ de type float, resultant d'une requête SQL
float
getFloat(String champ)
Récupération de la valeur d'un champ de type float, résultant d'une requête SQL
int
getInt(int index)
Récupération de la valeur d'un champ de type int, resultant d'une requête SQL
int
getInt(String champ)
Récupération de la valeur d'un champ de type int, résultant d'une requête SQL
protected static org.apache.log4j.Logger
long
getLong(int index)
Récupération de la valeur d'un champ de type long, resultant d'une requête SQL
long
getLong(String champ)
Récupération de la valeur d'un champ de type long, résultant d'une requête SQL
Object
getObject(int index)
Récupération de la valeur d'un champ de type Object (par exemple Objet Oracle), resultant d'une requête SQL
Object
getObject(String champ)
Récupération de la valeur d'un champ de type Object (par exemple Objet Oracle), résultant d'une requête SQL
BigDecimal
getObjectBigDecimal(int index)
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
BigDecimal
getObjectBigDecimal(String champ)
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Boolean
getObjectBoolean(int index)
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
Boolean
getObjectBoolean(String champ)
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Double
getObjectDouble(int index)
Récupération de la valeur d'un champ de type double, resultant d'une requête SQL
Double
getObjectDouble(String champ)
Récupération de la valeur d'un champ de type double, résultant d'une requête SQL
Float
getObjectFloat(int index)
Récupération de la valeur d'un champ de type float, resultant d'une requête SQL
Float
getObjectFloat(String champ)
Récupération de la valeur d'un champ de type float, résultant d'une requête SQL
Integer
getObjectInt(int index)
Récupération de la valeur d'un champ de type int, resultant d'une requête SQL
Integer
getObjectInt(String champ)
Récupération de la valeur d'un champ de type int, résultant d'une requête SQL
Long
getObjectLong(int index)
Récupération de la valeur d'un champ de type Long, resultant d'une requête SQL
Long
getObjectLong(String champ)
Récupération de la valeur d'un champ de type Long, résultant d'une requête SQL
Short
getObjectShort(int index)
Récupération de la valeur d'un champ de type short, resultant d'une requête SQL
Short
getObjectShort(String champ)
Récupération de la valeur d'un champ de type short, résultant d'une requête SQL
ArrayList
Vector
getOutParamProc()
Renvoie le Vecteur contenant la liste des parametres OUT et IN_OUT d'une procedure stockee.
short
getShort(int index)
Récupération de la valeur d'un champ de type short, resultant d'une requête SQL
short
getShort(String champ)
Récupération de la valeur d'un champ de type short, résultant d'une requête SQL
String
getString(int index)
Récupération de la valeur d'un champ de type String, resultant d'une requête SQL
String
getString(String champ)
Récupération de la valeur d'un champ de type String, résultant d'une requête SQL
String
getStringNotNull(int index)
Récupération de la valeur d'un champ de type String, resultant d'une requête SQL
String
getStringNotNull(String champ)
Récupération de la valeur d'un champ de type String, résultant d'une requête SQL
void
initDataSource(String dataSourceName, boolean type)
Initialisation du pool de datasource ainsi que le nom et le type de la datasource
void
initOtherDataSource()
Initialisation des datasources non standard
protected void
initTypes()
Initialisation de la table de hashage faisant la correspondance entre le nom d'une classe et sont type.
boolean
protected boolean
protected boolean
static boolean
isValidCriteria(String sCritereFormateSql)
Controle si le critère formatté est un paramètre à passer à JDBC
protected void
lobLogger(String sql)
Envoie une trace au logger si il est actif
boolean
next()
Parcours du resultset (résultat d'une requête SQL).
void
rollback()
Réalise un Rollback.
boolean
saveMSSQLLob(String table, Vector cle, Vector valCle, String champ, byte[] data, boolean bInsert, int iTypeLob)
Charge un LOB dans la base MSSQL.
void
set_autoCommit(boolean commit)
Contrôle de l'autocommit.
protected void
set_call(CallableStatement _call)
protected void
set_isConnected(boolean connected)
protected void
set_prep(PreparedStatement _prep)
protected void
set_rset(ResultSet _rset)
static void
setDataSources(Hashtable dataSources)
protected void
setInTransaction(boolean inTransaction)
void
setNull(PreparedStatement prep, int index)
Prise en compte de l'absence de la méthode getParameterMetaData dans le preparedstatement Oracle
void
setOutCursorList(ArrayList outCursorList)
void
setOutParamProc(Vector outParamProc)
int
traitementParamNonStandard(CallableStatement _call, ProcedureParameter paramProc, int i)
Traitement des parametres non standard dans l'execute procedure
int
traitementRetourNonStandard(ProcedureParameter paramProc, Vector outParamProc, int i)
Traitement des retours non standard
void
verifBaseMSSQL()
Verification du type de base et renvoie une exception en cas de MSSQL
Méthodes héritées de la classe java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Détail des Attributs
logger
protected static final org.apache.log4j.Logger logger
logger: Definition du logger

THIS_CLASS
private static final String THIS_CLASS
THIS_CLASS: Définition de la classe utilisée par le logger

BASE_UNIQUE
protected static final String BASE_UNIQUE
Clé à utiliser en cas de base unique (compatibilité avec anciennes version)

dataSources
protected static Hashtable dataSources
configuration : gestionnaire de la configuration chargée

_configServer
protected static Configuration _configServer
Configuration : Donnees specifiques au serveur.

_rset
private ResultSet _rset
Recordset contenant les données récupérées par la requête

_prep
private PreparedStatement _prep
Statement

_call
private CallableStatement _call
CallableStatement

_connection
private Connection _connection
Connexion à la base de données

_autoCommit
private boolean _autoCommit
Valeur de l'autocommit

_isConnected
private boolean _isConnected
Si true alors JDBCWrapper a déjà une connexion vers la base ouverte

_dataSourceName
protected String _dataSourceName
Nom Jndi de la DataSource à utiliser

_dataSourceType
protected boolean _dataSourceType
Type de datasource true : datasource serveur d'app via JNDI false : datasource dans server.properties

inTransaction
protected boolean inTransaction
variable indiquant l'état de la transaction

mutexDataSource
protected static Object mutexDataSource
Mutex permettant de proteger la Hashtable de datasources

TYPE_REQUETE_QUERY
public static final int TYPE_REQUETE_QUERY
TYPE_REQUETE_QUERY appel d'une methode executeQuery() sur le statement qui valorise un ResultSet qui sera accede par la suite via une methode du JDBCWrapper : en consequence cette fonctionnalite renvoie toujours un int de valeur 0 pour signifier que tout c'est bien deroule.

TYPE_REQUETE_UPDATE
public static final int TYPE_REQUETE_UPDATE
TYPE_REQUETE_UPDATE appel d'une methode executeUpdate() sur le statement qui renvoie un int correspondant au nombre de lignes impactees par la requete : il s'agit de requetes de type update, delete ou insert.

TYPE_REQUETE_EXECUTE
public static final int TYPE_REQUETE_EXECUTE
TYPE_REQUETE_EXECUTE appel d'une methode execute() sur le statement qui renvoie un boolean : celui-ci est converti pour le retour de la façon suivante : true -> 1 et false -> 0.

TYPE_LOB_CLOB
public static final int TYPE_LOB_CLOB
TYPE_LOB_CLOB selectionne la mise en base d'un CLOB pour la méthode saveOracleLob

TYPE_LOB_BLOB
public static final int TYPE_LOB_BLOB
TYPE_LOB_BLOB selectionne la mise en base d'un BLOB pour la méthode saveOracleLob

TYPE_DATE_DATE
public static final String TYPE_DATE_DATE
TYPE_DATE_DATE selectionne le format Date comme retour de getDate()

TYPE_DATE_TIMESTAMP
public static final String TYPE_DATE_TIMESTAMP
TYPE_DATE_TIMESTAMP selectionne le format Timestamp comme retour de getDate()

outParamProc
private Vector outParamProc
outParamProc Vecteur en retour contenant les elements de type OUT et IN_OUT passes en parametre des procedure stockees.

hTypes
private static Hashtable hTypes
hTypes Table de hashage contenant les identifiants des différents types.

outCursorList
private ArrayList outCursorList
Détail des Constructeurs
JDBCWrapper
public JDBCWrapper()
Constructeur par defaut de l'objet JDBCWrapper.

JDBCWrapper
public JDBCWrapper(String dataSourceName)
Constructeur de l'objet JDBCWrapper.

JDBCWrapper
public JDBCWrapper(String dataSourceName,
                   boolean type)
Constructeur de l'objet JDBCWrapper. Permet de spécifier le nom et le type de datasource
Détail des méthodes
initOtherDataSource
public void initOtherDataSource()
Initialisation des datasources non standard

initDataSource
public void initDataSource(String dataSourceName,
                           boolean type)
Initialisation du pool de datasource ainsi que le nom et le type de la datasource
Paramètres:
dataSourceName - dataSourceName
type - type

setOutCursorList
void setOutCursorList(ArrayList outCursorList)
Paramètres:
outCursorList - outCursorList à définir.

getOutCursorList
ArrayList getOutCursorList()
Retours:
Renvoie outCursorList.

getDataSources
static Hashtable getDataSources()
Retours:
Renvoie dataSources.

setDataSources
static void setDataSources(Hashtable dataSources)
Paramètres:
dataSources - dataSources à définir.

get_call
protected CallableStatement get_call()
Retours:
Renvoie _call.

set_call
protected void set_call(CallableStatement _call)
Paramètres:
_call - _call à définir.

get_prep
protected PreparedStatement get_prep()
Retours:
Renvoie _prep.

set_prep
protected void set_prep(PreparedStatement _prep)
Paramètres:
_prep - _prep à définir.

get_rset
protected ResultSet get_rset()
Retours:
Renvoie _rset.

set_rset
protected void set_rset(ResultSet _rset)
Paramètres:
_rset - _rset à définir.

isInTransaction
protected boolean isInTransaction()
Retours:
Renvoie inTransaction.

setInTransaction
protected void setInTransaction(boolean inTransaction)
Paramètres:
inTransaction - inTransaction à définir.

is_isConnected
protected boolean is_isConnected()
Retours:
Renvoie _isConnected.

set_isConnected
protected void set_isConnected(boolean connected)
Paramètres:
connected - _isConnected à définir.

get_dataSourceName
protected String get_dataSourceName()
Retours:
Renvoie _dataSourceName.

get_configServer
protected static Configuration get_configServer()
Retours:
Renvoie _configServer.

getLogger
protected static org.apache.log4j.Logger getLogger()
Retours:
Renvoie logger.

setOutParamProc
void setOutParamProc(Vector outParamProc)
Paramètres:
outParamProc - outParamProc à définir.

beforeExecute
private void beforeExecute()
                    throws JDBCWrapperException
Cette méthode permet de préparer l'exécution d'une requête en fermant éventuellement le PreparedStatement et/ou le RecordSet préalablement ouverts.
Exceptions:
JDBCWrapperException - JDBCWrapperException

closeOtherCnx
public void closeOtherCnx()
                   throws SQLException
Cloture des connextions non standard.
Exceptions:
SQLException - SQLException

close
public void close()
           throws JDBCWrapperException
Ferme la connexion à la base de données ainsi que les éventuels objets afférents (ResultSet et PreparedStatement). Ici nous avons des actions spécifiques dans le cas d'une transaction.
Exceptions:
JDBCWrapperException - Si problème à la fermeture de la connection

closePreparedStatement
private void closePreparedStatement()
                             throws JDBCWrapperException
Ferme le PreparedStatement
Exceptions:
JDBCWrapperException - Si problème à la fermeture du PreparedStatement
Version:
2.3

closeCallableStatement
private void closeCallableStatement()
                             throws JDBCWrapperException
Ferme le CallableStatement
Exceptions:
JDBCWrapperException - Si problème à la fermeture du CallableStatement

commit
public void commit()
            throws JDBCWrapperException
Commit manuel. Dans le cas d'un transaction rien n'est fait.
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

rollback
public void rollback()
              throws JDBCWrapperException
Réalise un Rollback. Dans le cas d'une transaction rien n'est fait.
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

execute
public int execute(String sql,
                   int type)
            throws JDBCWrapperException
Execute une requete
Paramètres:
sql - la requete SQL a executer
type - le type de requete : TYPE_REQUETE_QUERY ou TYPE_REQUETE_UPDATE ou TYPE_REQUETE_EXECUTE
Retours:
int resultat depend du type
  • TYPE_REQUETE_EXECUTE : retour 0 ou 1
  • TYPE_REQUETE_UPDATE : retourne le nombre de ligne impactées
  • TYPE_REQUETE_QUERY : retourne 0 + renseignement de _rset
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

execute
public int execute(String sql,
                   int type,
                   String param)
            throws JDBCWrapperException
Execute une requete avec un paramètre en type String Remet le paramètre dans un vecteur.
Paramètres:
sql - la requete SQL a executer
type - le type de requete : TYPE_REQUETE_QUERY ou TYPE_REQUETE_UPDATE ou TYPE_REQUETE_EXECUTE
param - un parametre de type String
Retours:
int resultat depend du type de la requête.
  • TYPE_REQUETE_EXECUTE : retour 0 ou 1
  • TYPE_REQUETE_UPDATE : retourne le nombre de ligne impactées
  • TYPE_REQUETE_QUERY : retourne 0 + renseignement de _rset
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

verifBaseMSSQL
void verifBaseMSSQL()
             throws JDBCWrapperException
Verification du type de base et renvoie une exception en cas de MSSQL
Exceptions:

setNull
public void setNull(PreparedStatement prep,
                    int index)
             throws SQLException
Prise en compte de l'absence de la méthode getParameterMetaData dans le preparedstatement Oracle
Paramètres:
prep - preparedstatment correspondant à la requete
index - index dans la table
Exceptions:
SQLException

execute
public int execute(String sql,
                   int type,
                   Vector params)
            throws JDBCWrapperException
Execute une requete avec un vecteur de paramètres
Paramètres:
sql - la requete SQL a executer
type - le type de requete : TYPE_REQUETE_QUERY ou TYPE_REQUETE_UPDATE ou TYPE_REQUETE_EXECUTE
params - une liste de parametres sous forme de Vector
ORACLE SQL SERVER
setLong O O
ByteArrayOutputStream O O (BLOB)
setBoolean O O
setString O O
setBigDecimal O O
setDouble O O
setInt O O
setBigDecimal O O
setFloat O O
setShort O O
setTimestamp O voir setDate
setDate O O
setString O O
Dans le cas d'un passage d'un paramettre à null dans le vecteur de paramètres il faut passer par l'objet ObjectNull et renseigner correctement le type avec les contantes de l'objet Types.
Retours:
int resultat depend du type de la requête.
  • TYPE_REQUETE_EXECUTE : retour 0 ou 1
  • TYPE_REQUETE_UPDATE : retourne le nombre de ligne impactées
  • TYPE_REQUETE_QUERY : retourne 0 + renseignement de _rset
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

traitementParamNonStandard
public int traitementParamNonStandard(CallableStatement _call,
                                      ProcedureParameter paramProc,
                                      int i)
                               throws SQLException,
                                      Exception
Traitement des parametres non standard dans l'execute procedure
Retours:
un entier indiquant si le traitement du paramètre transmis a été fait
Exceptions:
SQLException
Exception

traitementRetourNonStandard
public int traitementRetourNonStandard(ProcedureParameter paramProc,
                                       Vector outParamProc,
                                       int i)
                                throws SQLException,
                                       Exception
Traitement des retours non standard
Retours:
un entier indiquant si le traitement du paramètre transmis a été fait
Exceptions:
SQLException
Exception

executeProcedure
public int executeProcedure(String sql,
                            int type,
                            Vector params)
                     throws JDBCWrapperException
Execute une procedure
Paramètres:
sql - la requete SQL a executer
type - le type de requete : TYPE_REQUETE_QUERY ou TYPE_REQUETE_UPDATE ou TYPE_REQUETE_EXECUTE
params - une liste de parametres sous forme de Vector
ORACLE SQL SERVER
setLong O O
setBinaryStream O O
setBoolean O O
setString O O
setBigDecimal O O
setDouble O O
setInt O O
setBigDecimal O O
setFloat O O
setShort O O
setTimestamp O x
setString O O
STRUCT O x
COLLECTION O x
Retours:
int resultat depend du type de requête.
  • TYPE_REQUETE_EXECUTE : retour 0 ou 1
  • TYPE_REQUETE_UPDATE : retourne le nombre de ligne impactées
  • TYPE_REQUETE_QUERY : retourne 0 + renseignement de _rset
Les résultats sont récupérables uniquement au travers des méthodes getXxxx(int index)
Exceptions:
JDBCWrapperException - dans le cas d'erreur lors de l'éxécution de la requête (erreur SQL par ex.).

decodeClassName
protected int decodeClassName(String className)
                       throws JDBCWrapperException
Retourne le type dépendant du nom d'une class contenu dans la table da hashage
Paramètres:
className - Nom de la class
Retours:
Type de la class
Exceptions:

initTypes
protected void initTypes()
Initialisation de la table de hashage faisant la correspondance entre le nom d'une classe et sont type.

finalize
protected void finalize()
                 throws Throwable
Methode exécutée avant de décharger l'objet JDBCWrapper de la mémoire. Ferme la connection à la BD si ce n'est pas déjà fait. La méthode finalize n'etant pas contrôlée, il ne faut pas compter dessus pour fermer la connexion à la BD et libérer cette ressource. Aussi la méthode close doit être appelée explicitement sur les objets JDBCWrapper dans la clause finally.
Dépacées:
finalize in class Object
Exceptions:
Throwable

getConnection
Connection getConnection()
                  throws Exception
Récupération d'une connexion à la base de données. Ici nous avons des actions spécifiques dans le cas d'une transaction.
Retours:
une connexion à la base de données
Exceptions:
Exception

getDataSourceInProperties
private DataSource getDataSourceInProperties(String name)
                                      throws Exception
Permet de récupérer une datasource dans le fichier de properties
Paramètres:
name - String
Retours:
la datasource crée à partir des informations lu dans le fichier de properties
Exceptions:
Exception - Exception

getDataSource
protected synchronized DataSource getDataSource()
                                         throws JDBCWrapperException
Récupération d'une des sources de données mises en cache pour améliorer les performances.
Retours:
objet DataSource correspondant au dataSourceName
Exceptions:

getDate
public Date getDate(String champ)
             throws JDBCWrapperException
Récupération de la valeur d'un champ de type Date, resultant d'une requête SQL
Paramètres:
champ - nom du champ en String
Retours:
valeur du champ en objet Date
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getDate
public Date getDate(int index)
             throws JDBCWrapperException
Récupération de la valeur d'un champ de type Date, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getDouble
public double getDouble(String champ)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type double, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getDouble
public double getDouble(int index)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type double, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectDouble
public Double getObjectDouble(String champ)
                       throws JDBCWrapperException
Récupération de la valeur d'un champ de type double, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectDouble
public Double getObjectDouble(int index)
                       throws JDBCWrapperException
Récupération de la valeur d'un champ de type double, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getInt
public int getInt(String champ)
           throws JDBCWrapperException
Récupération de la valeur d'un champ de type int, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getInt
public int getInt(int index)
           throws JDBCWrapperException
Récupération de la valeur d'un champ de type int, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

bigDecimalToInteger
private Integer bigDecimalToInteger(BigDecimal big)
                             throws JDBCWrapperException
Exceptions:

getObjectInt
public Integer getObjectInt(String champ)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type int, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectInt
public Integer getObjectInt(int index)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type int, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getLong
public long getLong(String champ)
             throws JDBCWrapperException
Récupération de la valeur d'un champ de type long, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getLong
public long getLong(int index)
             throws JDBCWrapperException
Récupération de la valeur d'un champ de type long, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectLong
public Long getObjectLong(String champ)
                   throws JDBCWrapperException
Récupération de la valeur d'un champ de type Long, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
Objet Long ou null
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectLong
public Long getObjectLong(int index)
                   throws JDBCWrapperException
Récupération de la valeur d'un champ de type Long, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
Objet Long ou null
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObject
public Object getObject(String champ)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type Object (par exemple Objet Oracle), résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObject
public Object getObject(int index)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type Object (par exemple Objet Oracle), resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getString
public String getString(String champ)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type String, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getString
public String getString(int index)
                 throws JDBCWrapperException
Récupération de la valeur d'un champ de type String, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ par String.ValueOf() ou null
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getStringNotNull
public String getStringNotNull(String champ)
                        throws JDBCWrapperException
Récupération de la valeur d'un champ de type String, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getStringNotNull
public String getStringNotNull(int index)
                        throws JDBCWrapperException
Récupération de la valeur d'un champ de type String, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBinaryStream
public InputStream getBinaryStream(String champ)
                            throws JDBCWrapperException
Récupération d'un flux de données binaires (utilisé pour récupérer les images stockées en base)
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBlob
public InputStream getBlob(String champ)
                    throws JDBCWrapperException
Récupération d'un flux de données binaires (utilisé pour récupérer les images stockées en base)
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBoolean
public boolean getBoolean(String champ)
                   throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBoolean
public boolean getBoolean(int index)
                   throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectBoolean
public Boolean getObjectBoolean(String champ)
                         throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectBoolean
public Boolean getObjectBoolean(int index)
                         throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBigDecimal
public BigDecimal getBigDecimal(String champ)
                         throws JDBCWrapperException
Récupération de la valeur d'un champ de type BigDecimal, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getBigDecimal
public BigDecimal getBigDecimal(int index)
                         throws JDBCWrapperException
Récupération de la valeur d'un champ de type BigDecimal, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectBigDecimal
public BigDecimal getObjectBigDecimal(String champ)
                               throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectBigDecimal
public BigDecimal getObjectBigDecimal(int index)
                               throws JDBCWrapperException
Récupération de la valeur d'un champ de type boolean, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getFloat
public float getFloat(String champ)
               throws JDBCWrapperException
Récupération de la valeur d'un champ de type float, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getFloat
public float getFloat(int index)
               throws JDBCWrapperException
Récupération de la valeur d'un champ de type float, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectFloat
public Float getObjectFloat(String champ)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type float, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectFloat
public Float getObjectFloat(int index)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type float, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getShort
public short getShort(String champ)
               throws JDBCWrapperException
Récupération de la valeur d'un champ de type short, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getShort
public short getShort(int index)
               throws JDBCWrapperException
Récupération de la valeur d'un champ de type short, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectShort
public Short getObjectShort(String champ)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type short, résultant d'une requête SQL
Paramètres:
champ - nom du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

getObjectShort
public Short getObjectShort(int index)
                     throws JDBCWrapperException
Récupération de la valeur d'un champ de type short, resultant d'une requête SQL
Paramètres:
index - index du champ
Retours:
valeur du champ
Exceptions:
JDBCWrapperException - Si erreur lors de la lecture du resultset, résultat de la requête SQL

lobLogger
protected void lobLogger(String sql)
Envoie une trace au logger si il est actif
Paramètres:
sql - Requête SQL à envoyer au Logger si il est actif

saveMSSQLLob
public boolean saveMSSQLLob(String table,
                            Vector cle,
                            Vector valCle,
                            String champ,
                            byte[] data,
                            boolean bInsert,
                            int iTypeLob)
                     throws JDBCWrapperException
Charge un LOB dans la base MSSQL. Les deux vecteurs d'entrée doivent avoir exactement le même nombre d'objet. Ces Objet sont essentiellement des String.
Paramètres:
table - nom de la table
cle - Vecteur de String contenant l'ensemble des champs nécéssaire a la selection de la bonne ligne
valCle - Vecteur de String contrnant les valeurs des champs pour la selection de la ligne
champ - nom du champs LOB
bInsert - boolean autorisant ou non l'insert de la ligne contenant le blob. Permet d'updater un blob en positionnant sur false.
iTypeLob - indique le type du LOB à insérer : TYPE_LOB_CLOB ou TYPE_LOB_BLOB
Retours:
succes ou échec
Exceptions:
JDBCWrapperException - Si erreur sur Vector, lors de la lecture du resultset, résultat de la requête SQL

getOutParamProc
public Vector getOutParamProc()
Renvoie le Vecteur contenant la liste des parametres OUT et IN_OUT d'une procedure stockee.
Retours:
outParamProc Vector liste des parametres OUT et IN_OUT

next
public boolean next()
             throws JDBCWrapperException
Parcours du resultset (résultat d'une requête SQL). Passe à l'élément suivant.
Retours:
True s'il y a un élément suivant, false sinon
Exceptions:
JDBCWrapperException - Si erreur dans la lecture du resultset, résultat de la requête SQL

is_autoCommit
public boolean is_autoCommit()
Retours:
Return the _autoCommit.

set_autoCommit
public void set_autoCommit(boolean commit)
Contrôle de l'autocommit. Verification si nous somme en transaction. Si oui désactivation de cette fonction.
Paramètres:
commit - The _autoCommit to set.

isValidCriteria
public static boolean isValidCriteria(String sCritereFormateSql)
Controle si le critère formatté est un paramètre à passer à JDBC
Paramètres:
sCritereFormateSql - Critère formatté par la méthode
Retours:
Indicateur de paramètre
Voir Aussi:

addCriteria
public static String addCriteria(String sSql,
                                 String sSqlCritere)
Ajouter un critère à la requête en construction
Paramètres:
sSql - Requête en construction
sSqlCritere - Critère formatté à ajouter
Retours:
Requête mise à jour

formatCriteria
public static String formatCriteria(String sNomCritere,
                                    String sValeurCritere)
Formate un critère pour les requêtes SQL
Paramètres:
sNomCritere - Nom du critère
sValeurCritere - Valeur du critère
Retours:
Element SQL à placer dans le requête

Framework Serveur J2EE ACube V3.1.0
CLASSE PRECEDANTE CLASSE SUIVANTE
SOMMAIRE: ATTR CONSTR METH DETAIL: ATTR CONSTR METH

Version 3.1.0 du 06/11/2009 / Etat : Validé
Cette création est mise à disposition selon le Contrat Paternité - Pas d'Utilisation Commerciale - Partage des Conditions Initiales à l'Identique disponible en ligne http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ ou par courrier postal à Creative Commons, 559 Nathan Abbott Way, Stanford,California 94305, USA.
Documentation generated by DocFlex