    001/*
    002 * Copyright (c) 2009 The openGion Project.
    003 *
    004 * Licensed under the Apache License, Version 2.0 (the "License");
    005 * you may not use this file except in compliance with the License.
    006 * You may obtain a copy of the License at
    007 *
    008 *     http://www.apache.org/licenses/LICENSE-2.0
    009 *
    010 * Unless required by applicable law or agreed to in writing, software
    011 * distributed under the License is distributed on an "AS IS" BASIS,
    012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
    013 * either express or implied. See the License for the specific language
    014 * governing permissions and limitations under the License.
    015 */
    016package org.opengion.plugin.query;
    017
    018import org.opengion.fukurou.system.DateSet;                                             // 6.4.2.0 (2016/01/29)
    019import org.opengion.hayabusa.db.DBConstValue;
    020
    021/**
    022 * データベース登録時に、固定値カラムの設定を行う情報を管理するクラスです。
    023 * このクラスは、GrowingMIS Ver6用の管理クラスです。
    024 * 具体的には、
    025 *     物理SEQ     SEQxxxx   (xxxxはテーブル名)
    026 *     作成日時    DYSET
    027 *     作成ＰＧ    PGSET
    028 *     作成親ＰＧ  PGPSET
    029 *     作成社員    USRSET
    030 *     更新日時    DYUPD
    031 *     更新ＰＧ    PGUPD
    032 *     更新親ＰＧ  PGPUPD
    033 *     更新社員    USRUPD
    034 * などの情報を、INSERT、UPDATE の状況に応じて提供します。
    035 * INSERT には、すべての情報(XXUPD)にも値をセットします。
    036 * これは、UPDATE された日付や時刻で、一覧検索できるようにする為で、
    037 * null にしておくと、IS NULL で問い合わせる必要があります。
    038 * INSERT データだけ取出す場合は、WHERE DYSET = DYUPD とします。
    039 * また、 物理SEQは、SEQxxxx(xxxxはテーブル名)形式のカラム名とし、
    040 * 値は、SEQxxxxS01.NEXTVAL とします。
    041 *
    042 * コンストラクターでは、テーブル名、ユーザーID,画面ID を受け取ります。
    043 * 登録時刻は、このオブジェクトが生成された時間を通常は使用します。
    044 * テーブル名を渡すのは、ワークなど、テーブル単位に処理するカラムが
    045 * 異なるので、それへの対応です。
    046 * 処理が簡素化できるように、ルールを規定すべきです。
    047 *
    048 * @og.rev 5.5.1.8 (2012/04/17) 新規追加
    049 * @og.group データ登録
    050 *
    051 * @version  5.5
    052 * @author   Kazuhiko Hasegawa
    053 * @since    JDK7.0,
    054 */
    055public class DBConstValue_VV implements DBConstValue {
    056        /** このプログラムのVERSION文字列を設定します。   {@value} */
    057        private static final String VERSION = "6.4.2.0 (2016/01/29)" ;
    058
    059        private static final String[] MSTR_UPDKEYS = { "DYUPD","PGUPD","PGPUPD","USRUPD" };
    060
    061        private static final String[] ZERO = new String[0] ;
    062
    063        private String[] insKeys = ZERO;
    064        private String[] insVals = ZERO;
    065
    066        private String[] updKeys = ZERO;
    067        private String[] updVals = ZERO;
    068
    069        /**
    070         * デフォルトコンストラクター
    071         *
    072         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    073         */
    074        public DBConstValue_VV() { super(); }           // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    075
    076        /**
    077         * 初期化情報を設定します。
    078         *
    079         * @og.rev 6.4.2.0 (2016/01/29) DateSet.getDate( String ) を利用するように修正します。
    080         *
    081         * @param       table   テーブル名
    082         * @param       user    ユーザーID
    083         * @param       gamen   画面ID
    084         */
    085        @Override       // DBConstValue
    086        public void init( final String table, final String user, final String gamen ) {
    087                if( isUseClm( table ) ) {
    088                        final String userID  = "'" + user + "'";
    089                        final String gamenID = "'" + gamen + "'";
    090                        final String timestamp = "'" + DateSet.getDate( "yyyyMMddHHmmss" ) + "'" ;                      // 6.4.2.0 (2016/01/29)
    091                        final String seqID   = "SEQ" + table ;
    092                        final String seqFanc = "SEQ" + table + "S01.NEXTVAL" ;
    093
    094                        insKeys = new String[] { seqID, "DYSET","PGSET","PGPSET","USRSET","DYUPD","PGUPD","PGPUPD","USRUPD" };
    095                        insVals = new String[] {
    096                                                         seqFanc                // SEQ領域の関数
    097                                                        ,timestamp              // DYSET
    098                                                        ,gamenID                // PGSET
    099                                                        ,gamenID                // PGPSET
    100                                                        ,userID                 // USRSET
    101                                                        ,timestamp              // DYUPD
    102                                                        ,gamenID                // PGUPD
    103                                                        ,gamenID                // PGPUPD
    104                                                        ,userID                 // USRUPD
    105                        };
    106
    107                        updKeys = MSTR_UPDKEYS;
    108                        updVals = new String[] {
    109                                                         timestamp              // DYUPD
    110                                                        ,gamenID                // PGUPD
    111                                                        ,gamenID                // PGPUPD
    112                                                        ,userID                 // USRUPD
    113                        };
    114                }
    115        }
    116
    117        /**
    118         * インサートする場合のキー配列を返します。
    119         *
    120         * 指定の値がなければ、長さゼロ配列を返します。
    121         *
    122         * @return      インサートする場合のキー配列(非null)
    123         * @og.rtnNotNull
    124         */
    125        @Override       // DBConstValue
    126        public String[] getInsertKeys() {
    127                return insKeys.clone();
    128        }
    129
    130        /**
    131         * インサートする場合の値配列を返します。
    132         *
    133         * 指定の値がなければ、長さゼロ配列を返します。
    134         *
    135         * @return      インサートする場合のキー配列(非null)
    136         * @og.rtnNotNull
    137         */
    138        @Override       // DBConstValue
    139        public String[] getInsertVals() {
    140                return insVals.clone();
    141        }
    142
    143        /**
    144         * アップデートする場合のキー配列を返します。
    145         *
    146         * 指定の値がなければ、長さゼロ配列を返します。
    147         *
    148         * @return      アップデートする場合のキー配列(非null)
    149         * @og.rtnNotNull
    150         */
    151        @Override       // DBConstValue
    152        public String[] getUpdateKeys() {
    153                return updKeys.clone();
    154        }
    155
    156        /**
    157         * アップデートする場合の値配列を返します。
    158         *
    159         * 指定の値がなければ、長さゼロ配列を返します。
    160         *
    161         * @return      アップデートする場合のキー配列(非null)
    162         * @og.rtnNotNull
    163         */
    164        @Override       // DBConstValue
    165        public String[] getUpdateVals() {
    166                return updVals.clone();
    167        }
    168
    169        /**
    170         * デリート(論理削除) する場合のキー配列を返します。
    171         *
    172         * 指定の値がなければ、長さゼロ配列を返します。
    173         *
    174         * @og.rev 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    175         *
    176         * @return      デリートする場合のキー配列(非null)
    177         * @og.rtnNotNull
    178         */
    179        @Override       // DBConstValue
    180        public String[] getLogicalDeleteKeys() {
    181                return ZERO.clone();            // 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    182        }
    183
    184        /**
    185         * デリート(論理削除) する場合の値配列を返します。
    186         *
    187         * 指定の値がなければ、長さゼロ配列を返します。
    188         *
    189         * @og.rev 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    190         *
    191         * @return      デリートする場合のキー配列(非null)
    192         * @og.rtnNotNull
    193         */
    194        @Override       // DBConstValue
    195        public String[] getLogicalDeleteVals() {
    196                return ZERO.clone();            // 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    197        }
    198
    199        /**
    200         * カラムを返すかどうかを決めるロジック
    201         *
    202         * テーブル名が存在していれば、利用可能と判断します。
    203         * これは、履歴テーブルなど、この処理を使わない場合に、
    204         * テーブル名から判定する場合に使います。現時点では、履歴テーブルは
    205         * フレームワーク側で変更するのではなく、トリガ等による自動収集と
    206         * しますので、判定対象としていません。
    207         *
    208         * @param       table   テーブル名
    209         *
    210         * @return      カラムを返すかどうか(true:カラムを生成/false:カラムは生成しない)
    211         */
    212        private boolean isUseClm( final String table ) {
    213                return table != null && table.length() > 0 ;
    214        }
    215}