com.hamaf.hikyaku.ui
クラス StandardCheckAndUpdate

java.lang.Object
  上位を拡張 com.hamaf.hikyaku.ui.ProcessBase
      上位を拡張 com.hamaf.hikyaku.ui.StandardCheckAndUpdate
直系の既知のサブクラス:
GroupAdd, GroupDel, GroupMod, InitMod, PasswordChange, PossibleMod, UserAdd, UserDel, UserMod

public abstract class StandardCheckAndUpdate
extends ProcessBase

タイトル:StandardCheckAndUpdate is 標準更新処理用 ProcessBase.

説明:入力チェックとDB項目更新用のProcessBase拡張クラス。


以下の処理を記述します
メッソド名 必須/任意 概略
newDataObj 必須 使用するDetaObjectをInstance化する
callControl 必須 処理コントロールの呼び出しを行う
setFolder 任意 チェック用のフォルダ名を戻す
DiContainarにより、コンストラクターで_cfldに設定してもかまいません。
checkMaster 任意 マスタ等とのチェック処理
checkRelation 任意 項目間関連チェック処理
setJspMapping 任意 DetaObjectの項目番号とJSPの項目名称の紐付けクラスを登録する
DiContainarにより、コンストラクターで_jimに設定する場合は不要です。
setItems 任意 DetaObjectの項目番号とJSPの項目名称の紐付けを登録する
上記、setJspMappingで設定する場合は不要です。
setEditValue 任意 編集を行う項目をDetaObjectに設定する

DiContainerを利用する場合、コンストラクタで以下の引数が設定可能です。

著作権: Copyright (c) 2007/05/29

バージョン:
1.0
作成者:
y-hamanaka

フィールドの概要
protected  java.lang.String _cfld
          _cfld a String : 項目チェック用のフォルダー
protected  JspItemsMapping _jim
          _jim a JspItemsMapping : JSP項目名称:データオブジェクト項目対応クラス
 
クラス com.hamaf.hikyaku.ui.ProcessBase から継承されたフィールド
clnm, controlXml, log, msgHed, process, request, resource, response, saveObj, sconfig, session, sysId
 
コンストラクタの概要
StandardCheckAndUpdate()
           
 
メソッドの概要
protected  void addItem(java.lang.String jspnm, int pos)
          Describe addItem method : 取得項目番号:表示項目名称用Mapへの登録.
protected abstract  CommonMessage callControl(DetailItemsInterface dii, CommonMessage msg)
          Describe callControl method : コントロールクラスを呼び出す.
protected  CommonMessage checkMaster(CommonMessage msg)
          Describe checkMaster method : マスタチェック処理.
protected  CommonMessage checkRelation(CommonMessage msg)
          Describe checkRelation method : 関連チェック処理.
 CommonMessage exec(CommonMessage msg)
          Describe exec method : Process Execute.
protected abstract  DetailItemsInterface newDataObj()
          Describe newDataObj method : 使用するDetaObjectの実装を戻す.
protected  DetailItemsInterface setEditValue(CommonMessage msg, DetailItemsInterface dii)
          Describe setEditValue method : 編集項目の設定.
protected  java.lang.String setFolder()
          Describe setFolder method : チェック用のフォルダー名を戻す.
protected  void setItems()
          Describe setItems method : 処理項目の登録処理.
protected  JspItemsMapping setJspMapping()
          Describe setJspMapping method : JSPマッピングの設定を行う.
 
クラス com.hamaf.hikyaku.ui.ProcessBase から継承されたメソッド
finish, getUerDto, getUserID, init, newCommonMessage, setSconfig
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

_cfld

protected java.lang.String _cfld
_cfld a String : 項目チェック用のフォルダー


_jim

protected JspItemsMapping _jim
_jim a JspItemsMapping : JSP項目名称:データオブジェクト項目対応クラス

コンストラクタの詳細

StandardCheckAndUpdate

public StandardCheckAndUpdate()
メソッドの詳細

exec

public final CommonMessage exec(CommonMessage msg)
                         throws java.lang.Exception
クラス ProcessBase の記述:
Describe exec method : Process Execute.
業務処理を定義するメソッド

送信データは、CommonMessageのリクエスト用Mapに設定されています。
getReq(項目名)、又は、getReq2String(項目名)メソッドで取り出す事が出来ます。

