4.5-00 : release note du socle technique (septembre 2003)

Le socle technique utilise l'implémentation LOG4J version 1.2.8.

• un nouveau fichier jar :

log4j-1.2.8.jar

• Modifier fichier de démarrage de OC4J. Il doit contenir les quatre options suivantes en plus des autres déjà présentes :

• Dlog4j.configuration=default_log4j.xml
• DSessionClass=fr.ACE.technicalframework.business.applicationmodule.GnxSessionImpl
• Djbo.initpoolsize=0
• Djbo.maxpoolsize=0

Attention : ce fichier de démarrage devient spécifique à la version 4.5.0. Pour continuer de lancer OC4J pour les autres versions, il faut conserver une copie du fichier de démarrage précédent.

• Modifier la configuration de l'application (fichier web.xml)

Le nom du fichier de paramétrage de LOG4J sera paramétrable par les variables d'environnements de la servlet, comme c'est déjà le cas pour le fichier de configuration d'eGX.

fichier : web.xml

< web-app >

< description > web Application </ description >

< context-param >

< param-name > egx_context_url </ param-name >

< param-value />

</ context-param >

< context-param >

< param-name > egx_traceconf_path </ param-name >

< param-value > default_log4j.xml </ param-value >

</ context-param >

< context-param >

< param-name > egx_configuration_path </ param-name >

< param-value > configuration.xml </ param-value >

</ context-param >

< context-param >

< param-name > egx_instance_name </ param-name >

< param-value />

</ context-param >

< servlet >

…

…

</ web-app >

fichier : orion-web.xml

< orion-web-app deployment-version =" 9.0.2.1.0 " jsp-cache-directory =" ./persistence " temporary-directory =" ./temp " internationalize-resources =" false " default-mime-type =" application/octet-stream " servlet-webdir =" /servlet/ ">

< context-param-mapping name =" egx_traceconf_path "> develop_log4j.xml </ context-param-mapping >

< context-param-mapping name =" egx_configuration_path "> configuration.xml </ context-param-mapping >

< context-param-mapping name =" egx_instance_name "> instance_SocleTechCourant </ context-param-mapping >

< virtual-directory virtual-path =" / " real-path =" ../../../default-web-app/egx450/btoc "/>

< resource-ref-mapping name =" jdbc/eGX-DS " location =" jdbc/OracleSoc1CoreDS "/>

</ orion-web-app >

• Copier et/ou écraser des fichiers dans OC4J. (en 4.5.0 uniquement)
• écraser les versions précédentes de configuration.xsd par celle qui se trouve dans le répertoire "doc/config".
• copier dans la racine de chaque web module egx 4.5.0 les fichiers "develop_log4j.xml" et "log4j.dtd" que vous trouverez dans le répertoire "doc/config".
• copier dans chaque répertoire "classes" des web module, les fichiers "default_log4j.xml" et "log4j.dtd" que vous trouverez dans le répertoire "src".

La gestion des traces nécessite l'ajout d'un ApplicationModule et de trois actions.

Modèle de configuration :

< applicationmodule name =" AdminManager " defFullName =" fr.ACE.technicalframework.businesscomponent.applicationmodule.AdminManager " sessionType =" statefull "/>

< action name =" trace_reload " class =" fr.ACE.technicalframework.application.action.TraceReload "/>

< action name =" trace_enable " class =" fr.ACE.technicalframework.application.action.TraceEnable ">

< required >

< param name =" loggerName " type =" String "/>

</ required >

</ action >

< action name =" trace_disable " class =" fr.ACE.technicalframework.application.action.TraceDisable ">

< required >

< param name =" loggerName " type =" String "/>

</ required >

</ action >

Ce nouvel attribut de l'élément "business_session" permet de paramétrer la fréquence de déconnexion au SGBD.

La taille maximum des libellés des messages est de 80 caractères. (taille du champ libut_mes)

• Ajout de la clé publique de retrieve et de sort pour la BusinessView courante.

Exemple de résultat :

<VueSociete type= "View" name= "Societe" total_business_row= "12" nbline= "999" numpage= "1" nbpage= "1" retrieve_key= "ONE" sort_key= "ASC" >

Un fichier par frame dans le répertoire "log".

ex : Presentation_<nom_de_frame>.xml

selon trois fréquences : none, session, request.

• rechargement du fichier de configuration des traces :

cinematic=trace_reload();display(0)

• activation et désactivation des traces:

trace timer

cinematic=trace_enable(timer);display(0)

cinematic=trace_disable(timer);display(0)

trace data

cinematic=trace_enable(data);display(0)

cinematic=trace_disable(data);display(0)

A chaque fois qu'un clearcache est appelé sur une ViewObject eGX, il y a une trace qui représente la pile d'appel dans le fichier de log.

Afin d'affiner le contenu de la trace, une nouvelle catégorie a été ajoutée dans le fichier develop_log4j.xml :

<category name= "fr.ACE.technicalframework.business.viewobject.GnxViewObjectImpl" >

<level value= "warn" />

<appender-ref ref= "egx.log" />

</category>

Si le niveau est à "warn", vous ne verez que les clearCache produits par des méthodes métier.

Si le niveau est à "debug", vous verrez tous les clearCache, y compris ceux qui sont produits par l'effet de l'utilisation de l'attribut "deconnectFrequency".

En plus des traces de type select déjà disponibles, il est maintenant possible de tracer les ordres de type insert, update et delete.

La gestion du login prend maintenant en compte l'entité lors de ses accès à la base de données. Cette amélioration demande la présence d'un nouveau paramètre dans la cinématique de login.

En plus des paramètres username et password, il faut y joindre le paramètre entity. Cela implique des modifications dans les clients du login : la configuration et la feuille de style.