Docs for #149

Author: emacarron

src/site/es/xdoc/configuration.xml

@@ -123,7 +123,9 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
               <td>
                 lazyLoadingEnabled
               </td>
-              <td>Habilita o inhabilita globalmente la carga diferida (lazy loading).
+              <td>
+                Habilita o inhabilita globalmente la carga diferida (lazy loading). Cuando está activo, todas las relaciones se cargan en modo diferido.
+                Este valor se puede sobrescribir en cada relación usando el atributo <code>fetchType</code>.
               </td>
               <td>
                 true | false

src/site/es/xdoc/java-api.xml

@@ -368,13 +368,18 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
         <td><code>@One</code></td>
         <td><code>Method</code></td>
         <td><code>&lt;association&gt;</code></td>
-        <td>Un mapeo a una propiedad que contiene un tipo complejo. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado. Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
+        <td>
+        Un mapeo a una propiedad que contiene un tipo complejo. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado, 
+        <code>fecthType</code>, que sobrescribe el parámetro global de configuración <code>lazyLoadingEnabled</code> para este mapeo. 
+        Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
       </tr>
       <tr>
         <td><code>@Many</code></td>
         <td><code>Method</code></td>
         <td><code>&lt;collection&gt;</code></td>
-        <td>Un mapeo a una propiedad que contiene una colección de tipos complejos. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado. Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
+        <td>Un mapeo a una propiedad que contiene una colección de tipos complejos. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado, 
+        <code>fecthType</code>, que sobrescribe el parámetro global de configuración <code>lazyLoadingEnabled</code> para este mapeo. 
+        Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
       </tr>
       <tr>
         <td><code>@MapKey</code></td>

src/site/es/xdoc/sqlmap-xml.xml

