    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        public void init( final String table, final String user, final String gamen ) {
    086                if( isUseClm( table ) ) {
    087                        final String userID  = "'" + user + "'";
    088                        final String gamenID = "'" + gamen + "'";
    089                        final String timestamp = "'" + DateSet.getDate( "yyyyMMddHHmmss" ) + "'" ;                      // 6.4.2.0 (2016/01/29)
    090                        final String seqID   = "SEQ" + table ;
    091                        final String seqFanc = "SEQ" + table + "S01.NEXTVAL" ;
    092
    093                        insKeys = new String[] { seqID, "DYSET","PGSET","PGPSET","USRSET","DYUPD","PGUPD","PGPUPD","USRUPD" };
    094                        insVals = new String[] {
    095                                                         seqFanc                // SEQ領域の関数
    096                                                        ,timestamp              // DYSET
    097                                                        ,gamenID                // PGSET
    098                                                        ,gamenID                // PGPSET
    099                                                        ,userID                 // USRSET
    100                                                        ,timestamp              // DYUPD
    101                                                        ,gamenID                // PGUPD
    102                                                        ,gamenID                // PGPUPD
    103                                                        ,userID                 // USRUPD
    104                        };
    105
    106                        updKeys = MSTR_UPDKEYS;
    107                        updVals = new String[] {
    108                                                         timestamp              // DYUPD
    109                                                        ,gamenID                // PGUPD
    110                                                        ,gamenID                // PGPUPD
    111                                                        ,userID                 // USRUPD
    112                        };
    113                }
    114        }
    115
    116        /**
    117         * インサートする場合のキー配列を返します。
    118         *
    119         * 指定の値がなければ、長さゼロ配列を返します。
    120         *
    121         * @return      インサートする場合のキー配列(非null)
    122         * @og.rtnNotNull
    123         */
    124        public String[] getInsertKeys() {
    125                return insKeys.clone();
    126        }
    127
    128        /**
    129         * インサートする場合の値配列を返します。
    130         *
    131         * 指定の値がなければ、長さゼロ配列を返します。
    132         *
    133         * @return      インサートする場合のキー配列(非null)
    134         * @og.rtnNotNull
    135         */
    136        public String[] getInsertVals() {
    137                return insVals.clone();
    138        }
    139
    140        /**
    141         * アップデートする場合のキー配列を返します。
    142         *
    143         * 指定の値がなければ、長さゼロ配列を返します。
    144         *
    145         * @return      アップデートする場合のキー配列(非null)
    146         * @og.rtnNotNull
    147         */
    148        public String[] getUpdateKeys() {
    149                return updKeys.clone();
    150        }
    151
    152        /**
    153         * アップデートする場合の値配列を返します。
    154         *
    155         * 指定の値がなければ、長さゼロ配列を返します。
    156         *
    157         * @return      アップデートする場合のキー配列(非null)
    158         * @og.rtnNotNull
    159         */
    160        public String[] getUpdateVals() {
    161                return updVals.clone();
    162        }
    163
    164        /**
    165         * デリート(論理削除) する場合のキー配列を返します。
    166         *
    167         * 指定の値がなければ、長さゼロ配列を返します。
    168         *
    169         * @og.rev 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    170         *
    171         * @return      デリートする場合のキー配列(非null)
    172         * @og.rtnNotNull
    173         */
    174        public String[] getLogicalDeleteKeys() {
    175                return ZERO.clone();            // 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    176        }
    177
    178        /**
    179         * デリート(論理削除) する場合の値配列を返します。
    180         *
    181         * 指定の値がなければ、長さゼロ配列を返します。
    182         *
    183         * @og.rev 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    184         *
    185         * @return      デリートする場合のキー配列(非null)
    186         * @og.rtnNotNull
    187         */
    188        public String[] getLogicalDeleteVals() {
    189                return ZERO.clone();            // 6.3.9.0 (2015/11/06) Returning 'ZERO' may expose an internal array.(PMD)
    190        }
    191
    192        /**
    193         * カラムを返すかどうかを決めるロジック
    194         *
    195         * テーブル名が存在していれば、利用可能と判断します。
    196         * これは、履歴テーブルなど、この処理を使わない場合に、
    197         * テーブル名から判定する場合に使います。現時点では、履歴テーブルは
    198         * フレームワーク側で変更するのではなく、トリガ等による自動収集と
    199         * しますので、判定対象としていません。
    200         *
    201         * @param       table   テーブル名
    202         *
    203         * @return      カラムを返すかどうか(true:カラムを生成/false:カラムは生成しない)
    204         */
    205        private boolean isUseClm( final String table ) {
    206                return table != null && table.length() > 0 ;
    207        }
    208}