JSPに渡すデータは、CommonMessageのレスポンス用のMap或いはList領域に、
setResMsg(項目名、値)、及び、addResList(Object)で設定します。

該当データなし、項目チェック等のエラーなど送信画面を表示する場合は、
CommonMessageのErrorStatusにCOUTIONまたはWARNINGを設定し、
メッセージ用List や レスポンス用MAPにエラー情報を設定する。

システム障害などの回復不可能なエラーが発生した場合は、
CommonMessageのErrorStatusにERRORを設定し、
メッセージ用List に エラー情報を設定する。

saveObjに保存したデータはセッションに保管され、次回の呼出時にも使用する事が出来ます。

例外を投げると、システム障害画面が表示されます。

定義:
クラス ProcessBase 内の exec
パラメータ:
msg - a CommonMessage : 共通メッセージオブジェクト
戻り値:
a CommonMessage : 共通メッセージオブジェクト
例外:
java.lang.Exception

setFolder

protected java.lang.String setFolder()
Describe setFolder method : チェック用のフォルダー名を戻す.
(DiContainaerを使用しコンストラクターで設定する場合は、不要です。)
標準の項目チェックを行う場合に、チェックが定義されているフォルダー名を戻します。
基本的には、
return "フォルダー名";
だけを記述します。

戻り値:
a String : チェックが定義されているフォルダー名称

checkMaster

protected CommonMessage checkMaster(CommonMessage msg)
                             throws java.lang.Exception
Describe checkMaster method : マスタチェック処理.
マスタなどによるチェックを行う場合に、Overrideします。

パラメータ:
msg - a CommonMessage :
戻り値:
a CommonMessage :
例外:
java.lang.Exception - if an error occurs

checkRelation

protected CommonMessage checkRelation(CommonMessage msg)
                               throws java.lang.Exception
Describe checkRelation method : 関連チェック処理.
項目間の関連チェックが必要な場合に、Overrideします。

パラメータ:
msg - a CommonMessage :
戻り値:
a CommonMessage :
例外:
java.lang.Exception - if an error occurs

addItem

protected final void addItem(java.lang.String jspnm,
                             int pos)
Describe addItem method : 取得項目番号:表示項目名称用Mapへの登録.
_items(Map)に項目番号とJSPでの項目名の紐付けを登録する。
  1. key : JSPで指定されている項目の名称(String)
  2. value : DetailItemsInterface実装クラスの項目番号

パラメータ:
jspnm - a String : JSPでの項目名称
pos - an int : データObjectで定義されている項目位置

setJspMapping

protected JspItemsMapping setJspMapping()
Describe setJspMapping method : JSPマッピングの設定を行う.
JspItemsMappingの継承クラスをインスタンス化し、戻す。
return new xxxMapping();


setItems

protected void setItems()
Describe setItems method : 処理項目の登録処理.
処理する項目のDeataObjectの定義値(int)とJSPでの名称との 紐付けを登録する。
基本的には
addItem(DataObject.ITEM_NAME, "JSPでの項目名");
にて必要項目分、紐付け登録を行う。


newDataObj

protected abstract DetailItemsInterface newDataObj()
Describe newDataObj method : 使用するDetaObjectの実装を戻す.
使用するDataObjectをインスタンス化して戻す。
基本的には、 return new _DataObject_(); となります。

戻り値:
a DetailItemsInterface : 使用するDataObject

callControl

protected abstract CommonMessage callControl(DetailItemsInterface dii,
                                             CommonMessage msg)
                                      throws java.lang.Exception
Describe callControl method : コントロールクラスを呼び出す.
コントロールクラスを呼び出し、更新を行う。
基本的には
_Process_Control xcntl = new _Process_Control();
xcntl.update(dii);
return msg;
となります。
必要に応じてCommonMessageの設定を行います。

パラメータ:
dii - a DetailItemsInterface :
msg - a CommonMessage :
戻り値:
a CommonMessage :
例外:
java.lang.Exception - if an error occurs

setEditValue

protected DetailItemsInterface setEditValue(CommonMessage msg,
                                            DetailItemsInterface dii)
                                     throws java.lang.Exception
Describe setEditValue method : 編集項目の設定.
DBに編集して設定する項目がある場合に、overrideして記述する。

パラメータ:
msg - a CommonMessage :
dii - a DetailItemsInterface :
戻り値:
a DetailItemsInterface :
例外:
java.lang.Exception - if an error occurs