Merge pull request #849 from kazuki43zoo/update-doc-for-gh-816

Update docs for gh-816

Author: kazuki43zoo

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

@@ -1710,8 +1710,21 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
   <property name="cacheFile" value="/tmp/my-custom-cache.tmp"/>
 </cache>]]></source>
 
-        <p>Puedes utilizar propiedades JavaBean de cualquier tipo simple y MyBatis hará la conversión.</p>
-        
+        <p>
+          Puedes utilizar propiedades JavaBean de cualquier tipo simple y MyBatis hará la conversión.
+          And you can specify a placeholder(e.g. <code>${cache.file}</code>) to replace value defined at <a href="configuration.html#properties">configuration properties</a>.
+        </p>
+
+        <p>
+          Since 3.4.2, the MyBatis has been supported to call an initialization method after it's set all properties.
+          If you want to use this feature, please implements the <code>org.apache.ibatis.builder.InitializingObject</code>
+          interface on your custom cache class.
+        </p>
+
+        <source><![CDATA[public interface InitializingObject {
+  void initialize() throws Exception;
+}]]></source>
+
         <p><span class="label important">NOTE</span>
           Los parametros de configuración de la cache (eviction, read write..etc.) explicados anteriormente no aplican cuando se usa
           una caché personalizada.

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

@@ -1952,7 +1952,19 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
   <property name="cacheFile" value="/tmp/my-custom-cache.tmp"/>
 </cache>]]></source>
 
-        <p>設定対象のプロパティは、単純型であれば String 以外でも使用可能です。</p>
+        <p>
+          設定対象のプロパティは、単純型であれば String 以外でも使用可能です。
+          加えて、<a href="configuration.html#properties">コンフィギュレーション用のプロパティ</a>に定義した値で置き換えるために、プレースホルダ(例：<code>${cache.file}</code>)を指定することができます。
+        </p>
+
+        <p>
+          3.4.2以降では, MyBatisはすべてのプロパティを設定した後に初期化メソッドを呼び出す仕組みをサポートしています。
+          この機能の使用したい場合は、あなたが作成したキャッシュの実装クラスに<code>org.apache.ibatis.builder.InitializingObject</code>インタフェースを実装してください。
+        </p>
+
+        <source><![CDATA[public interface InitializingObject {
+  void initialize() throws Exception;
+}]]></source>
 
         <p>
           ここで重要なのは、キャッシュの設定とキャッシュのインスタンスは Mapper XML ファイルのネームスペースに関連付けられているということです。

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

@@ -1647,8 +1647,20 @@ public class User {
   <property name="cacheFile" value="/tmp/my-custom-cache.tmp"/>
 </cache>]]></source>
 
-        <p>모든 간단한 타입의 자바빈 프로퍼티를 사용할 수 있다. 
-		마이바티스는 변환할 것이다.</p>
+        <p>
+			모든 간단한 타입의 자바빈 프로퍼티를 사용할 수 있다. 마이바티스는 변환할 것이다.
+			And you can specify a placeholder(e.g. <code>${cache.file}</code>) to replace value defined at <a href="configuration.html#properties">configuration properties</a>.
+		</p>
+
+		<p>
+		  Since 3.4.2, the MyBatis has been supported to call an initialization method after it's set all properties.
+		  If you want to use this feature, please implements the <code>org.apache.ibatis.builder.InitializingObject</code>
+		  interface on your custom cache class.
+		</p>
+
+		<source><![CDATA[public interface InitializingObject {
+  void initialize() throws Exception;
+}]]></source>
 
         <p>캐시 설정과 캐시 인스턴스가 SQL Map 파일의 네임스페이스에 묶여지는(bound) 것을 기억하는게 중요하다. 
 		게다가 같은 네임스페이스내 모든 구문은 묶여진다. 

src/site/xdoc/sqlmap-xml.xml

@@ -2122,7 +2122,20 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
   <property name="cacheFile" value="/tmp/my-custom-cache.tmp"/>
 </cache>]]></source>
 
-        <p>You can use JavaBeans properties of all simple types, MyBatis will do the conversion.</p>
+        <p>
+          You can use JavaBeans properties of all simple types, MyBatis will do the conversion.
+          And you can specify a placeholder(e.g. <code>${cache.file}</code>) to replace value defined at <a href="configuration.html#properties">configuration properties</a>.
+        </p>
+
+        <p>
+          Since 3.4.2, the MyBatis has been supported to call an initialization method after it's set all properties.
+          If you want to use this feature, please implements the <code>org.apache.ibatis.builder.InitializingObject</code>
+          interface on your custom cache class.
+        </p>
+
+        <source><![CDATA[public interface InitializingObject {
+  void initialize() throws Exception;
+}]]></source>
 
         <p><span class="label important">NOTE</span>
           Settings of cache (like eviction strategy, read write..etc.) in section above are not applied

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

@@ -1876,9 +1876,20 @@ org.mybatis.cache.Cache 接口。这个接口是 MyBatis 框架中很多复杂
 </cache>]]></source>
 
         <p>
-你可以使用所有简单类型作为 JavaBeans 的属性,MyBatis 会进行转换。
+          你可以使用所有简单类型作为 JavaBeans 的属性,MyBatis 会进行转换。
+          And you can specify a placeholder(e.g. <code>${cache.file}</code>) to replace value defined at <a href="configuration.html#properties">configuration properties</a>.
         </p>
 
+        <p>
+          Since 3.4.2, the MyBatis has been supported to call an initialization method after it's set all properties.
+          If you want to use this feature, please implements the <code>org.apache.ibatis.builder.InitializingObject</code>
+          interface on your custom cache class.
+        </p>
+
+        <source><![CDATA[public interface InitializingObject {
+  void initialize() throws Exception;
+}]]></source>
+
         <p>
 记得缓存配置和缓存实例是绑定在 SQL 映射文件的命名空间是很重要的。因此,所有
 在相同命名空间的语句正如绑定的缓存一样。