You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copyright 2009-2020 the original author or authors.
4
+
Copyright 2009-2021 the original author or authors.
5
5
6
6
Licensed under the Apache License, Version 2.0 (the "License");
7
7
you may not use this file except in compliance with the License.
@@ -41,7 +41,7 @@
41
41
Log4j 2
42
42
</li>
43
43
<li>
44
-
Log4j
44
+
Log4j (deprecated since 3.5.9)
45
45
</li>
46
46
<li>
47
47
JDK logging
@@ -51,27 +51,30 @@
51
51
</p>
52
52
<p>Muchos entornos vienen con Commons Logging incluido como pare del classpath del servidor (por ejemplo Tomcat y WebSphere). Es importante conocer que en esos entorno, MyBatis usará JCL como implementación de logging. En un entorno como WebSphere esto significa que tu configuración de log4j será ignorada dado que WebSphere proporciona su propia implementación de JCL. Esto puede ser muy frustrante porque parece que MyBatis está ignorando tu configuración de logging (en realidad, MyBatis está ignorando tu configuración de log4j porque está usando JCL en dicho entorno). Si tu aplicación se ejecuta en un entorno que lleva JCL incluido pero quieres usar un método distinto de logging puedes añadir un setting a tu fichero mybatis-config.xml:
<p>Si eliges llamar a alguno de estos métodos, deberías hacerlo antes de llamar a ningún otro método de MyBatis. Además, estos métodos solo establecerán la implementación de log indicada si dicha implementación está disponible en el classpath. Por ejemplo, si intentas seleccionar log4j y log4j no está disponible en el classpath, MyBatis ignorará la petición y usará su algoritmo normal de descubrimiento de implementaciones de logging.
<p>Si eliges llamar a alguno de estos métodos, deberías hacerlo antes de llamar a ningún otro método de MyBatis. Además, estos métodos solo establecerán la implementación de log indicada si dicha implementación está disponible en el classpath. Por ejemplo, si intentas seleccionar log4j2 y log4j2 no está disponible en el classpath, MyBatis ignorará la petición y usará su algoritmo normal de descubrimiento de implementaciones de logging.
75
78
</p>
76
79
<p>Los temas específicos de JCL, Log4j y el Java Logging API quedan fuera del alcance de este documento. Sin embargo la configuración de ejemplo que se proporciona más abajo te ayudará a comenzar. Si quieres conocer más sobre estos frameworks, puedes obtener más información en las siguientes ubicaciones:
<p>Para ver el log de las sentencias debes activar el log en un paquete, el nombre plenamente cualificado de una clase, un namespace o un nombre plenamente cualificado de un mapped statement.</p>
94
-
<p>Nuevamente, cómo hagas esto es dependiente de la implementación de logging que se esté usando. Mostraremos cómo hacerlo con Log4j. Configurar los servicios de logging es simplemente cuestión de añadir uno o varios ficheros de configuración (por ejemplo log4j.properties) y a veces un nuevo JAR (por ejemplo log4j.jar). El ejemplo siguiente configura todos los servicios de logging para que usen log4j como proveedor. Sólo son dos pasos:
97
+
<p>Nuevamente, cómo hagas esto es dependiente de la implementación de logging que se esté usando. Mostraremos cómo hacerlo con SLF4J(Logback). Configurar los servicios de logging es simplemente cuestión de añadir uno o varios ficheros de configuración (por ejemplo <code>logback.xml</code>) y a veces un nuevo JAR. El ejemplo siguiente configura todos los servicios de logging para que usen SLF4J(Logback) como proveedor. Sólo son dos pasos:
95
98
</p>
96
-
<h4>Paso 1: Añade el fichero Log4j JAR
99
+
<h4>Paso 1: Añade el fichero SLF4J + Logback JAR
97
100
</h4>
98
-
<p>Dado que usamos Log4j, necesitaremos asegurarnos que el fichero JAR está disponible para nuestra aplicación. Para usar Log4j, necesitas añadir el fichero JAR al classpath de tu aplicación. Puedes descargar Log4j desde la URL indicada más arriba.
101
+
<p>Dado que usamos SLF4J(Logback), necesitaremos asegurarnos que el fichero JAR está disponible para nuestra aplicación. Para usar SLF4J(Logback), necesitas añadir el fichero JAR al classpath de tu aplicación.
99
102
</p>
100
-
<p>En aplicaciones Web o de empresa debes añadir tu fichero log4j.java a tu directorio WEB-INF/lib, y en una aplicación standalone simplemente añádela al parámetro –classpath de la JVM.
103
+
<p>En aplicaciones Web o de empresa debes añadir tu fichero <code>logback-classic.jar</code>
104
+
,<code>logback-core.jar</code> and <code>slf4j-api.jar</code> a tu directorio <code>WEB-INF/lib</code>, y en una aplicación standalone simplemente añádela al parámetro <code>–classpath</code> de la JVM.
101
105
</p>
106
+
<p>If you use the maven, you can download jar files by adding following settings on your <code>pom.xml</code>.
107
+
</p>
108
+
<source><![CDATA[
109
+
<dependency>
110
+
<groupId>ch.qos.logback</groupId>
111
+
<artifactId>logback-classic</artifactId>
112
+
<version>1.x.x</version>
113
+
</dependency>
114
+
]]></source>
115
+
102
116
<h4>
103
-
Paso 2: Configurar Log4j
117
+
Paso 2: Configurar Logback
104
118
</h4>
105
-
<p>Configurar Log4j es sencillo. Supongamos que quieres habilitar el log para este mapper:</p>
106
-
<source><![CDATA[package org.mybatis.example;
119
+
<p>Configurar Logback es sencillo. Supongamos que quieres habilitar el log para este mapper:</p>
120
+
<source><![CDATA[
121
+
package org.mybatis.example;
107
122
public interface BlogMapper {
108
123
@Select("SELECT * FROM blog WHERE id = #{id}")
109
124
Blog selectBlog(int id);
110
-
}]]></source>
111
-
<p>Crea un fichero con nombre <code>log4j.properties</code>
125
+
}
126
+
]]></source>
127
+
<p>Crea un fichero con nombre <code>logback.xml</code>
112
128
como el que se muestra a continuación y colocalo en tu classpath:
<p>El fichero anterior hará que log4j reporte información detallada para <code>org.mybatis.example.BlogMapper</code> e información de errores para el resto de las clases de tu aplicación.</p>
<p>El fichero anterior hará que SLF4J(Logback) reporte información detallada para <code>org.mybatis.example.BlogMapper</code> e información de errores para el resto de las clases de tu aplicación.</p>
123
153
<p>Si quieres activar un nivel más fino de logging puedes activar el logging para statements específicos en lugar de para todo un mapper. La siguiente línea activa el logging sólo para el statement <code>selectBlog</code>:</p>
<p>Hay consultas que pueden devolver una gran cantidad de datos. En esos casos puedes querer ver las sentencias SQL pero no los datos. Para conseguirlo las sentencias se loguean con nivel DEBUG (FINE en JDK) y los resultados con TRACE (FINER en JDK), por tanto si quieres ver la sentencia pero no el resultado establece el nivel a DEBUG</p>
<p>Sí, como ya te habrás dado cuenta, no hay ninguna diferencia entre configurar el logging para un mapper o para un fichero XML.</p>
156
208
157
-
<p><spanclass="label important">NOTA</span> Si usas SLF4J o Log4j 2 MyBatis le llamará usando MYBATIS como marker.</p>
209
+
<p><spanclass="label important">NOTA</span> Si usas SLF4J o Log4j 2 MyBatis le llamará usando <code>MYBATIS</code> como marker.</p>
210
+
211
+
<p>El resto de la configuración sirve para configurar los appenders, lo cual queda fuera del ámbito de este documento. Sin embargo, puedes encontrar más información en el site de <ahref="https://logback.qos.ch/">Logback</a>. O, puedes simplemente experimentar para ver los efectos que consigues con las distintas opciones de configuración.</p>
<p>El resto de la configuración sirve para configurar los appenders, lo cual queda fuera del ámbito de este documento. Sin embargo, puedes encontrar más información en el site de Log4j (la url está más arriba). O, puedes simplemente experimentar para ver los efectos que consigues con las distintas opciones de configuración.</p>
0 commit comments