replace with English javadoc

Author: marevol

src/main/java/org/codelibs/core/security/MessageDigestUtil.java

@@ -25,22 +25,22 @@
 import org.codelibs.core.exception.NoSuchAlgorithmRuntimeException;
 
 /**
- * {@link MessageDigest}を扱うユーティリティです。
+ * Utility for handling {@link MessageDigest}.
  *
  * @author higa
  * @author shinsuke
  */
 public abstract class MessageDigestUtil {
 
     /**
-     * {@link MessageDigest#getInstance(String)}の例外処理をラップします。
+     * Wraps the exception handling of {@link MessageDigest#getInstance(String)}.
      *
      * @param algorithm
-     *            アルゴリズム (利用可能なアルゴリズムは{@link MessageDigest}のJavadoc等を参照してください)。
-     *            {@literal null}や空文字列であってはいけません
+     *            The algorithm (refer to the Javadoc of {@link MessageDigest} for available algorithms).
+     *            Must not be {@literal null} or an empty string.
      * @return {@link MessageDigest}
      * @throws RuntimeException
-     *             {@link NoSuchAlgorithmException}が発生した場合
+     *             If a {@link NoSuchAlgorithmException} occurs
      */
     public static MessageDigest getInstance(final String algorithm) {
         assertArgumentNotEmpty("algorithm", algorithm);
@@ -53,13 +53,13 @@ public static MessageDigest getInstance(final String algorithm) {
     }
 
     /**
-     * 指定されたアルゴリズムでテキストをハッシュ化して文字列にします。
+     * Hashes the specified text using the given algorithm and converts it to a string.
      *
      * @param algorithm
-     *            アルゴリズム。{@literal null}や空文字列であってはいけません
+     *            The algorithm. Must not be {@literal null} or an empty string.
      * @param text
-     *            ハッシュ化する文字列
-     * @return ハッシュ化された文字列
+     *            The string to be hashed.
+     * @return The hashed string.
      */
     public static String digest(final String algorithm, final String text) {
         assertArgumentNotEmpty("algorithm", algorithm);

src/main/java/org/codelibs/core/sql/DriverManagerUtil.java

@@ -27,17 +27,17 @@
 import org.codelibs.core.lang.ClassUtil;
 
 /**
- * {@link java.sql.DriverManager}のためのユーティリティクラスです。
+ * Utility class for {@link java.sql.DriverManager}.
  *
  * @author koichik
  */
 public abstract class DriverManagerUtil {
 
     /**
-     * JDBCドライバを登録します。
+     * Registers a JDBC driver.
      *
      * @param driverClassName
-     *            登録するJDBCドライバのクラス名。{@literal null}や空文字列であってはいけません
+     *            The class name of the JDBC driver to register. Must not be {@literal null} or an empty string.
      */
     public static void registerDriver(final String driverClassName) {
         assertArgumentNotEmpty("driverClassName", driverClassName);
@@ -47,21 +47,21 @@ public static void registerDriver(final String driverClassName) {
     }
 
     /**
-     * JDBCドライバを登録します。
+     * Registers a JDBC driver.
      *
      * @param driverClass
-     *            登録するJDBCドライバのクラス。{@literal null}であってはいけません
+     *            The class of the JDBC driver to register. Must not be {@literal null}.
      */
     public static void registerDriver(final Class<Driver> driverClass) {
         assertArgumentNotNull("driverClass", driverClass);
         registerDriver(ClassUtil.newInstance(driverClass));
     }
 
     /**
-     * JDBCドライバを登録します。
+     * Registers a JDBC driver.
      *
      * @param driver
-     *            登録するJDBCドライバ。{@literal null}であってはいけません
+     *            The JDBC driver to register. Must not be {@literal null}.
      */
     public static void registerDriver(final Driver driver) {
         assertArgumentNotNull("driver", driver);
@@ -74,10 +74,10 @@ public static void registerDriver(final Driver driver) {
     }
 
     /**
-     * JDBCドライバを登録解除します。
+     * Deregisters a JDBC driver.
      *
      * @param driver
-     *            登録解除するJDBCドライバ。{@literal null}であってはいけません
+     *            The JDBC driver to deregister. Must not be {@literal null}.
      */
     public static void deregisterDriver(final Driver driver) {
         assertArgumentNotNull("driver", driver);
@@ -90,7 +90,7 @@ public static void deregisterDriver(final Driver driver) {
     }
 
     /**
-     * 現在のクラスローダに結びつけられている全てのJDBCドライバを登録解除します。
+     * Deregisters all JDBC drivers associated with the current class loader.
      */
     public static synchronized void deregisterAllDrivers() {
         for (final Enumeration<Driver> e = DriverManager.getDrivers(); e.hasMoreElements();) {

src/main/java/org/codelibs/core/sql/PreparedStatementUtil.java

@@ -24,20 +24,20 @@
 import org.codelibs.core.exception.SQLRuntimeException;
 
 /**
- * {@link PreparedStatement}用のユーティリティクラスです。
+ * Utility class for {@link PreparedStatement}.
  *
  * @author higa
  */
 public abstract class PreparedStatementUtil {
 
     /**
-     * クエリを実行します。
+     * Executes the query.
      *
      * @param ps
-     *            {@link PreparedStatement}。{@literal null}であってはいけません
+     *            {@link PreparedStatement}. Must not be {@literal null}.
      * @return {@link ResultSet}
      * @throws SQLRuntimeException
-     *             {@link SQLException}が発生した場合
+     *             If a {@link SQLException} occurs.
      */
     public static ResultSet executeQuery(final PreparedStatement ps) throws SQLRuntimeException {
         assertArgumentNotNull("ps", ps);
@@ -50,13 +50,13 @@ public static ResultSet executeQuery(final PreparedStatement ps) throws SQLRunti
     }
 
     /**
-     * 更新を実行します。
+     * Executes the update.
      *
      * @param ps
-     *            {@link PreparedStatement}。{@literal null}であってはいけません
-     * @return 更新した結果の行数
+     *            {@link PreparedStatement}. Must not be {@literal null}.
+     * @return The number of rows affected by the update.
      * @throws SQLRuntimeException
-     *             {@link SQLException}が発生した場合
+     *             If a {@link SQLException} occurs.
      */
     public static int executeUpdate(final PreparedStatement ps) throws SQLRuntimeException {
         assertArgumentNotNull("ps", ps);
@@ -69,13 +69,13 @@ public static int executeUpdate(final PreparedStatement ps) throws SQLRuntimeExc
     }
 
     /**
-     * 実行します。
+     * Executes the statement.
      *
      * @param ps
-     *            {@link PreparedStatement}。{@literal null}であってはいけません
-     * @return 結果セットを返すかどうか
+     *            {@link PreparedStatement}. Must not be {@literal null}.
+     * @return Whether the result is a {@link ResultSet}.
      * @throws SQLRuntimeException
-     *             {@link SQLException}が発生した場合
+     *             If a {@link SQLException} occurs.
      * @see PreparedStatement#execute()
      */
     public static boolean execute(final PreparedStatement ps) throws SQLRuntimeException {
@@ -89,13 +89,13 @@ public static boolean execute(final PreparedStatement ps) throws SQLRuntimeExcep
     }
 
     /**
-     * バッチ更新を行ないます。
+     * Executes a batch update.
      *
      * @param ps
-     *            {@link PreparedStatement}。{@literal null}であってはいけません
-     * @return 更新した結果の行数の配列
+     *            {@link PreparedStatement}. Must not be {@literal null}.
+     * @return An array of the number of rows affected by each command in the batch.
      * @throws SQLRuntimeException
-     *             {@link SQLException}が発生した場合
+     *             If a {@link SQLException} occurs.
      */
     public static int[] executeBatch(final PreparedStatement ps) throws SQLRuntimeException {
         assertArgumentNotNull("ps", ps);
@@ -108,12 +108,12 @@ public static int[] executeBatch(final PreparedStatement ps) throws SQLRuntimeEx
     }
 
     /**
-     * バッチを追加します。
+     * Adds a batch.
      *
      * @param ps
-     *            {@link PreparedStatement}。{@literal null}であってはいけません
+     *            {@link PreparedStatement}. Must not be {@literal null}.
      * @throws SQLRuntimeException
-     *             {@link SQLException}が発生した場合
+     *             If a {@link SQLException} occurs.
      */
     public static void addBatch(final PreparedStatement ps) throws SQLRuntimeException {
         assertArgumentNotNull("ps", ps);

src/main/java/org/codelibs/core/sql/ResultSetUtil.java

@@ -25,7 +25,7 @@
 import org.codelibs.core.log.Logger;
 
 /**
- * {@link ResultSet}のためのユーティリティクラスです。
+ * Utility class for {@link ResultSet}.
  *
  * @author higa
  */
@@ -34,13 +34,13 @@ public abstract class ResultSetUtil {
     private static final Logger logger = Logger.getLogger(ResultSetUtil.class);
 
     /**
-     * 結果セットを閉じます。
+     * Closes the result set.
      * <p>
-     * {@link ResultSet#close()}が例外をスローした場合はログにエラーメッセージを出力します。 例外は再スローされません。
+     * If {@link ResultSet#close()} throws an exception, an error message is logged. The exception is not rethrown.
      * </p>
      *
      * @param resultSet
-     *            結果セット
+     *            The result set
      */
     public static void close(final ResultSet resultSet) {
         if (resultSet == null) {
@@ -54,11 +54,11 @@ public static void close(final ResultSet resultSet) {
     }
 
     /**
-     * 結果セットを次に進めます。
+     * Moves the result set to the next position.
      *
      * @param resultSet
-     *            結果セット。{@literal null}であってはいけません
-     * @return 次に進めたかどうか
+     *            The result set. Must not be {@literal null}.
+     * @return Whether the result set successfully moved to the next position.
      */
     public static boolean next(final ResultSet resultSet) {
         assertArgumentNotNull("resultSet", resultSet);
@@ -71,15 +71,15 @@ public static boolean next(final ResultSet resultSet) {
     }
 
     /**
-     * カーソルを指定した位置まで進めます。
+     * Moves the cursor to the specified position.
      *
      * @param resultSet
-     *            結果セット。{@literal null}であってはいけません
+     *            The result set. Must not be {@literal null}.
      * @param index
-     *            位置
-     * @return 指定した位置まで進めたかどうか
+     *            The position.
+     * @return Whether the cursor successfully moved to the specified position.
      * @throws SQLRuntimeException
-     *             SQL例外が起こった場合。
+     *             If an SQL exception occurs.
      */
     public static boolean absolute(final ResultSet resultSet, final int index) throws SQLRuntimeException {
         assertArgumentNotNull("resultSet", resultSet);

src/main/java/org/codelibs/core/sql/StatementUtil.java

@@ -27,7 +27,7 @@
 import org.codelibs.core.log.Logger;
 
 /**
- * {@link Statement}用のユーティリティクラスです。
+ * Utility class for {@link Statement}.
  *
  * @author higa
  */
@@ -36,13 +36,13 @@ public abstract class StatementUtil {
     private static final Logger logger = Logger.getLogger(StatementUtil.class);
 
     /**
-     * SQLを実行します。
+     * Executes the SQL.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
+     *            {@link Statement}. Must not be {@literal null}.
      * @param sql
-     *            SQL文字列。{@literal null}や空文字列であってはいけません
-     * @return 実行した結果
+     *            SQL string. Must not be {@literal null} or empty.
+     * @return The result of the execution.
      * @see Statement#execute(String)
      */
     public static boolean execute(final Statement statement, final String sql) {
@@ -57,12 +57,12 @@ public static boolean execute(final Statement statement, final String sql) {
     }
 
     /**
-     * フェッチサイズを設定します。
+     * Sets the fetch size.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
+     *            {@link Statement}. Must not be {@literal null}.
      * @param fetchSize
-     *            フェッチサイズ
+     *            Fetch size.
      * @see Statement#setFetchSize(int)
      */
     public static void setFetchSize(final Statement statement, final int fetchSize) {
@@ -76,12 +76,12 @@ public static void setFetchSize(final Statement statement, final int fetchSize)
     }
 
     /**
-     * 最大行数を設定します。
+     * Sets the maximum number of rows.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
+     *            {@link Statement}. Must not be {@literal null}.
      * @param maxRows
-     *            最大の行数
+     *            Maximum number of rows.
      * @see Statement#setMaxRows(int)
      */
     public static void setMaxRows(final Statement statement, final int maxRows) {
@@ -95,12 +95,12 @@ public static void setMaxRows(final Statement statement, final int maxRows) {
     }
 
     /**
-     * クエリタイムアウトを設定します。
+     * Sets the query timeout.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
+     *            {@link Statement}. Must not be {@literal null}.
      * @param queryTimeout
-     *            クエリタイムアウト
+     *            Query timeout.
      * @see Statement#setQueryTimeout(int)
      */
     public static void setQueryTimeout(final Statement statement, final int queryTimeout) {
@@ -114,9 +114,9 @@ public static void setQueryTimeout(final Statement statement, final int queryTim
     }
 
     /**
-     * {@link Statement}を閉じます。
+     * Closes the {@link Statement}.
      * <p>
-     * {@link Statement#close()}が例外をスローした場合はログにエラーメッセージを出力します。 例外は再スローされません。
+     * If {@link Statement#close()} throws an exception, an error message is logged. The exception is not rethrown.
      * </p>
      *
      * @param statement
@@ -135,11 +135,11 @@ public static void close(final Statement statement) {
     }
 
     /**
-     * 結果セットを返します。
+     * Returns the result set.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
-     * @return 結果セット
+     *            {@link Statement}. Must not be {@literal null}.
+     * @return The result set.
      */
     public static ResultSet getResultSet(final Statement statement) {
         assertArgumentNotNull("statement", statement);
@@ -152,11 +152,11 @@ public static ResultSet getResultSet(final Statement statement) {
     }
 
     /**
-     * 更新カウントを返します。
+     * Returns the update count.
      *
      * @param statement
-     *            {@link Statement}。{@literal null}であってはいけません
-     * @return 更新カウント
+     *            {@link Statement}. Must not be {@literal null}.
+     * @return The update count.
      */
     public static int getUpdateCount(final Statement statement) {
         assertArgumentNotNull("statement", statement);