更新機能の作成

Exampleアプリケーションを元に更新機能を解説する。

作成する機能の説明
  1. プロジェクト一覧のプロジェクトIDを押下する。
../../../../../_images/project_update_detail_link.png
  1. 対象プロジェクトの詳細画面が表示されるので、変更ボタンを押下する。
../../../../../_images/project_update_detail.png
  1. 更新する項目を書き換えて、更新ボタンを押下する。
../../../../../_images/project_update_update.png
  1. 更新確認画面が表示されるので、確定ボタンを押下する。
../../../../../_images/project_update_confirm.png
  1. データベースが更新され、更新完了画面が表示される。
../../../../../_images/project_update_complete.png

更新内容の入力と確認

更新機能の実装方法のうち、更新内容の入力及び確認について以下の順に解説する。

フォームの作成

詳細画面から更新画面へ遷移する際のパラメータを受け付けるフォームと、更新画面編集欄への入力値を受け付けるフォームを作成する。

詳細画面から更新画面へ遷移する際にパラメータを受け付けるフォーム

詳細画面から更新画面へ遷移する際にパスパラメータ(「show/:projectId」の「:projectId」部分)として渡される、 対象のプロジェクトIDを受け付けるフォームを作成する。

ProjectTargetForm.java
public class ProjectTargetForm implements Serializable {

    /** プロジェクトID */
    @Required
    @Domain("id")
    private String projectId;

    // ゲッタ及びセッタは省略
更新画面から入力された値を受け付けるフォーム

更新画面から入力された、編集後の値を受け付けるフォームを作成する。

ProjectUpdateForm.java
public class ProjectUpdateForm implements Serializable {

    // 一部のみ抜粋

    /** プロジェクト名 */
    @Required
    @Domain("projectName")
    private String projectName;

    /**
     * プロジェクト名を取得する。
     *
     * @return プロジェクト名
     */
    public String getProjectName() {
        return this.projectName;
    }

