heg haute école de gestion de neuchâtel gestionnaire d'exception procédures stockées pl/sql

hegHaute école de gestionde Neuchâtel

Gestionnaire d'exception

Procédures stockées PL/SQL

20/12/99 ErreursPLSQL V0-0 2


Têtes de chapitres

1. Rappel théorique 4

2. Fonctionnement du gestionnaire 8

3. Utilisation du gestionnaire 21

4. Mémorisation des erreurs 24

5. Fonctionnement interne 27

6. Erreurs d'utilisation du gestionnaire 34

7. Distribution et installation 37



Table des matières• Rappel théorique 4• Fonctionnement du gestionnaire 8

– Principe de base 9

– Procédure Err_Traite(p,m) 11

– Création d'une exception 14

– Illustration du fonctionnement 16

• Utilisation du gestionnaire 21– Services du package ERREURS 22

– Bonne utilisation du package ERREURS 23

• Mémorisation 24• Fonctionnement interne 27

– Constantes et variables 28

– Procédure Err_Traite 29

– Procédure Err_Envoie 31

• Erreurs d'utilisation 34

– Instruction NULL 35

– Absence de section d'exception 36

• Distribution et installation 37


1. Rappel théorique



Rappel

PROCEDURE MaProcedureIS

/* Déclarations */

BEGIN

END;

/* Bloc d'instruction */

EXCEPTION

WHEN UneException THEN

/* Action spécifique à UneException */

WHEN OTHERS THEN

/* Action globale à toutes les exceptions non résolues */

Section d'exécution

Section d'exception



Syntaxe

exc_MonException Exception;

RAISE exc_MonException;

EXCEPTION

WHEN exc_MonException THEN

WHEN OTHERS THEN



BEGIN…RAISE_APPLICATION_ERROR (MonCode, MonMessage);...

EXCEPTIONWHEN ... THEN...

END;

RAISE_APPLICATION_ERROR

CLIENT -20145Le compte n'est pas suffisamment alimenté

Serveur


2. Fonctionnement du gestionnaire ERREURS



Principe de base

Une exception est une erreur interne du SGBD

ou de l'application qui provoque impérativement:

• L'annulation de toutes les opérations en cours

• L'arrêt impératif de tout traitement

• La remontée du message d'erreur à l'utilisateur

• L'enregistrement des paramètres de

l'environnement



CLIENT

Résolution des exceptions

BEGIN CorpsEXCEPTION

WHEN OTHERS THENErr_Traite(p,m)

END;



END;



END;

A

B

C

Serveur

1

3

2

5

6

7

4



Procédure Err_Traite (P, M)

Crée une nouvelle occurrence d'erreur

?Nouvelle occurrence

d'erreur

Enregistre le nom de la procédure dans

laquelle l'exception est résolue

Mémorise le message associé à l'exception

Propage l'exception

Début

Fin

Oui

Non



Règle d'appel de Err_Traite

BEGIN Corps

END;

A

EXCEPTIONWHEN OTHERS THENErr_Traite(p,m)

BEGIN Corps

END;

B


BEGIN Corps

END;

C




Exemple d'appel de Err_Traite



Création d'une exception

BEGIN Début du Corps

Suite du corps


END;

Err_Envoie(message)



Exemple d'appel de Err_Envoie



Illustration du fonctionnement

CLIENT

TestErreur1

TestErreur1A

TestErreur01

TestErreur001

/* Erreur développeur diviseur < 0 *//* Erreur interne diviseur = 0*/



Exemple d'erreur interne avec le client SQL*PLus



Exemple d'erreur du développeur avec le client SQL*PLus



Exemple d'erreur du développeur avec un client Web



Exemple d'erreur interne avec un client Web


3. Utilisation du gestionnaire ERREURS



Services du package ERREURS

Err_Traite ( pe_Package IN VARCHAR2, pe_Module IN VARCHAR2 )

Elle résout toutes les exceptions du module. Elle enregistre l'exception survenue et la renvoie à la procédure appelante.

pe_Package : Package qui contient la procédure à protéger

pe_Module : Nom de la fonction ou procédure protégée

Err_Envoie (pe_Message IN VARCHAR2 )

Elle crée une exception qui sera immédiatement résolue dans le bloc EXCEPTION par la procédure Err_Traite.

pe_Message : Message associé à l'erreur



Bonne utilisation du package ERREURS

PROCEDURE MaProcedure IS

BEGIN

Début du Corps

Suite du corps

END;

Err_Envoie(message)


Toujours

Seulement s' il est nécessaire pour le développeur de déclencher une erreur


4. Mémorisation



Vue de la journalisation



Structure de mémorisation


5. Fonctionnement interne



Constantes et variables

co_ErrTransmise

co_ErrApplication

vg_NumErreur

vg_MessageInitial

vg_NumOrdreErreur



Procédure Err_Traite

1

2

3

4



Chronologie d'appels de Err_Traite

CLIENT


WHEN OTHERS THENErr_Traite('P', 'A')

END;


WHEN OTHERS THENErr_Traite('P', 'B')

END;

B21

4 3

P

vg_NumErreur := xvg_NumordreErreur := 1vg_MessgeInitial := SQLERRM +…...RAISE_APPLICATION_ERROR (co_ErrRetransmise, vg_MessageInitial)

vg_NumordreErreur := 2...RAISE_APPLICATION_ERROR (co_ErrRetransmise, vg_MessageInitial)

Chr

onol

ogie

de

dépi

lem

ent e

t d'

appe

l de

la p

rocé

dure

Err

_Tra

ite



Procédure Err_Envoie



Corps de la procédure Err_EnregNvle



Corps de la procédure Err_EnregAppel


6. Erreurs d'utilisation du gestionnaire

ERREURS



Instruction Null



Absence de section d'exception


7. Distribution et installation

heg haute école de gestion de neuchâtel gestionnaire d'exception procédures stockées pl/sql

Documents