Translate Javadoc comments from Japanese to English

Author: nakamura-to

src/main/java/org/seasar/doma/AccessLevel.java

@@ -1,11 +1,6 @@
 package org.seasar.doma;
 
-/**
- * Javaのアクセスレベルを表します。
- *
- * @author nakamura-to
- * @since 2.0.0
- */
+/** Defines access levels in The Java Language. */
 public enum AccessLevel {
 
   /** {@code public} */
@@ -14,20 +9,16 @@ public enum AccessLevel {
   /** {@code protected} */
   PROTECTED("protected"),
 
-  /** パッケージプライベート */
+  /** package private */
   PACKAGE("");
 
   private final String modifier;
 
-  private AccessLevel(String modifier) {
+  AccessLevel(String modifier) {
     this.modifier = modifier;
   }
 
-  /**
-   * 修飾子を返します。
-   *
-   * @return 修飾子
-   */
+  /** @return the modifier's name */
   public String getModifier() {
     return modifier;
   }

src/main/java/org/seasar/doma/AnnotateWith.java

@@ -4,30 +4,56 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import org.seasar.doma.jdbc.Config;
 
 /**
- * Daoインタフェースの実装クラスのソースコードにアノテーションを注釈することを示します。
+ * Indicates that a generated code that implements the annotated interface is annotated with some
+ * annotations.
  *
- * <p>このアノテーションには2種類の使い方があります
+ * <p>This annotation is mainly intended to inject a {@link Config} instance to a DAO
+ * implementation's constructor. Don't use {@link Dao#config()} with this annotation.
+ *
+ * <p>There are 2 ways to use this annotation:
  *
  * <ul>
- *   <li>Daoインタフェースに直接的に注釈する方法。
- *   <li>Daoインタフェースに間接的に注釈する方法。この方法では、任意のアノテーションに{@code AnnotateWith}
- *       を注釈し、そのアノテーションをDaoインタフェースに注釈する。
+ *   <li>annotate directly
+ *   <li>annotate indirectly
  * </ul>
  *
- * <p>このアノテーションを直接的であれ間接的であれDaoインタフェースに注釈する場合、{@link Dao#config()} に値を設定してはいけません。
+ * <p>annotate directly:
+ *
+ * <pre>
+ * &#64;Dao
+ * &#64;AnnotateWith(annotations = {
+ *   &#64;Annotation(target = AnnotationTarget.CONSTRUCTOR, type = javax.inject.Inject.class),
+ *   &#64;Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = javax.inject.Named.class, elements = "\"config\"") })
+ * public interface EmployeeDao {
+ *    ...
+ * }
+ * </pre>
+ *
+ * annotate indirectly:
+ *
+ * <pre>
+ * &#64;AnnotateWith(annotations = {
+ *         &#64;Annotation(target = AnnotationTarget.CONSTRUCTOR, type = javax.inject.Inject.class),
+ *         &#64;Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = javax.inject.Named.class, elements = "\"config\"") })
+ * public @interface InjectConfig {
+ * }
+ * </pre>
  *
- * @author taedium
+ * <pre>
+ * &#64;Dao
+ * &#64;InjectConfig
+ * public interface EmployeeDao {
+ *    ...
+ * }
+ * </pre>
  */
 @Target({ElementType.TYPE, ElementType.ANNOTATION_TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 public @interface AnnotateWith {
 
-  /**
-   * アノテーションの配列を返します。
-   *
-   * @return アノテーションの配列
-   */
+  /** @return the {@link Annotation} array. */
   Annotation[] annotations();
 }

src/main/java/org/seasar/doma/Annotation.java

@@ -4,34 +4,28 @@
 import java.lang.annotation.RetentionPolicy;
 
 /**
- * アノテーションを示します。
- *
- * @author taedium
- * @see AnnotateWith
+ * Used in conjunction with the {@link AnnotateWith} annotation to indicate which kind of annotation
+ * is specified for generated code.
  */
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Annotation {
 
-  /**
-   * 注釈する対象を返します。
-   *
-   * @return 注釈する対象
-   */
+  /** @return the location where the annotation is specified. */
   AnnotationTarget target();
 
-  /**
-   * アノテーションの型を返します。
-   *
-   * @return アノテーションの型
-   */
+  /** @return the annotation class that this annotation represents. */
   Class<? extends java.lang.annotation.Annotation> type();
 
   /**
-   * アノテーションの要素を返します。
+   * The annotation elements as a set of key-value pair.
+   *
+   * <p>Represented in CSV format:
    *
-   * <p>「要素名 = 値」 形式で文字列を記述します。 複数存在する場合はカンマで区切ります。
+   * <pre>
+   * elementName1=value1, elementName2=value2
+   * </pre>
    *
-   * @return アノテーションの要素
+   * @return the annotation elements
    */
   String elements() default "";
 }

src/main/java/org/seasar/doma/AnnotationTarget.java

@@ -1,19 +1,18 @@
 package org.seasar.doma;
 
 /**
- * アノテーションを注釈する対象です。
+ * Defines the locations where annotations may appear.
  *
- * @author taedium
  * @see Annotation
  */
 public enum AnnotationTarget {
 
-  /** クラス */
+  /** Class */
   CLASS,
 
-  /** コンストラクタ */
+  /** Constructor */
   CONSTRUCTOR,
 
-  /** コンストラクターのパラメータ */
+  /** Constructor's parameter */
   CONSTRUCTOR_PARAMETER,
 }

src/main/java/org/seasar/doma/ArrayFactory.java

@@ -9,11 +9,9 @@
 import org.seasar.doma.jdbc.JdbcException;
 
 /**
- * {@link Array} のインスタンスを生成することを示します。
+ * Indicates to create an {@link Array} instance.
  *
- * <p>このアノテーションが注釈されるメソッドは、 Daoインタフェースのメンバでなければいけません。
- *
- * <h3>例:</h3>
+ * <p>The annotated method must be a member of a {@link Dao} annotated interface.
  *
  * <pre>
  * &#064;Dao(config = AppConfig.class)
@@ -24,14 +22,13 @@
  * }
  * </pre>
  *
- * 注釈されるメソッドは、次の例外をスローすることがあります。
+ * The method may throw following exceptions:
  *
  * <ul>
- *   <li>{@link DomaNullPointerException} パラメータに {@code null}を渡した場合
- *   <li>{@link JdbcException} JDBCに関する例外が発生した場合
+ *   <li>{@link DomaNullPointerException} if any of the method parameters are {@code null}
+ *   <li>{@link JdbcException} if a JDBC related error occurs
  * </ul>
  *
- * @author taedium
  * @see Connection#createArrayOf(String, Object[])
  */
 @Target(ElementType.METHOD)
@@ -40,11 +37,12 @@
 public @interface ArrayFactory {
 
   /**
-   * 配列の要素がマッピングされる型のSQL名を返します。。
+   * The SQL name of the type the elements of the array map to.
    *
-   * <p>この値は、 {@link Connection#createArrayOf(String, Object[])} の最初のパラメータに渡されます。
+   * <p>The value is passed as the first argument to {@link Connection#createArrayOf(String,
+   * Object[])}.
    *
-   * @return 配列の要素がマッピングされる型のSQL名
+   * @return the type name
    */
   String typeName();
 }

src/main/java/org/seasar/doma/BatchDelete.java

@@ -13,11 +13,9 @@
 import org.seasar.doma.jdbc.SqlLogType;
 
 /**
- * バッチ削除処理を示します。
+ * Indicates a batch delete.
  *
- * <p>このアノテーションが注釈されるメソッドは、 Daoインタフェースのメンバでなければいけません。
- *
- * <h3>例:</h3>
+ * <p>The annotated method must be a member of a {@link Dao} annotated interface.
  *
  * <pre>
  * &#064;Entity
@@ -33,77 +31,66 @@
  * }
  * </pre>
  *
- * 注釈されるメソッドは、次の例外をスローすることがあります。
+ * The method may throw following exceptions:
  *
  * <ul>
- *   <li>{@link DomaNullPointerException} パラメータに {@code null} を渡した場合
- *   <li>{@link OptimisticLockException} 楽観的排他制御が有効なで更新件数が0件の場合
- *   <li>{@link SqlFileNotFoundException} {@code sqlFile} 要素の値が {@code true} で、SQLファイルが見つからなかった場合
- *   <li>{@link JdbcException} 上記以外でJDBCに関する例外が発生した場合
+ *   <li>{@link DomaNullPointerException} if any of the method parameters are {@code null}
+ *   <li>{@link OptimisticLockException} if optimistic locking is enabled and an update count is 0
+ *       for each entity
+ *   <li>{@link SqlFileNotFoundException} if {@code sqlFile} is {@code true} and the SQL file is not
+ *       found
+ *   <li>{@link JdbcException} if a JDBC related error occurs
  * </ul>
- *
- * @author taedium
  */
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)
 @DaoMethod
 public @interface BatchDelete {
 
-  /**
-   * SQLファイルにマッピングするかどうかを返します。
-   *
-   * @return SQLファイルにマッピングするかどうか
-   */
+  /** @return whether the annotated method is mapped to an SQL file. */
   boolean sqlFile() default false;
 
   /**
-   * クエリタイムアウト（秒）を返します。
+   * The query timeout in seconds.
    *
-   * <p>指定しない場合、{@link Config#getQueryTimeout()}が使用されます。
+   * <p>If not specified, {@link Config#getQueryTimeout()} is used.
    *
-   * @return クエリタイムアウト
+   * @return the query timeout
    * @see Statement#setQueryTimeout(int)
    */
   int queryTimeout() default -1;
 
   /**
-   * バッチサイズを返します。
+   * The batch size.
    *
-   * <p>指定しない場合、{@link Config#getBatchSize()}が使用されます。
+   * <p>If not specified, {@link Config#getBatchSize()} is used.
    *
-   * <p>{@link PreparedStatement#executeBatch()} を実行する際のバッチサイズです。 バッチ対象の数がバッチサイズを上回る場合、バッチサイズの数だけ
-   * {@link PreparedStatement#addBatch()} を呼び出し、 {@link PreparedStatement#executeBatch()}
-   * を実行するということを繰り返します。
+   * <p>This value is used when {@link PreparedStatement#executeBatch()} is executed.
    *
-   * @return バッチサイズ
+   * @return the batch size
    * @see PreparedStatement#addBatch()
-   * @since 1.21.0
    */
   int batchSize() default -1;
 
   /**
-   * 楽観的排他制御用のバージョン番号を無視するかどうかを返します。
+   * Whether the version property is ignored.
    *
-   * <p>{@code true} の場合、削除条件にバージョン番号を含めません。
+   * <p>If {@code true}, the column that mapped to the version property is excluded from SQL DELETE
+   * statements.
    *
-   * @return 楽観的排他制御用のバージョン番号を無視するかどうか
+   * @return whether the version property is ignored
    */
   boolean ignoreVersion() default false;
 
   /**
-   * 削除結果が1件でない場合にスローされる {@link OptimisticLockException} を抑制するかどうかを返します。
+   * Whether {@link OptimisticLockException} is suppressed.
    *
-   * <p>この要素に対する指定は、{@link #sqlFile()} が {@code false} の場合にのみ有効です。
+   * <p>Only if {@link #sqlFile()} is {@code false}, this element value is used.
    *
-   * @return {@link OptimisticLockException}を抑制するかどうか
+   * @return whether {@link OptimisticLockException} is suppressed
    */
   boolean suppressOptimisticLockException() default false;
 
-  /**
-   * SQLのログの出力形式を返します。
-   *
-   * @return SQLログの出力形式
-   * @since 2.0.0
-   */
+  /** @return the output format of SQL logs. */
   SqlLogType sqlLog() default SqlLogType.FORMATTED;
 }