@@ -995,6 +995,13 @@ public class User {
               <td>El id de otro mapped statement que cargará el tipo complejo asociado a esta propiedad. Los valores obtenidos de las columnas especificadas en el atributo column se pasarán como parámetros al select  statement referenciado. A continuación se muestra un ejemplo detallado. Nota: para tratar con claves compuestas, puedes especificar varios nombres usando esta sintaxis column=”{prop1=col1,prop2=col2}”. Esto hará que se informen las propiedades prop1 y prop2 del objeto parámetro del select statement destino
               </td>
             </tr>
+            <tr>
+              <td><code>fetchType</code></td>
+              <td>
+                Opcional. Los valores válidos son <code>lazy</code> y <code>eager</code>. Si está presente sobrescribe
+                el parámetro global de configuración <code>lazyLoadingEnabled</code> para este mapping.
+              </td>
+            </tr>
           </tbody>
         </table>
 

src/site/ja/xdoc/configuration.xml

@@ -138,6 +138,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
               <td>
                 Lazy Loading（遅延読み込み）の有効／無効を切り替えるグローバルな設定です。
                 無効にした場合、association として指定されているデータは直ちに読み込まれます。
+                This value can be superseded for an specific relation by using the <code>fetchType</code> attribute on it.
               </td>
               <td>
                 true | false

src/site/ja/xdoc/java-api.xml

@@ -383,13 +383,16 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
         <td><code>Method</code></td>
         <td><code>&lt;association&gt;</code></td>
         <td>複雑型のプロパティのマッピング情報を定義します。キーである <code>select</code> は、適切な型を読み込むことができるマップドステートメント（Mapper メソッド）の完全修飾名です。
+        <code>fecthType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.        
         <span class="label important">NOTE</span> アノテーション API では結合マッピングがサポートされていません。これは Java アノテーションでは循環参照が許可されないためです。</td>
       </tr>
       <tr>
         <td><code>@Many</code></td>
         <td><code>Method</code></td>
         <td><code>&lt;collection&gt;</code></td>
-        <td>コレクション型のプロパティのマッピング情報を定義します。キーである <code>select</code> は、適切な型のコレクションを読み込むことができるマップドステートメント（Mapper メソッド）の完全修飾名です。 <span class="label important">NOTE</span> アノテーション API では結合マッピングがサポートされていません。これは Java アノテーションでは循環参照が許可されないためです。</td>
+        <td>コレクション型のプロパティのマッピング情報を定義します。キーである <code>select</code> は、適切な型のコレクションを読み込むことができるマップドステートメント（Mapper メソッド）の完全修飾名です。
+        <code>fecthType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.        
+        <span class="label important">NOTE</span> アノテーション API では結合マッピングがサポートされていません。これは Java アノテーションでは循環参照が許可されないためです。</td>
       </tr>
       <tr>
         <td><code>@MapKey</code></td>

src/site/ja/xdoc/sqlmap-xml.xml

@@ -1171,6 +1171,13 @@ public class User {
                 Note: 複合キー（composite key）を扱う場合、column="{prop1=col1,prop2=col2} のように記述することで複数の列名を指定することができます。この例ではネストされた select の実行時に prop1 と prop2 が引数として渡されます。
               </td>
             </tr>
+            <tr>
+              <td><code>fetchType</code></td>
+              <td>
+                Optional. Valid values are <code>lazy</code> and <code>eager</code>. If present, it supersedes
+                the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.
+              </td>
+            </tr>            
           </tbody>
         </table>
 

src/site/ko/xdoc/configuration.xml

@@ -114,7 +114,10 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
               <td>
                 lazyLoadingEnabled
               </td>
-              <td>늦은 로딩을 사용할지에 대한 여부. 사용하지 않는다면 모두 즉시 로딩할 것이다. </td>
+              <td>
+                               늦은 로딩을 사용할지에 대한 여부. 사용하지 않는다면 모두 즉시 로딩할 것이다.
+                This value can be superseded for an specific relation by using the <code>fetchType</code> attribute on it. 
+              </td>
               <td>
                 true | false
               </td>

src/site/ko/xdoc/sqlmap-xml.xml

@@ -973,6 +973,13 @@ Note: 복합키를 다루기 위해서, column=”{prop1=col1,prop2=col2}” 문
 칼럼명을 내포된 select 구문에 명시할 수 있다. 이것은 대상의 내포된 select 구문의 파라미터 객체에
 prop1, prop2 형태로 셋팅하게 될 것이다.</td>
             </tr>
+            <tr>
+              <td><code>fetchType</code></td>
+              <td>
+                Optional. Valid values are <code>lazy</code> and <code>eager</code>. If present, it supersedes
+                the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.
+              </td>
+            </tr>
           </tbody>
         </table>
 

src/site/xdoc/configuration.xml

@@ -169,9 +169,8 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
                 lazyLoadingEnabled
               </td>
               <td>
-                Globally enables or disables lazy
-                loading. When disabled, all
-                associations will be eagerly loaded.
+                Globally enables or disables lazy loading. When enabled, all relations will be lazily loaded. 
+                This value can be superseded for an specific relation by using the <code>fetchType</code> attribute on it.
               </td>
               <td>
                 true | false

src/site/xdoc/java-api.xml

@@ -394,8 +394,10 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
         <td><code>@One</code></td>
         <td><code>Method</code></td>
         <td><code>&lt;association&gt;</code></td>
-        <td>A mapping to a single property value of a complex type. Attributes:<code>select</code>, which is the fully
-        qualified name of a mapped statement (i.e. mapper method) that can load an instance of the appropriate type.
+        <td>A mapping to a single property value of a complex type. Attributes: <code>select</code>, which is the fully
+        qualified name of a mapped statement (i.e. mapper method) that can load an instance of the appropriate type,
+        <code>fecthType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this
+        mapping. 
         <span class="label important">NOTE</span> You will notice that join mapping is not supported via the Annotations API.
         This is due to the limitation in Java Annotations that does not allow for circular references.</td>
       </tr>
@@ -405,7 +407,9 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
         <td><code>&lt;collection&gt;</code></td>
         <td>A mapping to a collection property of a complex type. Attributes: <code>select</code>, which is the fully
         qualified name of a mapped statement (i.e. mapper method) that can load a collection of instances of the appropriate
-        types. <span class="label important">NOTE</span> You will notice that join mapping is not supported via the
+        types, <code>fecthType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this
+        mapping.
+        <span class="label important">NOTE</span> You will notice that join mapping is not supported via the
         Annotations API. This is due to the limitation in Java Annotations that does not allow for circular references.</td>
       </tr>
       <tr>