RESTEasyとJPAとAngularJSを使ってWebアプリを作ってみる２（エンティティの作成）

テーブルからコードを生成したり、コードからテーブルを生成したりできるみたいです。
手っ取り早く触ってみたいので、テーブルから生成することにします。
（コードから作るとなると、内容をしっかりと理解しないとハマリそうなので…）

テーブルを作成する

RESTEasyとJPAとAngularJSを使ってWebアプリを作ってみる（準備編）で作成したユーザでデータベースに接続し、以下の CREATE 文を実行します。

create_tables.sql

CREATE TABLE USERS (
    USER_ID                 INT NOT NULL PRIMARY KEY AUTO_INCREMENT     COMMENT 'ユーザID',
    ACCOUNT_ID              VARCHAR(64) NOT NULL                        COMMENT 'アカウントID',
    PASSWORD                VARCHAR(128) NOT NULL                       COMMENT 'パスワード',
    LAST_NAME               VARCHAR(32) NOT NULL                        COMMENT '姓',
    FIRST_NAME              VARCHAR(32) NOT NULL                        COMMENT '名',
    LAST_NAME_KANA          VARCHAR(32) NOT NULL                        COMMENT '姓カナ',
    FIRST_NAME_KANA         VARCHAR(32) NOT NULL                        COMMENT '名カナ',
    BIRTH_DATE              DATE NOT NULL                               COMMENT '生年月日',
    NOTICE_MAIL             VARCHAR(1024)                               COMMENT '通知先メール（区切り文字は「|@|」）'
)
COMMENT 'ユーザ情報';
ALTER TABLE USERS
    ADD CONSTRAINT USERS_UK_0 UNIQUE KEY (ACCOUNT_ID);

CREATE TABLE SUBJECT
(
    SUBJECT_ID              INT NOT NULL PRIMARY KEY AUTO_INCREMENT     COMMENT '科目ID',
    TARGET_AGE              SMALLINT                                    COMMENT '対象年齢',
    SUBJECT_TYPE            SMALLINT                                    COMMENT '科目種別（0:通常）',
    DESCRIPTION             VARCHAR(128)                                COMMENT '科目名'
)
COMMENT '科目情報';

CREATE TABLE QUESTION
(
    QUESTION_ID             INT NOT NULL PRIMARY KEY AUTO_INCREMENT     COMMENT '問題ID',
    SUBJECT_ID              INT NOT NULL                                COMMENT '科目ID',
    QUESTION                VARCHAR(1024) NOT NULL                      COMMENT '問題',
    CORRECT                 VARCHAR(256) NOT NULL                       COMMENT '解答',
    SEP_CHAR                VARCHAR(4)                                  COMMENT '複数解答の区切り文字',
    REMARK                  VARCHAR(1024)                               COMMENT '説明'
)
COMMENT '問題情報';
ALTER TABLE QUESTION
    ADD CONSTRAINT QUESTION_FK_0 FOREIGN KEY (SUBJECT_ID) REFERENCES SUBJECT (SUBJECT_ID);

CREATE TABLE HISTORY
(
    HISTORY_ID              INT NOT NULL PRIMARY KEY AUTO_INCREMENT     COMMENT '履歴ID',
    REGIST_DATE             DATE NOT NULL                               COMMENT '登録日時',
    USER_ID                 INT NOT NULL                                COMMENT 'ユーザID',
    ELAPSED                 INT                                         COMMENT '経過時間',
    CORRECT_PERCENT         DECIMAL(5,2)                                COMMENT '正答率'
)
COMMENT '履歴情報';
ALTER TABLE HISTORY
    ADD CONSTRAINT HISTORY_FK_0 FOREIGN KEY (USER_ID) REFERENCES USERS (USER_ID);

CREATE TABLE ANSWER
(
    ANSWER_ID               INT NOT NULL PRIMARY KEY AUTO_INCREMENT     COMMENT '回答ID',
    HISTORY_ID              INT NOT NULL                                COMMENT '履歴ID',
    QUESTION_ID             INT NOT NULL                                COMMENT '問題ID',
    ANSWER                  VARCHAR(256)                                COMMENT '回答',
    CORRECT_WRONG           CHAR(1)                                     COMMENT '正誤（正:1, 誤:0）'
)
COMMENT '回答情報';
ALTER TABLE ANSWER
    ADD CONSTRAINT ANSWER_FK_0 FOREIGN KEY (HISTORY_ID) REFERENCES HISTORY (HISTORY_ID),
    ADD CONSTRAINT ANSWER_FK_1 FOREIGN KEY (QUESTION_ID) REFERENCES QUESTION (QUESTION_ID);