    /**
     * プロジェクト名を設定する。
     *
     * @param projectName 設定するプロジェクト名
     */
    public void setProjectName(String projectName) {
        this.projectName = projectName;
    }
}
この実装のポイント
更新画面を表示する業務アクションメソッドの作成

データベースから現在の情報を取得し、更新画面を表示する業務アクションメソッドを作成する。

ProjectAction.java
@InjectForm(form = ProjectTargetForm.class)
public HttpResponse edit(HttpRequest request, ExecutionContext context) {

    // 更新処理で使用するセッション情報を削除しておく。
    SessionUtil.delete(context, "project");

    ProjectTargetForm targetForm = context.getRequestScopedVar("form");
    LoginUserPrincipal userContext = SessionUtil.get(context, "userContext");

    // 他のユーザによって対象プロジェクトが削除されている場合NoDataExceptionを送出
    ProjectDto dto = UniversalDao.findBySqlFile(ProjectDto.class, "FIND_BY_PROJECT",
            new Object[]{targetForm.getProjectId(), userContext.getUserId()});

    // 出力情報をリクエストスコープにセット
    context.setRequestScopedVar("form", dto);

    SessionUtil.put(context, "project", BeanUtil.createAndCopy(Project.class, dto));

    return new HttpResponse("/WEB-INF/view/project/update.jsp");
}
この実装のポイント
更新画面のJSPの作成
画面の作成については、登録編の 登録画面初期表示の作成 にて説明済みであるため省略する。
更新内容の確認を行う業務アクションメソッドの作成

更新内容をバリデーションし、確認画面を表示する業務アクションメソッドを作成する。 Bean Validation に加えて、業務アクションメソッド内に、データベース検索を伴うバリデーションを実装する。

ProjectAction.java
@InjectForm(form = ProjectUpdateForm.class, prefix = "form")
@OnError(type = ApplicationException.class,
        path = "/WEB-INF/view/project/update.jsp")
public HttpResponse confirmOfUpdate(HttpRequest request, ExecutionContext context) {
    ProjectUpdateForm form = context.getRequestScopedVar("form");

    // データベースを検索して入力されたIDを持つ顧客が存在するか確認する
    if (form.hasClientId()) {
        if (!UniversalDao.exists(Client.class, "FIND_BY_CLIENT_ID",
                new Object[] {Integer.parseInt(form.getClientId()) })) {
                    throw new ApplicationException(
                        MessageUtil.createMessage(MessageLevel.ERROR,
                            "errors.nothing.client", form.getClientId()));

        }
    }

    Project project = SessionUtil.get(context, "project");

    // フォームの値をセッションへ上書きする
    BeanUtil.copy(form, project);

    // 出力情報をリクエストスコープにセット
    context.setRequestScopedVar("form", BeanUtil.createAndCopy(ProjectDto.class, form));
    context.setRequestScopedVar("profit", new ProjectProfit(
            project.getSales(),
            project.getCostOfGoodsSold(),
            project.getSga(),
            project.getAllocationOfCorpExpenses()
    ));

    return new HttpResponse("/WEB-INF/view/project/confirmOfUpdate.jsp");
}
この実装のポイント
SQLの作成

顧客の存在確認に使用するために、顧客IDから顧客情報を取得するSQLを作成する。

client.sql
FIND_BY_CLIENT_ID =
SELECT
    CLIENT_ID,
    CLIENT_NAME,
    INDUSTRY_CODE
FROM
    CLIENT
WHERE
    CLIENT_ID = :clientId
この実装のポイント
  • 存在確認用のSQLはSELECT文として作成する。
更新確認画面のJSPの作成

更新画面を使い回して、更新確認画面を作成する。

/src/main/webapp/WEB-INF/view/project/update.jsp
<n:form useToken="true">
  <!-- 登録内容の確認部分 -->
    <div class="title-nav page-footer">
        <!-- ページ下部のボタン部分 -->
        <div class="button-nav">
            <n:forInputPage>
                <!-- 入力画面向けボタン部分 -->
            </n:forInputPage>
            <n:forConfirmationPage>
                <!-- 確認画面向けボタン部分 -->
                <n:submit value = "確定" uri="/action/project/update" id="bottomSubmitButton"
                        cssClass="btn btn-raised btn-success"
                        allowDoubleSubmission="false" type="button" />
            </n:forConfirmationPage>
        </div>
    </div>
</n:form>
この実装のポイント

データベースの更新

更新機能の実装方法のうち、更新内容の確認について以下の順に解説する。

業務アクションメソッドの作成

データベースを更新し、変更を確定する業務アクションメソッドを作成する。 楽観的ロック を行うためのエンティティ定義も合わせて解説する。

データベース更新を行う業務アクションメソッドの作成

データベースを更新し、完了画面表示メソッドへリダイレクトする業務アクションメソッドを作成する。

ProjectAction.java
@OnDoubleSubmission
public HttpResponse update(HttpRequest request, ExecutionContext context) {
    Project targetProject = SessionUtil.delete(context, "project");
    UniversalDao.update(targetProject);

    return new HttpResponse(303, "redirect://completeOfUpdate");
}
この実装のポイント
  • エンティティに更新したい値を設定し、 UniversalDao#update を使用してデータベースを更新する。 更新処理では楽観的ロックが実行される。
  • 二重サブミットを防止するために、 @OnDoubleSubmission を付与する。
  • ブラウザ更新での再実行を防ぐために、レスポンスをリダイレクトする。
楽観的ロックの対象となるエンティティの作成

楽観的ロック を有効化したエンティティを作成する。

Project.java
// その他のプロパティは省略

/** バージョン番号 */
private Long version;

/**
 * バージョン番号を返します。
 *
 * @return バージョン番号
 */
@Version
@Column(name = "VERSION", precision = 19, nullable = false, unique = false)
public Long getVersion() {
    return version;
}

/**
 * バージョン番号を設定します。
 *
 * @param version バージョン番号
 */
public void setVersion(Long version) {
    this.version = version;
}
この実装のポイント
  • 楽観的ロック を行うために、エンティティに version プロパティを作成し ゲッタに @Version を付与する。
完了画面を表示する業務アクションメソッドの作成

更新メソッドのリダイレクト先となる、完了画面を表示する業務アクションメソッドを作成する。

ProjectAction.java
public HttpResponse completeOfUpdate(HttpRequest request, ExecutionContext context) {
    return new HttpResponse("/WEB-INF/view/project/completeOfUpdate.jsp");
}
更新完了画面の作成

更新完了画面を作成する。

/src/main/webapp/WEB-INF/view/project/completeOfUpdate.jsp
<n:form>
    <div class="title-nav">
        <h1 class="page-title">プロジェクト変更完了画面</h1>
        <div class="button-nav">
          <!-- 省略 -->
        </div>
    </div>
    <div class="message-area message-info">
        プロジェクトの更新が完了しました。
    </div>
    <!-- 省略 -->
</n:form>

更新機能の解説は以上。

Getting Started TOPページへ