ファイルの関連づけ¶

Doma Tools は、 SQL ファイルの更新をフックして注釈処理を実行します。 そのためには、 SQL ファイルを Eclipse 内で開く必要があります。

メニューバーから Eclipse > 環境設定... もしくは Window > Preference と選択し、設定画面を開いてください。

以下の図が示すように .sql の拡張子をもつファイルを Text Editor に関連づけてください。

同様に .script の拡張子をもつファイルを Text Editor に関連づけてください。

検索処理の追加¶

ある年齢より小さい従業員を検索する処理を追加する手順を示します。

EmployeeDao に次のコードを追加してください。

@Select
List<Employee> selectByAge(Integer age);

このとき、注釈処理により次のエラーメッセージが Eclilpse 上に表示されます。

[DOMA4019] ファイル[META-INF/boilerplate/dao/EmployeeDao/selectByAge.sql]が
クラスパスから見つかりませんでした。

Eclipse のエディタ上で selectByAge メソッドにカーソルを合わせ右クリックなどで コンテキストメニューを表示させ、メニューの中から Doma > Jump to SQL を選択してください。

SQL ファイルの新規作成を行うためのダイアログが次のように表示されます。

‘Finish’ を押してファイルを作成してください。

ファイル作成後、ファイルを空のまま保管して EmployeeDao に戻ると エラーメッセージの内容が変わります。

[DOMA4020] SQLファイル[META-INF/boilerplate/dao/EmployeeDao/selectByAge.sql]が空です。

selectByAge.sql ファイルに戻って次の SQL を記述してください。

select
    /*%expand*/*
from
    employee
where
    age < /* age  */0

これでエラーが解消されます。

検索処理の実行¶

上記で作成した検索処理を実際に実行します。

EmployeeDaoTest に次のコードを追加してください。

@Test
public void testSelectByAge() {
    TransactionManager tm = AppConfig.singleton().getTransactionManager();
    tm.required(() -> {
        List<Employee> employees = dao.selectByAge(35);
        assertEquals(2, employees.size());
    });
}

JUnit を実行し、このコードが動作することを確認してください。

このとき発行される検索のための SQL は次のものです。

select
    age, id, name, version
from
    employee
where
    age < 35

挿入処理の実行¶

EmployeeDao に次のコードが存在することを確認してください。

@Insert
int insert(Employee employee);

このコードを利用して挿入処理を実行します。

EmployeeDaoTest に次のコードを追加してください。

@Test
public void testInsert() {
    TransactionManager tm = AppConfig.singleton().getTransactionManager();

    Employee employee = new Employee();

    // 最初のトランザクション
    // 挿入を実行している
    tm.required(() -> {
        employee.name = "HOGE";
        employee.age = 20;
        dao.insert(employee);
        assertNotNull(employee.id);
    });

    // 2番目のトランザクション
    // 挿入が成功していることを確認している
    tm.required(() -> {
        Employee employee2 = dao.selectById(employee.id);
        assertEquals("HOGE", employee2.name);
        assertEquals(Integer.valueOf(20), employee2.age);
        assertEquals(Integer.valueOf(1), employee2.version);
    });
}

JUnit を実行し、このコードが動作することを確認してください。

このとき発行される挿入のための SQL は次のものです。

insert into Employee (age, id, name, version) values (20, 100, 'HOGE', 1)

識別子とバージョン番号が自動で設定されています。

更新処理の実行¶

EmployeeDao に次のコードが存在することを確認してください。

@Update
int update(Employee employee);

このコードを利用して更新処理を実行します。

EmployeeDaoTest に次のコードを追加してください。

@Test
public void testUpdate() {
    TransactionManager tm = AppConfig.singleton().getTransactionManager();

    // 最初のトランザクション
    // 検索して age フィールドを更新している
    tm.required(() -> {
        Employee employee = dao.selectById(1);
        assertEquals("ALLEN", employee.name);
        assertEquals(Integer.valueOf(30), employee.age);
        assertEquals(Integer.valueOf(0), employee.version);
        employee.age = 50;
        dao.update(employee);
        assertEquals(Integer.valueOf(1), employee.version);
    });

    // 2番目のトランザクション
    // 更新が成功していることを確認している
    tm.required(() -> {
        Employee employee = dao.selectById(1);
        assertEquals("ALLEN", employee.name);
        assertEquals(Integer.valueOf(50), employee.age);
        assertEquals(Integer.valueOf(1), employee.version);
    });
}

