UpsQry.IOrdreSql

Définition


/***************************************************************/

Interface IOrdreSql Defaut TailleSegment 8 ConserverObjets

/* Objet : Interface definissant un ordre Sql.                  */

/****************************************************************/

/*-------------------------------------------------------------*/

/* Heritage des proprietes d'Objet.  */

/*-------------------------------------------------------------*/

Prive :

	
	EstInstanceDe : Type Lecture Public;

/*-------------------------------------------------------------*/

/* Proprietes propres.                         */

/*-------------------------------------------------------------*/

Prive :

	
   NomOrdreSql : Caractere Lecture Public Trace;
	

   SourceOrdreSql : Caractere Lecture Public;
	

   TailleTableauParametres : Entier Lecture Public;
	

   TempsDeGarde : Entier Lecture Public;
	

   ConnexionSqlMere : Nul Ou IConnexionSql Lecture Public;

/*-------------------------------------------------------------*/

/* Heritage des methodes d'Objet.    					      */

/*-------------------------------------------------------------*/

Public :

	
	Fonction Optimiser(Invariant) Identique(O : Nul Ou Objet) Retourner Nul Ou Booleen;
	

	Procedure Convertir(O : Nul Ou Objet);
	

	Fonction Optimiser(Invariant) CreeParLeServeur() Retourner Entier;
	

	Fonction Optimiser(Invariant) CreeParLeProcessus() Retourner Entier;
	

	Fonction Optimiser(Invariant) CreeDansLEntrepot() Retourner Entrepot;
	

	Fonction Cloner(EntrepotCible : Nul Ou Entrepot=Nul, Profondeur : ModeClonage = ClonageObjetSeul) Retourner Nul Ou Objet;
	

	Fonction LirePropriete(NomPropriete : Caractere) Retourner Nul Ou Objet;
	

	Procedure EcrirePropriete(NomPropriete : Caractere, Valeur : Nul Ou Objet);
	

	Fonction IncrementerDecrementerPropriete(NomPropriete : Nul Ou Caractere, Incrementer : Booleen, Prefixe : Booleen) Retourner Nul Ou Objet;
	

	Procedure SupprimerPropriete(NomPropriete : Caractere);
	

	Fonction Optimiser(Invariant) EnumererProprietes(NumeroPropriete : Entier, TypePropriete : Nul Ou Type=? Sortie, PeutEtreNul : Booleen=? Sortie, Aide : Nul Ou Caractere=? Sortie, NomEnumere : Nul Ou Caractere=? Sortie) Retourner Nul Ou Caractere;
	

	Fonction Optimiser(Invariant) Adresse() Retourner Nul Ou Caractere;

Prive :

	
	Fonction Exporter(E : Nul Ou IEchangeElementaire) Retourner Boolean;
	

	Fonction Importer(E : Nul Ou IEchangeElementaire, EntrepotCible : Nul Ou Entrepot=Nul, EstFiltre : Booleen=Faux, V : Entier=0, R : Entier=0, C : Entier=0) Retourner Nul Ou Objet;

/*-------------------------------------------------------------*/

/* Methodes propres.    					      */

/*-------------------------------------------------------------*/

Public :

	
   Procedure DeclarerParametre(NomParametre : Caractere, T : Nul Ou Type, SorteDuParametre : SorteParametre=ParametreEntree, TailleMax : Entier=0);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Enumere);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Entier);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Reel);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Caractere);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Date);
	

   Procedure EcrireParametre(NomParametre : Caractere, Valeur : Nul Ou Binaire);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Enumere Sortie);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Entier Sortie);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Reel Sortie);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Caractere Sortie);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Date Sortie);
	

   Procedure LireParametre(NomParametre : Caractere, Valeur : Nul Ou Binaire Sortie);
	

   Procedure PreparerSql();
	

   Procedure ExecuterSql(NbEnregistrementsImpactes : Entier=? Sortie);
	

   Fonction Optimiser(Invariant) EnumererParametres(Numero : Entier, TypeParametre : Nul Ou Type=? Sortie, 
      SorteDuParametre : SorteParametre=? Sortie) Retourner Nul Ou Caractere;

Prive :

	
   Destructeur(MettreEnAnteMemoire : Booleen) Retourner Booleen;

Fin Interface

L'interface IOrdreSql modélise un ordre pour une base de données relationnelles accédée en Structured Query Language (SQL).

L'interface IOrdreSql ne possède pas de constructeur.

La séquence d'actions sur un ordre Sql est la suivante :

Création de l'ordre Sql.
Par l'appel de la méthode CreerOrdreSql d'un type implémentant l'interface IConnexionSql.
Déclaration des paramètres.
Par un ou plusieurs appels à la méthode DeclarerParametre.
Préparation de l'exécution.
Par l'appel de la méthode PreparerSql.
Exécution.
Pour une ou plusieurs fois :
- Transmission des paramètres d'entrée.
  Par un ou plusieurs appels à la méthode EcrireParametre.
- Exécution stricto sensus.
  Par un ou plusieurs appels à la méthode ExecuterSql.
- Récupération des paramètres de sortie.
  Par un ou plusieurs appels à la méthode LireParametre.
Libération de l'ordre Sql.
Par l'appel implicite au destructeur.

Opérateurs

L'interface IOrdreSql possède les opérateurs standards suivant :

= pour l'affectation d'un ordre dans une autre.
== pour l'égalité entre deux ordres. Le résultat est un booléen.
!= pour l'inégalité entre deux ordres. Le résultat est un booléen.

Exemple


Principal

/*******/

Variable

/******/


	C : Nul Ou IOrdreSql;

	C2 : Nul Ou IOrdreSql;



Debut

...

/* On prepare l'ordre Sql. */

C.Preparer();

...

/* On execute l'ordre Sql. */

C.Executer();

...

Si C==C2 Alors

/* Egalité entre deux ordres Sql. */ 

	...

Fin Si

Si C!=C2 Alors

/* Inégalité entre deux ordres Sql. */ 

	...

Fin Si

Fin Principal

Voir aussi

OrdreDb2, OrdreMaxDB, OrdreMySql, OrdreOdbc, OrdreOracle, OrdrePostgreSQL, et OrdreSqlServer pour la mise en oeuvre de cette interface.

Traduction


-	-	-	-	-	-	-	-	-