基底クラスを作成する

本来は共通カラムを持たせるために作ったりするのが普通なんだろうけど、単純にデバッグログを出力したときに分かりやすくするために、toString()をオーバーライドしただけのものを用意することにします。

BaseEntity.java

package homework.entity;

import org.apache.commons.lang3.builder.ReflectionToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

public class BaseEntity {
    @Override
    public String toString() {
        return ReflectionToStringBuilder.toString(this, ToStringStyle.MULTI_LINE_STYLE);
    }
}

エンティティクラスを生成する

接続の設定

• 「homework」プロジェクトのプロパティを開き、「JPA」を選択します。
• 「接続の追加」リンクをクリックします。
• 「MySQL」を選択し、「名前」に homework を入力して「次へ」ボタンをクリックします。
• 「ドライバー」プルダウンの横のアイコン（新規ドライバー定義）をクリックします。
• 「名前/タイプ」タブで「MySQL 5.1」を選択し、ドライバー名に「MySQL-JDBC-5.1.24」を入力します。
• 次に「jarリスト」タブを表示すると、存在しない mysql-connector-java-5.1.0-bin.jar があったので、選択して「JAR/Zipの除去」ボタンをクリックして削除します。
• 引き続き「JAR/Zipの追加」ボタンをクリックして、ファイルの選択ダイアログで E:\develop\maven_repo\mysql\mysql-connector-java\5.1.24\mysql-connector-java-5.1.24.jar を選択し、「OK」ボタンをクリックします。
• 次に「プロパティ」タブを表示し、データベース名と接続URLの最後の database を homework に変更します。
• また、ユーザーIDとパスワードにそれぞれ db_user, db_pass を設定して「OK」ボタンをクリックします。
• 「ドライバーおよび接続の詳細の指定」画面で、「接続のテスト」ボタンをクリックして問題なければ、「パスワードの保存」にチェックをして「完了」ボタンをクリックします。

エンティティの生成

• 「homework」プロジェクトを右クリックし「JPAツール」－「テーブルからエンティティを生成」を選択します。
• テーブルをすべてチェックし、「次へ」ボタンをクリックします。
• 「テーブルの関連付け」画面では、すべてのエンティティで、親が子の情報を持たないよう（下の「○○のコレクションへの参照を× ×で生成」というチェックを外すと、関連図が「← 1 * →」が「－ 1 * →」となります）にして、「次へ」ボタンをクリックします。
• 「デフォルトのカスタマイズ」画面で、キー・ジェネレーターを「identify」に設定（キーにAUTO_INCREMENTを指定しているので）、「常にオプションのJPA注釈およびDDLパラメータを生成」をチェック、パッケージに「homework.entity」を入力、スーパークラスに「homework.entity.BaseEntity」を入力し、「完了」ボタンをクリックする。

出来たエンティティの一例は以下の通り。

History.java

package homework.entity;

import java.io.Serializable;
import javax.persistence.*;
import java.math.BigDecimal;
import java.util.Date;


/**
 * The persistent class for the history database table.
 * 
 */
@Entity
@NamedQuery(name="History.findAll", query="SELECT h FROM History h")
public class History extends BaseEntity implements Serializable {
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy=GenerationType.IDENTITY)
    @Column(name="HISTORY_ID")
    private int historyId;

    @Column(name="CORRECT_PERCENT")
    private BigDecimal correctPercent;

    private int elapsed;

    @Temporal(TemporalType.DATE)
    @Column(name="REGIST_DATE")
    private Date registDate;

    //uni-directional many-to-one association to User
    @ManyToOne
    @JoinColumn(name="USER_ID")
    private User user;

    public History() {
    }

    // あとは getter, setter が書かれてます 
}

エンティティの構造を理解しなくてもクラスが自動で作成されました。

RESTEasyとJPAとAngularJSを使ってWebアプリを作ってみる３（persistance.xmlの設定）へ