サービス契約情報変更実装編

1.1. 処理概要

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

1.1.1. 呼出API

以下、サービス契約情報変更で呼び出すAPIとなります。

No	API	処理内容	使用用途
1	POST /API/v2/api/servicecontracts	サービス契約を編集する	サービス契約変更画面で変更ボタン押下時にサービス契約情報を変更
2	GET /API/v2/api/servicecontracts	サービス契約を検索する	サービス契約変更画面でサービス契約IDを基にサービス契約情報を検索

1.1.2. 処理フロー

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

1.1.3. 実装例

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

ServiceContractChangeController.java

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

    form.setMessage("");
    form.setErrorInformation("");
    model.addAttribute("serviceContractChangeForm", form);
    serviceContractChangeFormSession.setServiceContractChangeForm(form);

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

    Web_IFServiceContractEdition_I web_IFServiceContractEdition_I = new Web_IFServiceContractEdition_I();

    web_IFServiceContractEdition_I.entry_id = SampleUtil.emptyToNull(serviceContractChangeFormSession.getServiceContractChangeForm().getEntryId());
    web_IFServiceContractEdition_I.administration_number = "1";
    web_IFServiceContractEdition_I.customer_id = SampleUtil.emptyToNull(form.getCustomerId());

    Web_IndividualizedServiceContractEditionList web_IndividualizedServiceContractEditionList = new Web_IndividualizedServiceContractEditionList();
    web_IndividualizedServiceContractEditionList.service_contract_id = SampleUtil.emptyToNull(form.getServiceContractId());
    web_IndividualizedServiceContractEditionList.bill_to_id = SampleUtil.emptyToNull(form.getBillToId());
    web_IndividualizedServiceContractEditionList.number_of_contracts = String.valueOf(form.getNumberOfContracts());
    web_IndividualizedServiceContractEditionList.free_item1 = SampleUtil.emptyToNull(form.getFreeItem());
    web_IndividualizedServiceContractEditionList.service_code = SampleUtil.emptyToNull(form.getServiceCode());
    web_IndividualizedServiceContractEditionList.price_plan_code = SampleUtil.emptyToNull(form.getPricePlanCode());
    web_IndividualizedServiceContractEditionList.version_info = String.valueOf(form.getVersionInfo());
    web_IFServiceContractEdition_I.individualized_service_contract_edition_list.add(web_IndividualizedServiceContractEditionList);

    Web_IFServiceContractEdition_O web_IFServiceContractEdition_O = new Web_IFServiceContractEdition_O();       

    try {
        //サービス契約を編集する
        web_IFServiceContractEdition_O = serviceContractService.serviceContractEdition(web_IFServiceContractEdition_I);

        if (ControllerConstants.API_RESULT_NG.equals(web_IFServiceContractEdition_O.result_information.result)) {
            form.setErrorInformation(web_IFServiceContractEdition_O.result_information.detailed_result);
            return ControllerConstants.SERVICE_CONTRACT_CHANGE_JSP;
        }
    } catch (ApiException e) {
        if(ApiErrorType.排他エラー.equals(e.getErrorCode()))
        {
            // メッセージ表示
            form.setErrorInformation(getMsg(MessageConstants.MSGE00001, 
                    getMsg(MessageConstants.SCN000004)));
            return ControllerConstants.SERVICE_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.LBL000001), 
            web_IFServiceContractEdition_O.servicecontract_id_information_list.get(0).service_contract_id));

    return ControllerConstants.SERVICE_CONTRACT_CHANGE_JSP;
}

ServiceContractService.java

/**
 * サービス契約＿編集 API
 * 
 * @param web_IFServiceContractEdition_I ＩＦサービス契約＿編集＿入力
 * @return ＩＦサービス契約＿編集＿出力
 */
public Web_IFServiceContractEdition_O serviceContractEdition(Web_IFServiceContractEdition_I web_IFServiceContractEdition_I) {

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

    // 通信実行
    return CommonHttpClient.httpPost(postMethod, Web_IFServiceContractEdition_O.class);

}

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

Top