JUnit を実行し、このコードが動作することを確認してください。

このとき発行される更新のための SQL は次のものです。

update Employee set age = 50, name = 'ALLEN', version = 0 + 1 where id = 1 and version = 0

楽観的排他制御のためのバージョン番号が自動でインクリメントされています。

削除処理の実行¶

EmployeeDao に次のコードが存在することを確認してください。

@Delete
int delete(Employee employee);

このコードを利用して削除処理を実行します。

EmployeeDaoTest に次のコードを追加してください。

@Test
public void testDelete() {
    TransactionManager tm = AppConfig.singleton().getTransactionManager();

    // 最初のトランザクション
    // 削除を実行している
    tm.required(() -> {
        Employee employee = dao.selectById(1);
        dao.delete(employee);
    });

    // 2番目のトランザクション
    // 削除が成功していることを確認している
    tm.required(() -> {
        Employee employee = dao.selectById(1);
        assertNull(employee);
    });
}

JUnit を実行し、このコードが動作することを確認してください。

このとき発行される削除のための SQL は次のものです。

delete from Employee where id = 1 and version = 0

識別子に加えバージョン番号も検索条件に指定されます。

データソース¶

DataSource を getDataSource メソッドで返してください。 ローカルトランザクションを利用する場合は、 LocalTransactionDataSource を返してください。

データソースの名前¶

データソース名をあらわす String を getDataSourceName メソッドで返してください。 データソース名は、複数のデータソースを利用する環境で重要です。 データソース名はデータソースごとに自動生成される識別子を区別するために使用されます。 複数データソースを利用する場合は、それぞれ異なる名前を返すようにしてください。

デフォルトの実装では、 Config の実装クラスの完全修飾名が使用されます。

データベースの方言¶

Dialect を getDialect メソッドで返してください。 Dialect はRDBMSの方言を表すインタフェースです。 Dialect には次のものがあります。

ログ出力ライブラリへのアダプタ¶

JdbcLogger を getJdbcLogger メソッドで返してください。 JdbcLogger はデータベースアクセスに関するログを扱うインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.UtilLoggingJdbcLogger

UtilLoggingJdbcLogger は java.util.logging のロガーを使用する実装で、 デフォルトで使用されます。

SQLファイルのリポジトリ¶

SqlFileRepository を getSqlFileRepository メソッドで返してください。 SqlFileRepository は SQL ファイルのリポジトリを扱うインタフェースです。 実装クラスには次のものがあります。

• org.seasar.doma.jdbc.GreedyCacheSqlFileRepository
• org.seasar.doma.jdbc.NoCacheSqlFileRepository

GreedyCacheSqlFileRepository は、読み込んだSQLファイルの内容をパースし、 その結果をメモリが許す限り最大限にキャッシュします。

NoCacheSqlFileRepository は、一切キャッシュを行いません。 毎回、SQLファイルからSQLを読み取りパースします。

メモリの利用に厳しい制限がある環境や、扱うSQLファイルが膨大にある環境では、 適切なキャッシュアルゴリズムをもった実装クラスを作成し使用してください。

デフォルトでは GreedyCacheSqlFileRepository が使用されます。

REQUIRES_NEW 属性のトランザクションとの連動¶

RequiresNewController を getRequiresNewController メソッドで返してください。 RequiresNewController は REQUIRES_NEW の属性をもつトランザクションを 制御するインタフェースです。

このインタフェースは、 @TableGenerator で、識別子を自動生成する際にしか使われません。 @TableGenerator を利用しない場合は、この設定項目を考慮する必要はありません。 また、 @TableGenerator を利用する場合であっても、 識別子を採番するための更新ロックが問題にならない程度のトランザクション数であれば、 設定する必要ありません。

デフォルトの実装は何の処理もしません。

クラスのロード方法¶

ClassHelper を getClassHelper メソッドで返してください。 ClassHelper はクラスのロードに関してアプリケーションサーバや フレームワークの差異を抽象化するインタフェースです。

デフォルトの実装は java.lang.Class.forName(name) を用いてクラスをロードします。

例外メッセージに含めるSQLの種別¶

例外メッセージに含めるSQLのタイプをあらわす SqlLogType を getExceptionSqlLogType メソッドで返してください。 この値は、Doma がスローする例外にどのような形式のSQLを含めるかを決定します。

デフォルトの実装では、フォーマットされた SQL を含めます。

