Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ada:sicoferp:rentas:herramientas:logger [2021/08/30 13:51] 192.168.177.37 |
ada:sicoferp:rentas:herramientas:logger [2021/08/30 14:16] (actual) 192.168.177.37 |
||
---|---|---|---|
Línea 7: | Línea 7: | ||
]]. | ]]. | ||
* Propagación de excepciones al usuario (front-end) a través de la implementación del método abstracto, el cual debe propagar de cara al usuario por el uso de las herramientas de mensajería utilizadas por el framework del front-end de cada aplicativo. | * Propagación de excepciones al usuario (front-end) a través de la implementación del método abstracto, el cual debe propagar de cara al usuario por el uso de las herramientas de mensajería utilizadas por el framework del front-end de cada aplicativo. | ||
- | public void addMessage(final String idMessage, final int severity, final String resume, final String detail) | + | |
+ | Esta API está escrita y compilada en ''Java 6'' y definida bajo los criterios de configuración y dependencias gestionadas a través de Maven escritas en el archivo [[ada:sicoferp:rentas:herramientas:logger:pom.xml|pom.xml]]. | ||
+ | |||
+ | El código fuente está disponible en versión branch en el [[http://adacsc.co:1443/svn/repository/ADA/SITU/CARTERAYRECAUDO/FUENTES/branches/development/logger|respositorio SVN]] | ||
- | ===== Logger ===== | + | ===== Log ===== |
- | Implementación de los diferentes métodos de llamado a escritura en el servidor de aplicaciones a través de la API log4j, según los diferentes niveles de severidad: | + | Implementación de los diferentes métodos de llamado a escritura en el servidor de aplicaciones a través de la API ''log4j'' en su versión ''1.2.11'', según los diferentes niveles de severidad: |
- | * **Debug**: Se realizará la escritura en el log sólo si está habilitada en este modo. | + | * Debug: Se realizará la escritura en el log sólo si está habilitada en este modo. |
- | * **Info**: | + | * Info: registra en el log del servidor cualquier notificación en este nivel de severidad. |
- | * Warn | + | * Warn: registra en el log del servidor cualquier notificación en este nivel de severidad. |
- | * Error | + | * **Error**: registra en el log del servidor y a través del servicio de registro de log cualquier notificación en este nivel de severidad. |
- | * Fatal | + | * **Fatal**: registra en el log del servidor y a través del servicio de registro de log cualquier notificación en este nivel de severidad. |
- | Los dos últimos métodos harán uso de la notificación vía WS para registro en DDBB. | + | **NOTA**: Los dos últimos métodos harán uso de la notificación vía WS para registro en DDBB. |
- | Esta funcionalidad hará uso de la configuración definida, log.json. Tal como se puede observar, dicha configuración está escrita en formato. | + | Esta funcionalidad hará uso de la configuración definida en [[ada:sicoferp:rentas:herramientas:logger:log.json|log.json]]. Tal como se puede observar, dicha configuración está escrita en ese formato, para lo cual se ha definido la clase abstracta [[ada:sicoferp:rentas:herramientas:logger:alogger|com.ada.utilidades.situ.log.ALogger]]. |
===== Notificación ===== | ===== Notificación ===== | ||
Línea 44: | Línea 47: | ||
</code> | </code> | ||
- | el cual al ser un método abstracto será de obligatoria implementación en la clase que extiende de la abastracta | + | el cual al ser un método abstracto será de obligatoria implementación en la clase que extiende de la abstracta [[ada:sicoferp:rentas:herramientas:logger:alogger|com.ada.utilidades.situ.log.ALogger]] para garantizar de forma limpia, la notificación de los eventos presentados hasta el usuario. |
+ | Un ejemplo de la implementación de la clase [[ada:sicoferp:rentas:herramientas:logger:alogger|ALogger]] puede ser [[ada:sicoferp:rentas:herramientas:logger:log|Log]], previa adición de la API ''logger'' al ''.classpath'' del sistema cliente. | ||
- | [[ada:sicoferp:rentas:herramientas:logger:alogger|com.ada.utilidades.situ.log.ALogger]] | + | **NOTA**: En el archivo de configuración del servidor o en una variable de entorno la llave ''LOG_CONFIGURATION_PATH'', con valor por ejemplo de ''C:\co\ada\situ\log.json'', se deberá configurar la ruta de ubicación del archivo [[ada:sicoferp:rentas:herramientas:logger:log.json|log.json]]. El cual es el insumo principal del proceso para darle control a las excepciones. |
- | + | ||
- | + | ||
- | para garantizar de forma limpia, la notificación de los eventos presentados hasta el usuario. Un ejemplo de la implementación de la clase ''ALogger'' puede ser el siguiente, previa adición al .classpath del sistema cliente, de la API logger. | + | |
- | + | ||
- | <file java Log.java> | + | |
- | package com.ada.utilidades; | + | |
- | + | ||
- | import javax.faces.application.FacesMessage; | + | |
- | import javax.faces.application.FacesMessage.Severity; | + | |
- | import javax.faces.context.FacesContext; | + | |
- | + | ||
- | import com.ada.utilidades.situ.log.ALogger; | + | |
- | + | ||
- | /** | + | |
- | * Clase que implementa la clase ALogger para consumo del log del sistema | + | |
- | * | + | |
- | * @author xxxxxxx | + | |
- | * @version xxxxxxx | + | |
- | */ | + | |
- | public class Log extends ALogger { | + | |
- | public static Log getInstance() { | + | |
- | if (instance == null) { | + | |
- | instance = new Log(); | + | |
- | } | + | |
- | return (Log) instance; | + | |
- | } | + | |
- | + | ||
- | @Override | + | |
- | public void addMessage(final String idMessage, final int severity, final String resume, final String detail) { | + | |
- | Severity severity2 = FacesMessage.SEVERITY_INFO; | + | |
- | switch (severity) { | + | |
- | case warn: | + | |
- | severity2 = FacesMessage.SEVERITY_WARN; | + | |
- | break; | + | |
- | case error: | + | |
- | severity2 = FacesMessage.SEVERITY_ERROR; | + | |
- | break; | + | |
- | case fatal: | + | |
- | severity2 = FacesMessage.SEVERITY_FATAL; | + | |
- | break; | + | |
- | } | + | |
- | FacesContext.getCurrentInstance().addMessage(idMessage, new FacesMessage(severity2, resume, resume + detail)); | + | |
- | } | + | |
- | } | + | |
- | </file> | + | |
[[ada:sicoferp:rentas|<< regresar]] | [[ada:sicoferp:rentas|<< regresar]] |