基本契約情報変更実装編

1.1. 処理概要

基本契約情報の検索で取得した情報をもとに、画面上で入力ができる形で基本契約情報を表示します。
変更ボタンが押された際に、画面の入力内容をもとに基本契約情報の変更を行います。
本処理を行うには、API認証よりAPIを呼び出すためのアクセストークンが必要となります。

1.1.1. 呼出API

以下、基本契約情報変更で呼び出すAPIとなります。

No	API	処理内容	使用用途
1	POST /v2/api/basiccontract	基本契約を編集する	基本契約変更画面で変更ボタン押下時に基本契約情報を変更
2	GET /v2/api/basiccontract	基本契約を検索する	基本契約変更画面表示時に変更対象の基本契約情報を検索

1.1.2. 処理フロー

基本契約情報変更を行うまでの処理は以下のフローとなります。

1.1.3. 実装例

以下API呼出の実装例となります。
基本契約変更画面表示時の「基本契約を検索する」API呼び出しについては、「基本契約情報検索実装編」及び提供ソースをご確認ください。
※本マニュアルに記載している実装例は、分かりやすさを優先し簡易的に記載しております。提供しているソースと異なりますので詳細については提供ソースをご確認ください。

BasicContractChangeController.java

/**
 * 変更処理
 * @param model モデル
 * @param form 基本契約変更フォーム
 * @param result バリデーション結果
 * @return 基本契約変更
 */
@RequestMapping(value = "/BasicContractChange/change", method = RequestMethod.POST)
public String change(
        Model model,
        @Valid BasicContractChangeForm form,
        BindingResult result) {

    form.setMessage("");
    form.setErrorInformation("");
    model.addAttribute("basicContractChangeForm", form);
    basicContractChangeFormSession.setBasicContractChangeForm(form);

    if (result.hasErrors()) {
        return ControllerConstants.BASIC_CONTRACT_CHANGE_JSP;
    }

    Web_IFBasicContractEdition_I web_IFBasicContractEdition_I = new Web_IFBasicContractEdition_I();
    Web_IFBasicContractEdition_O web_IFBasicContractEdition_O = new Web_IFBasicContractEdition_O();

    web_IFBasicContractEdition_I.entry_id = CommonConstants.登録者ＩＤ;
    web_IFBasicContractEdition_I.administration_number = "1";
    web_IFBasicContractEdition_I.bill_to_id = SampleUtil.emptyToNull(form.getBillToId());       |-- 請求先ＩＤを設定することにより変更処理が行われる。
    web_IFBasicContractEdition_I.bill_to_name = SampleUtil.emptyToNull(form.getBillToName());
    web_IFBasicContractEdition_I.bill_to_version_info = SampleUtil.emptyToNull(form.getBillToVersionInfo());
    web_IFBasicContractEdition_I.customer_id = SampleUtil.emptyToNull(form.getCustomerId());
    web_IFBasicContractEdition_I.group_id = SampleUtil.emptyToNull(form.getGroupNameCode());
    web_IFBasicContractEdition_I.classification_of_contract = SampleUtil.emptyToNull(form.getClassificationOfContractCode());
    web_IFBasicContractEdition_I.apply_start_date = SampleUtil.emptyToNull(form.getBasicContractStartDate());
    web_IFBasicContractEdition_I.apply_end_date = SampleUtil.emptyToNull(form.getCancellationDate());
    web_IFBasicContractEdition_I.zip_code = SampleUtil.emptyToNull(form.getZipCode());
    web_IFBasicContractEdition_I.address1 = SampleUtil.emptyToNull(form.getPrefectures());
    web_IFBasicContractEdition_I.address2 = SampleUtil.emptyToNull(form.getCity());
    web_IFBasicContractEdition_I.address3 = SampleUtil.emptyToNull(form.getAddress1());
    web_IFBasicContractEdition_I.address4 = SampleUtil.emptyToNull(form.getAddress2());
    web_IFBasicContractEdition_I.phone_number1 = SampleUtil.emptyToNull(form.getPhoneNumber1());
    web_IFBasicContractEdition_I.phone_number2 = SampleUtil.emptyToNull(form.getPhoneNumber2());
    web_IFBasicContractEdition_I.email_address1 = SampleUtil.emptyToNull(form.getEmailAddress1());
    web_IFBasicContractEdition_I.email_address2 = SampleUtil.emptyToNull(form.getEmailAddress2());
    web_IFBasicContractEdition_I.free_item2 = SampleUtil.emptyToNull(form.getMedia());

    JsonObject json = new JsonObject();
    json.addProperty("address", form.getAddress());
    json.addProperty("comment", form.getComment());
    web_IFBasicContractEdition_I.free_item = json;

    try {
        //基本契約を編集する
        web_IFBasicContractEdition_O = basicContractService.basicContractEdition(web_IFBasicContractEdition_I);
        if (ControllerConstants.API_RESULT_NG.equals(web_IFBasicContractEdition_O.result_information.result)) {
            form.setErrorInformation(web_IFBasicContractEdition_O.result_information.detailed_result);
            return ControllerConstants.BASIC_CONTRACT_CHANGE_JSP;
        }

    } catch (ApiException e) {
        if(ApiErrorType.排他エラー.equals(e.getErrorCode()))
        {
            // メッセージ表示
            form.setErrorInformation(getMsg(MessageConstants.MSGE00001, 
                    getMsg(MessageConstants.SCN000002)));
            return ControllerConstants.BASIC_CONTRACT_CHANGE_JSP;
        } else {
            model.addAttribute("errorCode", e.getErrorCode().getValue());
            return ControllerConstants.SYSTEM_ERROR_JSP;
        }

    } catch (Exception e) {
        return ControllerConstants.SYSTEM_ERROR_JSP;
    }

    // メッセージ表示
    form.setMessage(getMsg(MessageConstants.MSGI00002, 
            getMsg(MessageConstants.LBL000002), 
            web_IFBasicContractEdition_O.basic_contract_id));

    // 基本契約変更に戻る
    return ControllerConstants.BASIC_CONTRACT_CHANGE_JSP;
}

BasicContractService.java

/**
 * 基本契約＿編集 API
 * 
 * @param web_IFBasicContractEdition_I ＩＦ基本契約＿編集＿入力
 * @return ＩＦ基本契約＿編集＿出力
 */
public Web_IFBasicContractEdition_O basicContractEdition(Web_IFBasicContractEdition_I web_IFBasicContractEdition_I) {

    // 通信設定
    String strURI = ClientUtil.makeURI(UriInfo.BasicContractEdition, null, null);
    HttpPost postMethod = ClientUtil.makeHttpPost(strURI, web_IFBasicContractEdition_I);

    return CommonHttpClient.httpPost(postMethod, Web_IFBasicContractEdition_O.class);

}

共通HTTPリクエストクラス[CommonHttpClient.java]の実装例についてはこちらをご参照ください。

Top