未知のカラムのハンドラ¶

UnknownColumnHandler を getUnknownColumnHandler メソッドで返してください。 UnknownColumnHandler は 検索 の結果を エンティティクラス にマッピングする際、 エンティティクラスにとって未知のカラムが存在する場合に実行されます。

デフォルトでは、 UnknownColumnException がスローされます。

テーブルやカラムにおけるネーミング規約の制御¶

Naming を getNaming メソッドで返してください。

Naming は、 @Entity の name 要素に指定された（もしくは指定されない） NamingType をどのように適用するかについて制御するインタフェースです。 このインタフェースを使うことで、個別のエンティティクラスに NamingType を指定しなくても エンティティのクラス名とプロパティ名からデータベースのテーブル名とカラム名を解決できます。

Naming が使用される条件は以下の通りです。

• @Table や @Column の name 要素に値が指定されていない。

一般的なユースケースを実現するための実装は、 Naming の static なメンバに定義されています。

デフォルトでは、 Naming.NONE が使用されます。 この実装は、エンティティクラスに指定された NamingType を使い、 指定がない場合は何の規約も適用しません。

例えば、指定がない場合にスネークケースの大文字を適用したいというケースでは、 Naming.SNAKE_UPPER_CASE を使用できます。

マップのキーのネーミング規約の制御¶

MapKeyNaming を getMapKeyNaming メソッドで返してください。 MapKeyNaming は検索結果を java.util.Map<String, Object> にマッピングする場合に実行されます。

デフォルトでは、 @Select などの mapKeyNaming 要素に指定された規約を適用します。

ローカルトランザクションマネージャー¶

LocalTransactionManager を getTransactionManager メソッドで返してください。 getTransactionManager メソッドは、デフォルトで UnsupportedOperationException をスローします。

SQLの識別子の追記¶

Commenter を getCommenter メソッドで返してください。 Commenter はSQLの識別子（SQLの発行箇所等を特定するための文字列）をSQLコメントとして追記するためのインタフェースです。

実装クラスには次のものがあります。

• org.seasar.doma.jdbc.CallerCommenter

CallerCommenter は、SQLの呼び出し元のクラス名とメソッド名を識別子として使用します。

デフォルトの実装では、 識別子を追記しません。

Command の実装¶

CommandImplementors を getCommandImplementors メソッドで返してください。 CommandImplementors を実装すると クエリ の実行をカスタマイズできます。

たとえば、 JDBC の API を直接呼び出すことができます。

Query の実装¶

QueryImplementors を getQueryImplementors メソッドで返してください。 QueryImplementors を実装すると クエリ の内容をカスタマイズできます。

たとえば、自動生成される SQL の一部を書き換え可能です。

タイムアウト¶

クエリタイムアウト（秒）をあらわす int を getQueryTimeout メソッドで返してください。 この値はすべての クエリ においてデフォルト値として使われます。

最大件数¶

SELECT時の最大行数をあらわす int を getMaxRows メソッドで返します。 この値はすべての 検索 においてデフォルト値として使われます。

フェッチサイズ¶

SELECT時のフェッチサイズをあらわす int を getFetchSize メソッドで返します。 この値はすべての 検索 においてデフォルト値として使われます。

バッチサイズ¶

バッチサイズをあらわす int を getBatchSize メソッドで返します。 この値は バッチ挿入 、バッチ更新 、バッチ削除 においてデフォルト値として使われます。

エンティティリスナーの取得¶

EntityListenerProvider を getEntityListenerProvider メソッドで返して下さい。

EntityListenerProvider の get メソッドは EntityListener 実装クラスの Class と EntityListener 実装クラスのインスタンスを返す Supplier を引数に取り EntityListener のインスタンスを返します。 デフォルトの実装では Supplier.get メソッドを実行して得たインスタンスを返します。

EntityListener 実装クラスのインスタンスをDIコンテナから取得したいなど、 インスタンス取得方法をカスタマイズする場合は EntityListenerProvider を実装したクラスを作成し、 getEntityListenerProvider メソッドでそのインスタンスを返すよう設定してください。

シンプル¶

シンプルな定義は次の場合に適しています。

• DIコンテナで管理しない
• ローカルトランザクションを使用する

実装例です。

@SingletonConfig
public class AppConfig implements Config {

    private static final AppConfig CONFIG = new AppConfig();

    private final Dialect dialect;

