replace with English javadoc

Author: marevol

src/main/java/org/codelibs/core/misc/AssertionUtil.java

@@ -19,7 +19,7 @@
 import org.codelibs.core.lang.StringUtil;
 
 /**
- * Base64を扱うためのユーティリティクラスです。
+ * Utility class for handling Base64 encoding and decoding.
  *
  * @author higa
  */
@@ -42,11 +42,11 @@ public abstract class Base64Util {
     }
 
     /**
-     * Base64でエンコードします。
+     * Encodes data in Base64.
      *
      * @param inData
-     *            エンコードするデータ
-     * @return エンコードされたデータ
+     *            The data to encode
+     * @return The encoded data
      */
     public static String encode(final byte[] inData) {
         if (ArrayUtil.isEmpty(inData)) {
@@ -72,11 +72,11 @@ public static String encode(final byte[] inData) {
     }
 
     /**
-     * Base64でエンコードされたデータをデコードします。
+     * Decodes data encoded in Base64.
      *
      * @param inData
-     *            デコードするデータ
-     * @return デコードされたデータ
+     *            The data to decode
+     * @return The decoded data
      */
     public static byte[] decode(final String inData) {
         if (StringUtil.isEmpty(inData)) {

src/main/java/org/codelibs/core/misc/Base64Util.java

@@ -16,18 +16,18 @@
 package org.codelibs.core.misc;
 
 /**
- * 破棄可能なリソースを表現します。
+ * Represents a disposable resource.
  * <p>
- * S2コンテナの終了時に破棄しなければならないリソースがある場合は、 このインタフェースを実装したクラスを作成し、
- * {@link DisposableUtil}に登録します。
+ * If there are resources that must be disposed of when the S2 container shuts down,
+ * create a class that implements this interface and register it with {@link DisposableUtil}.
  * </p>
  *
  * @author koichik
  */
 public interface Disposable {
 
     /**
-     * このオブジェクトが保持しているリソースを破棄します。
+     * Disposes of the resources held by this object.
      *
      */
     void dispose();

src/main/java/org/codelibs/core/misc/Disposable.java

@@ -22,57 +22,57 @@
 import java.util.Deque;
 
 /**
- * アプリケーションの終了時にリソースを破棄するためのユーティリティクラスです。
+ * Utility class for disposing of resources at the end of an application.
  * <p>
- * アプリケーションの終了時に破棄しなければならないリソースがある場合は、 {@link Disposable}を実装したクラスを作成し、
- * このクラスに登録します。
+ * If there are resources that must be disposed of at the end of the application,
+ * create a class that implements {@link Disposable} and register it with this class.
  * </p>
  *
  * @author koichik
  */
 public abstract class DisposableUtil {
 
-    /** 登録済みの{@link Disposable} */
+    /** Registered {@link Disposable} */
     protected static final Deque<Disposable> disposables = newLinkedList();
 
     /**
-     * 破棄可能なリソースを登録します。
+     * Registers a disposable resource.
      *
      * @param disposable
-     *            破棄可能なリソース。{@literal null}であってはいけません
+     *            A disposable resource. Must not be {@literal null}.
      */
     public static synchronized void add(final Disposable disposable) {
         assertArgumentNotNull("disposable", disposable);
         disposables.addLast(disposable);
     }
 
     /**
-     * 破棄可能なリソースを先頭に登録します。
+     * Registers a disposable resource at the beginning.
      * <p>
-     * リソースは登録された逆順に破棄されるため、先頭に登録されたリソースは最後に破棄されることになります。
+     * Resources are disposed of in the reverse order of their registration, so resources registered at the beginning will be disposed of last.
      * </p>
      *
      * @param disposable
-     *            破棄可能なリソース。{@literal null}であってはいけません
+     *            A disposable resource. Must not be {@literal null}.
      */
     public static synchronized void addFirst(final Disposable disposable) {
         assertArgumentNotNull("disposable", disposable);
         disposables.addFirst(disposable);
     }
 
     /**
-     * 破棄可能なリソースを登録解除します。
+     * Unregisters a disposable resource.
      *
      * @param disposable
-     *            破棄可能なリソース。{@literal null}であってはいけません
+     *            A disposable resource. Must not be {@literal null}.
      */
     public static synchronized void remove(final Disposable disposable) {
         assertArgumentNotNull("disposable", disposable);
         disposables.remove(disposable);
     }
 
     /**
-     * 登録済みのリソースを全て破棄します。
+     * Disposes of all registered resources.
      */
     public static synchronized void dispose() {
         while (!disposables.isEmpty()) {

src/main/java/org/codelibs/core/misc/DisposableUtil.java

@@ -36,6 +36,39 @@
 import org.codelibs.core.exception.FileAccessException;
 import org.codelibs.core.exception.IORuntimeException;
 
+/**
+ * The {@code DynamicProperties} class extends {@link Properties} to provide dynamic
+ * loading and storing of properties from a file. It monitors the file for changes
+ * and reloads the properties if the file is updated. This class is thread-safe and
+ * ensures that the properties are always up-to-date.
+ *
+ * <p>Key Features:
+ * <ul>
+ *   <li>Automatically reloads properties if the file is modified.</li>
+ *   <li>Supports custom check intervals for file modification checks.</li>
+ *   <li>Provides synchronized methods for loading and storing properties.</li>
+ *   <li>Extends {@link Properties} and overrides its methods to work with dynamic properties.</li>
+ * </ul>
+ *
+ * <p>Usage:
+ * <pre>
+ * DynamicProperties dynamicProperties = new DynamicProperties("path/to/properties/file");
+ * String value = dynamicProperties.getProperty("key");
+ * dynamicProperties.setProperty("key", "newValue");
+ * dynamicProperties.store();
+ * </pre>
+ *
+ * <p>Exceptions:
+ * <ul>
+ *   <li>{@link FileAccessException} - Thrown if there are issues accessing the file.</li>
+ *   <li>{@link IORuntimeException} - Thrown if there are I/O errors during file operations.</li>
+ * </ul>
+ *
+ * <p>Thread Safety:
+ * This class uses synchronization to ensure thread-safe access to the properties.
+ *
+ * @see Properties
+ */
 public class DynamicProperties extends Properties {
 
     private static final long serialVersionUID = 1L;

src/main/java/org/codelibs/core/misc/DynamicProperties.java

@@ -19,17 +19,17 @@
 import java.util.function.Supplier;
 
 /**
- * {@link Locale}用のユーティリティクラスです。
+ * Utility class for {@link Locale}.
  *
  * @author higa
  */
 public abstract class LocaleUtil {
 
     /**
-     * {@link Locale}を返します。
+     * Returns a {@link Locale}.
      *
      * @param localeStr
-     *            ロケールを表す文字列
+     *            A string representing the locale
      * @return {@link Locale}
      */
     public static Locale getLocale(final String localeStr) {

src/main/java/org/codelibs/core/misc/LocaleUtil.java

@@ -16,91 +16,91 @@
 package org.codelibs.core.misc;
 
 /**
- * 二つの値のペアです。
+ * A pair of two values.
  *
  * @author koichik
  * @param <T1>
- *            1番目の値の型
+ *            The type of the first value
  * @param <T2>
- *            2番目の値の型
+ *            The type of the second value
  */
 public class Pair<T1, T2> {
 
-    /** 1番目の値 */
+    /** The first value */
     protected T1 first;
 
-    /** 2番目の値 */
+    /** The second value */
     protected T2 second;
 
     /**
-     * 二つの値のペアを作成して返します。
+     * Creates and returns a pair of two values.
      *
      * @param <T1>
-     *            1番目の値の型
+     *            The type of the first value
      * @param <T2>
-     *            2番目の値の型
+     *            The type of the second value
      * @param first
-     *            1番目の値
+     *            The first value
      * @param second
-     *            2番目の値
-     * @return 二つの値のペア
+     *            The second value
+     * @return A pair of two values
      */
     public static <T1, T2> Pair<T1, T2> pair(final T1 first, final T2 second) {
         return new Pair<>(first, second);
     }
 
     /**
-     * インスタンスを構築します。
+     * Constructs an instance.
      */
     public Pair() {
     }
 
     /**
-     * インスタンスを構築します。
+     * Constructs an instance.
      *
      * @param first
-     *            1番目の値
+     *            The first value
      * @param second
-     *            2番目の値
+     *            The second value
      */
     public Pair(final T1 first, final T2 second) {
         this.first = first;
         this.second = second;
     }
 
     /**
-     * 1番目の値を返します。
+     * Returns the first value.
      *
-     * @return 1番目の値
+     * @return The first value
      */
     public T1 getFirst() {
         return first;
     }
 
     /**
-     * 1番目の値を設定します。
+     * Sets the first value.
      *
      * @param first
-     *            1番目の値
+     *            The first value
      */
     public void setFirst(final T1 first) {
         this.first = first;
     }
 
     /**
-     * 2番目の値を返します。
+     * Returns the second value.
      *
-     * @return 2番目の値
+     * @return The second value
      */
     public T2 getSecond() {
         return second;
     }
 
     /**
-     * 2番目の値を設定します。
+     * Sets the second value.
      *
      * @param second
-     *            2番目の値
+     *            The second value
      */
     public void setSecond(final T2 second) {
         this.second = second;