Cette fonction de gestion des fichiers ".properties" permet de récupérer la valeur d'une clé.
La valeur de la clef est une chaîne de caractères.
Domaine d'application
Client Java,
Serveur Java,
Client Adélia Web,
Client Adélia Cloud.
Paramètres
ALPHA(n) |
NomFichier |
Nom du fichier. |
ALPHA(n) |
NomClef |
Nom de la clef dont la valeur est à récupérer. |
ALPHA(n) |
ValeurClef |
Valeur de la clef. |
NUM_BIN_4 |
LongueurValeurClef |
Longueur du paramètre ValeurClef . |
BOOL |
CodeRetour |
Code retour de l'opération : *VRAI si l'opération s'est déroulée correctement. *FAUX dans le cas contraire. |
L'expression langue locale est employée ici pour désigner le couple (langue/pays).
Les règles de recherche du fichier NomFichier sont différentes suivant la façon dont est spécifié le nom du fichier :
- Le fichier est recherché dans le contexte d'exécution Java (CLASSPATH), en prenant en compte la langue locale Java/Web, si les deux conditions suivantes sont réunies :
- Le nom du fichier est indiqué sans l'extension .properties.
- La notation de type "package Java" est utilisée, si le fichier se trouve dans un éventuel sous-répertoire.
(La recherche porte en priorité sur le fichier ".properties" suffixé par le code langue - et éventuellement le code pays - correspondant à la langue locale.)
- Le fichier est recherché dans le chemin indiqué si les trois conditions suivantes sont réunies :
- Le chemin est un chemin absolu.
- Le nom du fichier est indiqué avec son extension (normalement, .properties).
- La notation classique "chemin de sous-répertoire" est utilisée (les caractères / ou \ peuvent être employés).
Si le chemin indiqué est maintenant un chemin relatif, le fichier est recherché dans le répertoire user.dir (normalement répertoire de lancement de la machine virtuelle Java - JVM), puis dans le contexte d'exécution Java (CLASSPATH).
La langue locale Web n'est pas prise en compte.
Si le nom du fichier est indiqué sous la forme [URL]Nom_ressource_référence;NomFichier, la ressource est d'abord recherchée selon l'URL indiquée.
Si la ressource n'est pas trouvée, le fichier NomFichier est recherché en fonction des règles définies dans les paragraphes précédents.
Remarque : Cette notation URL peut être intéressante pour externaliser le fichier, dans le cadre d'un serveur Websphere.
Cliquer ici pour plus d'informations sur l'externalisation des fichiers.
Par exemple
NomFichier |
= 'Parametres' |
NomClef |
= 'Version' |
ValeurClef |
= *BLANK |
LongueurValeurClef |
= 50 |
CodeRetour |
= *FAUX |
APPELER_DLL 'vatoolbx.dll' 'VaToolBxJavaQueryValue' NomFichier NomClef ValeurClef LongueurValeurClef CodeRetour
NomFichier |
= 'Parametres.properties' |
NomClef |
= 'Version' |
ValeurClef |
= *BLANK |
LongueurValeurClef |
= 50 |
CodeRetour |
= *FAUX |
APPELER_DLL 'vatoolbx.dll' 'VaToolBxJavaQueryValue' NomFichier NomClef ValeurClef LongueurValeurClef CodeRetour
NomFichier |
= '[URL]url/monappli/parametres;Parametres.properties' |
NomClef |
= 'Version' |
ValeurClef |
= *BLANK |
LongueurValeurClef |
= 50 |
CodeRetour |
= *FAUX |
APPELER_DLL 'vatoolbx.dll' 'VaToolBxJavaQueryValue' NomFichier NomClef ValeurClef LongueurValeurClef CodeRetour