    private final LocalTransactionDataSource dataSource;

    private final TransactionManager transactionManager;

    private AppConfig() {
        dialect = new H2Dialect();
        dataSource = new LocalTransactionDataSource(
                "jdbc:h2:mem:tutorial;DB_CLOSE_DELAY=-1", "sa", null);
        transactionManager = new LocalTransactionManager(
                dataSource.getLocalTransaction(getJdbcLogger()));
    }

    @Override
    public Dialect getDialect() {
        return dialect;
    }

    @Override
    public DataSource getDataSource() {
        return dataSource;
    }

    @Override
    public TransactionManager getTransactionManager() {
        return transactionManager;
    }

    public static AppConfig singleton() {
        return CONFIG;
    }
}

利用例です。 定義した設定クラスは、@Daoに指定します。

@Dao(config = AppConfig.class)
public interface EmployeeDao {

    @Select
    Employee selectById(Integer id);
}

アドバンスド¶

アドバンスドな定義は次の場合に適しています。

• DIコンテナでシングルトンとして管理する
• DIコンテナやアプリケーションサーバーが提供するトランザクション管理機能を使う

実装例です。 dialect と dataSource はDIコンテナによってインジェクションされることを想定しています。

public class AppConfig implements Config {

    private Dialect dialect;

    private DataSource dataSource;

    @Override
    public Dialect getDialect() {
        return dialect;
    }

    public void setDialect(Dialect dialect) {
        this.dialect = dialect;
    }

    @Override
    public DataSource getDataSource() {
        return dataSource;
    }

    public void setDataSource(DataSource dataSource) {
        this.dataSource = dataSource;
    }
}

利用例です。 定義した設定クラスのインスタンスがDIコンテナによってインジェクトされるようにします。

@Dao
@AnnotateWith(annotations = {
    @Annotation(target = AnnotationTarget.CONSTRUCTOR, type = javax.inject.Inject.class),
    @Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = javax.inject.Named.class, elements = "\"config\"") })
public interface EmployeeDao {

    @Select
    Employee selectById(Integer id);
}

上記の例では @AnnotateWith の記述をDaoごとに繰り返し記述する必要があります。 繰り返しを避けたい場合は、任意のアノテーションに一度だけ @AnnotateWith を記述し、 Daoにはそのアノテーションを注釈してください。

@AnnotateWith(annotations = {
    @Annotation(target = AnnotationTarget.CONSTRUCTOR, type = javax.inject.Inject.class),
    @Annotation(target = AnnotationTarget.CONSTRUCTOR_PARAMETER, type = javax.inject.Named.class, elements = "\"config\"") })
public @interface InjectConfig {
}

@Dao
@InjectConfig
public interface EmployeeDao {

    @Select
    Employee selectById(Integer id);
}

日付/時刻型¶

日付と時刻の型の違いについて説明します。

java.time.LocalDate

SQL標準のDATE型 (日付のみ)を表します。

java.time.LocalTime

SQL標準のTIME型 (時刻のみ)を表します。

java.time.LocalDateTime

SQL標準のTIMESTAMP型 (日付と時刻)を表します。RDBMSがサポートしている場合ナノ秒を保持します。

java.sql.Date

SQL標準のDATE型 (日付のみ)を表します。

java.sql.Time

SQL標準のTIME型 (時刻のみ)を表します。

java.sql.Timestamp

SQL標準のTIMESTAMP型 (日付と時刻)を表します。RDBMSがサポートしている場合ナノ秒を保持します。

java.util.Date

SQL標準のTIMESTAMP型 (日付と時刻)を表します。ナノ秒を保持しません。

エンティティクラス¶

@Entity
public class Employee {

    @Id
    Integer employeeId;

    Optional<String> employeeName;

    @Version
    Long versionNo;

    ...
}

ドメインクラス¶

@Domain(valueType = String.class)
public class PhoneNumber {

    private final String value;

    public PhoneNumber(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }
}

Daoクラス¶

@Dao(config = AppConfig.class)
public interface EmployeeDao {

    @Select
    Employee selectById(Integer employeeId);

    @Select
    List<String> selectAllName();
}

コンストラクタで生成する方法¶

@Domain の factoryMethod 要素のデフォルトの値は new であり、 非privateなコンストラクタでインスタンスを生成することを示します。 そのため、コンストラクタで生成する場合は factoryMethod 要素を省略できます。 次の例では、 public なコンストラクタを持つドメインクラスを作成しています。 このクラスは電話番号を表しています。

@Domain(valueType = String.class)
public class PhoneNumber {

    private final String value;

    public PhoneNumber(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }

    public String getAreaCode() {
       // ドメインに固有の振る舞いを記述できる。
       ...
    }
}

ファクトリメソッドで生成する方法¶

コンストラクタをprivateにしファクトリメソッドを使ってインスタンスを生成したい場合は、 staticな非privateなメソッドを定義し @Domain の factoryMethod 要素にそのメソッドの名前を指定します。 次の例では、publicなファクトリメソッドをもつドメインクラスを作成しています。 このクラスは電話番号を表しています。

@Domain(valueType = String.class, factoryMethod = "of")
public class PhoneNumber {

    private final String value;

    private PhoneNumber(String value) {
        this.value = value;
    }

    public String getValue() {
        return value;
    }

    public String getAreaCode() {
       // ドメインに固有の振る舞いを記述できる。
       ...
    }

    public static PhoneNumber of(String value) {
        return new PhoneNumber(value);
    }
}

次の例では、 public なファクトリメソッドをもつ列挙型をドメインクラスとして作成しています。 この列挙型は仕事の種別を表しています。

@Domain(valueType = String.class, factoryMethod = "of")
public enum JobType {
    SALESMAN("10"),
    MANAGER("20"),
    ANALYST("30"),
    PRESIDENT("40"),
    CLERK("50");

    private final String value;

    private JobType(String value) {
        this.value = value;
    }

    public static JobType of(String value) {
        for (JobType jobType : JobType.values()) {
            if (jobType.value.equals(value)) {
                return jobType;
            }
        }
        throw new IllegalArgumentException(value);
    }

    public String getValue() {
        return value;
    }
}

型パラメータを利用する方法¶

ドメインクラスには任意の数の型パラメータを宣言できます。 次の例では、1つの型パラメータを持ち、さらに public なコンストラクタを持つ ドメインクラスを作成しています。 このクラスは識別子を表しています。

@Domain(valueType = int.class)
public class Identity<T> {

    private final int value;

    public Identity(int value) {
        this.value = value;
    }

    public int getValue() {
        return value;
    }
}

型パラメータを持ったドメインクラスはファクトリメソッドで生成することも可能です。 この場合、ファクトリメソッドにはクラスの型変数宣言と同等の宣言が必要です。

@Domain(valueType = int.class, factoryMethod = "of")
public class Identity<T> {

    private final int value;

    private Identity(int value) {
        this.value = value;
    }

    public int getValue() {
        return value;
    }

    public static <T> Identity<T> of(int value) {
        return new Identity<T>(value);
    }
}

型パラメータを利用する方法¶

任意の数の型パラメータを持ったクラスを扱えます。 次の例のような1つの型パラメータを持つクラスがあるとします。 このクラスは識別子を表しています。

public class Identity<T> {

    private final int value;

    public Identity(int value) {
        this.value = value;
    }

    public int getValue() {
        return value;
    }
}

上記の Identity をドメインクラスとして扱うには、次のようなクラスを作成します。 Identity の型パラメータにはワイルドカード ? を指定しなければいけません。

@ExternalDomain
public class IdentityConverter implements DomainConverter<Identity<?>, String> {

    public String fromDomainToValue(Identity<?> domain) {
        return domain.getValue();
    }

    @SuppressWarnings("rawtypes")
    public Identity<?> fromValueToDomain(String value) {
        if (value == null) {
            return null;
        }
        return new Identity(value);
    }
}

その他の設定方法については、型パラメータを使用しない場合と同様です。

ネーミング規約¶

ネーミング規約は、エンベッダブルクラスを保有する エンティティクラス から引き継ぎます。

カラム¶

カラム情報を指定するには、 @Column を使用します。

@Column(name = "ZIP_CODE")
final String zip;

識別子¶

エンベッダブルクラスには識別子(主キー)を定義できません。

バージョン¶

エンベッダブルクラスには楽観的排他制御用のバージョンを定義できません。

非永続的なフィールド¶

非永続的なフィールドは、@Transient を注釈して示します。

取得時の状態を管理するフィールド¶

エンベッダブルクラスには取得時の状態を管理するフィールドを定義できません。

エンティティリスナー¶

エンティティがデータベースに対し挿入、更新、削除される直前/直後に処理を実行したい場合、 @Entity の listener 要素に EntityListener の実装クラスを指定できます。

@Entity(listener = EmployeeEntityListener.class)
public class Employee {
    ...
}

listener 要素に何も指定しない場合、エンティティクラスが他のエンティティクラスを継承 しているかどうかで採用する設定が変わります。

• 継承している場合、親エンティティクラスの設定を引き継ぎます
• 継承していない場合、何も行いません（ NullEntityListener が使用されます）

ネーミング規約¶

エンティティに対応するテーブル名やプロパティに対応するカラム名を解決するためのネーミング規約 を変更したい場合、 naming 要素に NamingType の列挙型を指定できます。

@Entity(naming = NamingType.SNAKE_UPPER_CASE)
public class EmployeeInfo {
    ...
}

naming 要素に何も指定しない場合、エンティティクラスが他のエンティティクラスを継承している かどうかで採用する設定が変わります。

• 継承している場合、親エンィティクラスの設定を引き継ぎます
• 継承していない場合、何も行いません（ NamingType.NONE が使用されます）

NamingType.SNAKE_UPPER_CASE は、エンティティ名やプロパティ名を スネークケース（アンダースコア区切り）の大文字に変換します。 この例の場合、テーブル名はEMPLOYEE_INFOになります。

naming 要素に何も指定しない場合、デフォルトでは、テーブル名にはエンティティクラスの単純名、 カラム名にはプロパティ名が使用されます。

ネーミング規約は、 @Table や @Colum の name 要素が指定されない場合のみ使用されます。 @Table や @Colum の name 要素が指定された場合は、 name 要素 に指定した値が使用され、ネーミング規約は適用されません。

イミュータブルなエンティティ¶

エンティティをイミュータブルなオブジェクトとして扱いたい場合は @Entity の immutable 要素に true を設定します。

@Entity(immutable = true)
public class Employee {
    @Id
    final Integer id;
    final String name;
    @Version
    final Integer version;

    public Employee(Integer id, String name, Integer version) {
        this.id = id;
        this.name = name;
        this.version = version;
    }
}

永続的なフィールドには final 修飾子が必須です。

テーブル¶

エンティティに対応するテーブル情報を指定するには、 @Table を使用します。

name 要素でテーブル名を指定できます。

@Entity
@Table(name = "EMP")
public class Employee {
    ...
}

@Table を使用しない、もしくは @Table の name 要素を使用しない場合、 テーブル名は ネーミング規約 により解決されます。

カラム¶

カラム情報を指定するには、 @Column を使用します。

name 要素でカラム名を指定できます。

@Column(name = "ENAME")
String employeeName;

insertable 要素や updatable 要素で挿入や更新の対象とするかどうかを指定できます。

@Column(insertable = false, updatable = false)
String employeeName;

@Column を使用しない、もしくは @Column の name 要素を使用しない場合、 カラム名は ネーミング規約 により解決されます。

識別子¶

識別子(主キー)であることを指定するには、 @Id を使います。

@Id
Integer id;

複合主キーの場合は @Id を複数指定します。

@Id
Integer id;

@Id
Integer id2;

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
Integer id;

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
@SequenceGenerator(sequence = "EMPLOYEE_SEQ")
Integer id;

@Id
@GeneratedValue(strategy = GenerationType.TABLE)
@TableGenerator(pkColumnValue = "EMPLOYEE_ID")
Integer id;

バージョン¶

楽観的排他制御用のバージョンは @Version を注釈して示します。 フィールドの型は以下のいずれかでなければいけません。

• java.lang.Number のサブタイプ
• java.lang.Number のサブタイプを値とする ドメインクラス
• 上記のいずれかを要素の型とする java.util.Optional
• OptionalInt
• OptionalLong
• OptionalDouble
• 数値のプリミティブ型

@Version
Integer version;

非永続的なフィールド¶

非永続的なフィールドは、テーブルや結果セットのカラムに対応しません。

@Transient を注釈して示します。

フィールドの型や可視性に制限はありません。

@Transient
List<String> nameList;

取得時の状態を管理するフィールド¶

取得時の状態とは、エンティティがDaoから取得されときの全プロパティの値です。 取得時の状態を保持しておくことで、更新処理を実行する際、UPDATE文のSET句に変更したフィールドのみを含められます。 取得時の状態を管理するフィールドは、テーブルや結果セットのカラムに対応しません。

@OriginalStates を注釈して示します。

@OriginalStates
Employee originalStates;