    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.hayabusa.db;
    017
    018import java.sql.Connection;
    019import java.sql.ResultSet;
    020import java.sql.SQLException;
    021
    022import org.opengion.fukurou.system.HybsConst ;                          // 6.1.0.0 (2014/12/26)
    023import org.opengion.fukurou.system.ThrowUtil;                           // 6.4.2.0 (2016/01/29)
    024import org.opengion.fukurou.util.ErrorMessage;
    025import org.opengion.hayabusa.common.HybsSystem;
    026import org.opengion.hayabusa.common.HybsSystemException;
    027import org.opengion.hayabusa.resource.ResourceManager;
    028
    029/**
    030 * Query インターフェースを継承した Query の実装クラスです。
    031 * クエリークラスにステートメントを与えて execute()することにより内部に DBTableModel を
    032 * 作成します。
    033 * このクラスは、Abstract クラスのため、実装は個々のサブクラスで行います。
    034 * 唯一実装する必要があるのは, execute() メソッドだけです。
    035 *
    036 * @og.group ＤＢ検索
    037 * @og.group ＤＢ登録
    038 *
    039 * @version  4.0
    040 * @author       Kazuhiko Hasegawa
    041 * @since    JDK5.0,
    042 */
    043public class AbstractQuery implements Query {
    044        /** システムの改行コードを設定します。*/
    045        protected static final String CR                 = HybsConst.CR;                        // 6.1.0.0 (2014/12/26) refactoring
    046        /** StringBilderなどの初期値を設定します。   {@value} */
    047        protected static final int BUFFER_MIDDLE = HybsConst.BUFFER_MIDDLE;     // 6.1.0.0 (2014/12/26) refactoring
    048
    049        private Connection              connection      ;
    050        private int                     rtnCode         = ErrorMessage.OK;
    051        private ErrorMessage    errMessage      ;
    052        private ResourceManager resource        ;
    053
    054        private DBTableModel table                      ;
    055        private String           stmtString             ;
    056        private int              executeCount   = -1 ;
    057        private int              skipRowCount   ;
    058        private int              maxRowCount    = HybsSystem.sysInt( "DB_MAX_ROW_COUNT" ) ;
    059        private boolean          updateFlag             = true ;
    060        private DBEditConfig config                     ;               // 5.3.6.0 (2011/06/01)
    061
    062        // 5.1.9.0 (2010/08/01) DB_RETRY_COUNT,DB_RETRY_TIME 廃止
    063        /** データ検索時の最大処理制限時間  */
    064        protected static final int DB_MAX_QUERY_TIMEOUT = HybsSystem.sysInt( "DB_MAX_QUERY_TIMEOUT" ) ;
    065
    066        /** 6.9.3.0 (2018/03/26) データ検索時のフェッチサイズ {@value}  */
    067        protected static final int DB_FETCH_SIZE                = HybsConst.DB_FETCH_SIZE;      // 6.9.4.1 (2018/04/09)
    068
    069//      /** データ検索時のフェッチサイズを設定します。 */
    070//      protected static final int DB_FETCH_SIZE  = HybsConst.DB_FETCH_SIZE;    // 6.9.4.1 (2018/04/09)
    071
    072        // 3.5.2.0 (2003/10/20) 内部オブジェクトタイプ名を システムパラメータ で定義します。
    073        /** 内部オブジェクトタイプ名  {@value} */
    074        public static final String ARG_ARRAY            = "ARG_ARRAY" ;
    075        /** 内部オブジェクトタイプ名  {@value} */
    076        public static final String SYSARG_ARRAY         = "SYSARG_ARRAY" ;
    077        /** 内部オブジェクトタイプ名  {@value} */
    078        public static final String ERR_MSG                      = "ERR_MSG" ;
    079        /** 内部オブジェクトタイプ名  {@value} */
    080        public static final String ERR_MSG_ARRAY        = "ERR_MSG_ARRAY" ;
    081
    082        private String  updQuery                ;                       // 7.2.9.1 (2020/10/23)
    083        private String  insQuery                ;                       // 7.2.9.1 (2020/10/23)
    084
    085        /**
    086         * デフォルトコンストラクター
    087         *
    088         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    089         */
    090        protected AbstractQuery() { super(); }          // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    091
    092        /**
    093         * Connectionオブジェクトを外部から設定します。
    094         *
    095         * 通常は、Transaction と 接続先(DBID) を使用して作成した Connection を渡します。
    096         * このクラスでは、Connection の close() や、ConnectionFactory への返却なども
    097         * 行いません。それらは、外部処理(通常は、Transactionオブジェクト)で行います。
    098         *
    099         * Connection には、null は登録できません。
    100         *
    101         * @og.rev 6.3.6.1 (2015/08/28) 新規追加
    102         *
    103         * @param       conn    Connectionオブジェクト
    104         */
    105        public void setConnection( final Connection conn ) {
    106                if( conn == null ) {
    107                        final String errMsg = "Connection に null は指定できません。" + CR ;
    108                        throw new HybsSystemException( errMsg );
    109                }
    110                connection = conn;
    111        }
    112
    113        /**
    114         * ステートメント文字列をセットします。
    115         *
    116         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    117         *
    118         * @param       stmt ステートメント文字列
    119         *
    120         */
    121        public void setStatement( final String stmt ) {
    122                this.stmtString = stmt.trim();
    123        }
    124
    125        /**
    126         * ステートメント文字列を取り出します。
    127         *
    128         * @return       ステートメント文字列
    129         *
    130         */
    131        public String getStatement() {
    132                return stmtString;
    133        }
    134
    135        /**
    136         * ステートメント文字列(UPDATE,INSERT)をセットします。
    137         *
    138         * @og.rev 7.2.9.1 (2020/10/23) TableUpdateParamTag のマージ(UPDATE,INSERT)対応
    139         *
    140         * @param   update UPDATEステートメント文字列
    141         * @param   insert INSERTステートメント文字列
    142         */
    143        public void setMergeStatement( final String update , final String insert ) {
    144                updQuery = update;
    145                insQuery = insert;
    146        }
    147
    148        /**
    149         * ステートメント文字列(UPDATE,INSERT)を取り出します。
    150         *
    151         * @og.rev 7.2.9.1 (2020/10/23) TableUpdateParamTag のマージ(UPDATE,INSERT)対応
    152         * @og.rev 7.2.9.3 (2020/11/06) 早い段階でエラーにしておきます。
    153         *
    154         * @return  ステートメント文字列の配列(UPDATE,INSERTの順番)
    155         *
    156         */
    157        public String[] getMergeStatement() {
    158                if( updQuery == null || insQuery == null ) {
    159                        final String errMsg = "Merge処理を行うには、INSERTとUPDATEの両方のQUERYが必要です。" + CR
    160                                + " updQuery=" + updQuery + CR
    161                                + " insQuery=" + insQuery + CR
    162                                + " query   =" + stmtString ;
    163
    164                        throw new UnsupportedOperationException( errMsg );
    165                }
    166
    167                return new String[] { updQuery,insQuery } ;
    168        }
    169
    170        /**
    171         * 引数配列付のクエリーを実行します。
    172         * 処理自体は, #execute() と同様に、各サブクラスの実装に依存します。
    173         * これは、PreparedQuery で使用する引数を配列でセットするものです。
    174         * select * from emp where deptno = ? and job = ? などの PreparedQuery や
    175         * { call xxxx( ?,?,? ) } などの CallableStatement の ? 部分の引数を
    176         * 順番にセットしていきます。
    177         * ※ このクラスでは実装されていません。
    178         *
    179         * @og.rev 6.1.1.0 (2015/01/17) 引数配列を可変引数にして、execute() を含めて定義します。
    180         *
    181         * @param       args オブジェクトの引数配列(可変長引数)
    182         */
    183        public void execute( final String... args ) {                   // 6.1.1.0 (2015/01/17) refactoring
    184                final String errMsg = "このクラスでは実装されていません。execute( String... )";
    185                throw new UnsupportedOperationException( errMsg );
    186        }
    187
    188        /**
    189         * 引数配列付のクエリーを実行します。
    190         * 処理自体は, #execute() と同様に、各サブクラスの実装に依存します。
    191         * これは、PreparedQuery で使用する引数を配列でセットするものです。
    192         * select * from emp where deptno = ? and job = ? などの PreparedQuery の
    193         * ? 部分の引数を
    194         * 順番にセットしていきます。
    195         * ※ このクラスでは実装されていません。
    196         *
    197         * @og.rev 4.0.0.0 (2005/01/31) 新規追加
    198         *
    199         * @param   keys オブジェクトのキー配列
    200         * @param   args オブジェクトの引数配列(可変長引数)
    201         */
    202        public void execute( final String[] keys, final String... args ) {                      // 6.1.1.0 (2015/01/17) refactoring
    203                final String errMsg = "このクラスでは実装されていません。execute( String[],String... )";
    204                throw new UnsupportedOperationException( errMsg );
    205        }
    206
    207        /**
    208         * 引数配列付のクエリーを実行します。
    209         * 処理自体は, #execute() と同様に、各サブクラスの実装に依存します。
    210         * これは、PreparedQuery で使用する引数を配列でセットするものです。
    211         * select * from emp where deptno = ? and job = ? などの PreparedQuery の
    212         * ? 部分の引数を
    213         * 順番にセットしていきます。
    214         * ※ このクラスでは実装されていません。
    215         *
    216         * @og.rev 4.0.0.0 (2005/01/31) 引数をすべて受け取って実行するメソッドを標準メソッドとして追加
    217         *
    218         * @param       names           カラム名(CSV形式)
    219         * @param       dbArrayType     アレイタイプ名称
    220         * @param       sysArg          DBSysArg配列
    221         * @param       userArg         DBUserArg配列
    222         */
    223        public void execute( final String names,final String dbArrayType,
    224                                                final DBSysArg[] sysArg,final DBUserArg[] userArg ) {
    225                final String errMsg = "このクラスでは実装されていません。execute( String,String,DBSysArg[],DBUserArg[] )";
    226                throw new UnsupportedOperationException( errMsg );
    227        }
    228
    229        /**
    230         * 引数配列付のクエリーを実行します。
    231         * 処理自体は, #execute() と同様に、各サブクラスの実装に依存します。
    232         * これは、PreparedQuery で使用する引数を配列でセットするものです。
    233         * select * from emp where deptno = ? and job = ? などの PreparedQuery の
    234         * [カラム名] 部分の引数を、DBTableModelから順番にセットしていきます。
    235         * ※ このクラスでは実装されていません。
    236         *
    237         * @param   rowNo 選択された行番号配列(登録する対象行)
    238         * @param   table DBTableModelオブジェクト(登録する元データ)
    239         */
    240        public void execute( final int[] rowNo, final DBTableModel table ) {
    241                final String errMsg = "このクラスでは実装されていません。execute( final int[] rowNo, final DBTableModel table )";
    242                throw new UnsupportedOperationException( errMsg );
    243        }
    244
    245        /**
    246         * クエリーの実行結果件数をセットします。
    247         * 初期値は -1 です。(クエリーが失敗した場合や,CallableStatement の呼び出し等で
    248         * 実行件数が明確でない場合の戻り値)。
    249         *
    250         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    251         *
    252         * @param       executeCount 実行結果件数
    253         */
    254        protected void setExecuteCount( final int executeCount ) {
    255                this.executeCount = executeCount;
    256        }
    257
    258        /**
    259         * クエリーの実行結果を返します。
    260         * クエリーが失敗した場合や,CallableStatement の呼び出し等で実行件数が明確でない
    261         * 場合は, -1 が返されます。
    262         *
    263         * @return      実行結果件数
    264         */
    265        public int getExecuteCount() {
    266                return executeCount;
    267        }
    268
    269        /**
    270         * DBTableModel をセットします。
    271         * なお、検索系実行前に setDBTableModel() でテーブルをセットしていたとしても
    272         * そのオブジェクトは破棄されて、新しい DBTableModel が生成されます。
    273         *
    274         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    275         *
    276         * @param       table DBTableModelオブジェクト
    277         */
    278        protected void setDBTableModel( final DBTableModel table ) {
    279                this.table = table;
    280        }
    281
    282        /**
    283         * 実行結果の DBTableModel を返します。
    284         *
    285         * @return      DBTableModelオブジェクト
    286         */
    287        public DBTableModel getDBTableModel() {
    288                return table;
    289        }
    290
    291        /**
    292         * データベースの最大検索件数を返します。
    293         *              (初期値:DB_MAX_ROW_COUNT[={@og.value SystemData#DB_MAX_ROW_COUNT}])。
    294         * データベース自体の検索は,指定されたSQLの全件を検索しますが,
    295         * DBTableModelのデータとして登録する最大件数をこの値に設定します。0は無制限です。
    296         * サーバーのメモリ資源と応答時間の確保の為です。
    297         *
    298         * @return      最大検索件数
    299         */
    300        public int getMaxRowCount() {
    301                return maxRowCount;
    302        }
    303
    304        /**
    305         * データベースの最大検索件数をセットします。
    306         * データベース自体の検索は,指定されたSQLの全件を検索しますが,
    307         * DBTableModelのデータとして登録する最大件数をこの値に設定します。
    308         * サーバーのメモリ資源と応答時間の確保の為です。
    309         * ゼロ、または、負の値を設定すると、無制限(Integer.MAX_VALUE)になります。
    310         *
    311         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    312         * @og.rev 4.0.0.0 (2005/08/31) ゼロ、または、負の値は、無制限(Integer.MAX_VALUE)にする。
    313         *
    314         * @param       maxRowCount 最大検索件数
    315         */
    316        public void setMaxRowCount( final int maxRowCount ) {
    317                this.maxRowCount = maxRowCount > 0 ? maxRowCount : Integer.MAX_VALUE ;
    318        }
    319
    320        /**
    321         * データベースの検索スキップ件数を返します。
    322         * データベース自体の検索は,指定されたSQLの全件を検索しますが,
    323         * DBTableModelのデータとしては、スキップ件数分は登録されません。
    324         * サーバーのメモリ資源と応答時間の確保の為です。
    325         *
    326         * @return      最大検索件数
    327         */
    328        public int getSkipRowCount() {
    329                return skipRowCount;
    330        }
    331
    332        /**
    333         * データベースの検索スキップ件数をセットします。
    334         * データベース自体の検索は,指定されたSQLの全件を検索しますが,
    335         * DBTableModelのデータとしては、スキップ件数分は登録されません。
    336         * サーバーのメモリ資源と応答時間の確保の為です。
    337         *
    338         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    339         *
    340         * @param       skipRowCount スキップ件数
    341         */
    342        public void setSkipRowCount( final int skipRowCount ) {
    343                this.skipRowCount = skipRowCount;
    344        }
    345
    346        /**
    347         * アップデートフラグをセットします。
    348         * これは、Query で更新処理の SQL 文を実行したときにセットされます。
    349         * 更新処理が実行：true / 検索処理のみ：false をセットします。
    350         * このメソッドを呼び出さない場合は、デフォルト：true  です。
    351         *
    352         * @og.rev 2.1.2.3 (2002/12/02) データベース更新時に、更新フラグをセットするように変更
    353         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    354         *
    355         * @param       up      アップデートされたかどうか[true:更新処理/false:検索処理]
    356         */
    357        protected void setUpdateFlag( final boolean up ) {
    358                updateFlag = up;
    359        }
    360
    361        /**
    362         * アップデートフラグを取得します。
    363         * これは、Query で更新処理の SQL 文を実行したときに true にセットされます。
    364         * 更新処理が実行：true / 検索処理のみ：false を取得できます。
    365         *
    366         * @og.rev 2.1.2.3 (2002/12/02) データベース更新時に、更新フラグをセットするように変更
    367         * @og.rev 4.0.0.0 (2007/07/20) メソッド名変更( getUpdateFlag() ⇒ isUpdate() )
    368         *
    369         * @return       アップデートされたかどうか[true:更新処理/false:検索処理]
    370         */
    371        public boolean isUpdate() {
    372                return updateFlag ;
    373        }
    374
    375        /**
    376         * リソースマネージャーをセットします。
    377         * これは、言語(ロケール)に応じた DBColumn をあらかじめ設定しておく為に
    378         * 必要です。
    379         * リソースマネージャーが設定されていない、または、所定のキーの DBColumn が
    380         * リソースに存在しない場合は、内部で DBColumn オブジェクトを作成します。
    381         *
    382         * @og.rev 4.0.0.0 (2005/01/31) lang ⇒ ResourceManager へ変更
    383         *
    384         * @param       resource リソースマネージャー
    385         */
    386        public void setResourceManager( final ResourceManager resource ) {
    387                this.resource = resource;
    388        }
    389
    390        /**
    391         * エラーコード を取得します。
    392         * エラーコード は、ErrorMessage クラスで規定されているコードです。
    393         *
    394         * @return   エラーコード
    395         */
    396        public int getErrorCode() {
    397                return rtnCode;
    398        }
    399
    400        /**
    401         * エラーコード をセットします。
    402         * エラーコード は、ErrorMessage クラスで規定されているコードです。
    403         *
    404         * @param   cd エラーコード
    405         */
    406        protected void setErrorCode( final int cd ) {
    407                rtnCode = cd;
    408        }
    409
    410        /**
    411         * エラーメッセージオブジェクト を取得します。
    412         *
    413         * @return   エラーメッセージオブジェクト
    414         */
    415        public ErrorMessage getErrorMessage() {
    416                return errMessage;
    417        }
    418
    419        /**
    420         * エラーメッセージオブジェクト をセットします。
    421         *
    422         * @param   em エラーメッセージオブジェクト
    423         */
    424        protected void setErrorMessage( final ErrorMessage em ) {
    425                errMessage = em;
    426        }
    427
    428        /**
    429         * 編集設定オブジェクトをセットします。
    430         *
    431         * @og.rev 5.3.6.0 (2011/06/01) 新規追加
    432         *
    433         * @param config 編集設定オブジェクト
    434         */
    435        public void setEditConfig( final DBEditConfig config ) {
    436                this.config = config;
    437        }
    438
    439        /**
    440         * 編集設定オブジェクトを取得します。
    441         *
    442         * @og.rev 5.3.6.0 (2011/06/01) 新規追加
    443         *
    444         * @return 編集設定オブジェクト
    445         */
    446        protected DBEditConfig getEditConfig() {
    447                return config;
    448        }
    449
    450        //////////////////////////////////////////////////////////////////////////
    451        //
    452        //       継承時にサブクラスから使用するメソッド類( protected )
    453        //
    454        //////////////////////////////////////////////////////////////////////////
    455
    456        /**
    457         * ResultSet を DBTableModelに割り当てます。
    458         *
    459         * 毎回,検索毎に,DBTableModel にコピーするイメージです。
    460         * ResulSet 以外のオブジェクトから，DBTableModelを作成する場合は,
    461         * このメソッドをオーバーライドします。
    462         *
    463         * このメソッドは， execute からのみ,呼び出されます。
    464         * それ以外からは呼出し出来ません。
    465         *
    466         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    467         * @og.rev 3.3.3.3 (2003/08/06) カラムのラベル名を、大文字に変換する。
    468         * @og.rev 3.8.5.0 (2006/03/02) CLOB カラムかどうかを判定しCLOBの場合は、Clob オブジェクトから文字列を取り出します。
    469         * @og.rev 3.8.8.8 (2007/05/11) ROWID対応(小数点対応 "0.3" が ".3" と表示される対策)
    470         * @og.rev 4.0.0.0 (2006/01/31) CLOB カラムかどうかを判定しCLOBの場合は、ストリームから値を取り出します。
    471         * @og.rev 5.3.6.0 (2011/06/01) DBTableModel作成処理をDBTableModelUtilに移動＆集計機能対応
    472         * @og.rev 6.3.6.1 (2015/08/28) close(),realClose() 廃止。Queryはキャッシュしません。
    473         *
    474         * @param       resultSet ResultSetオブジェクト
    475         */
    476        protected void createTableModel( final ResultSet resultSet ) {
    477                try {
    478                        if( config == null ) {
    479                                table = DBTableModelUtil.makeDBTable( resultSet, getSkipRowCount(), maxRowCount, resource );
    480                        }
    481                        else {
    482                                table = DBTableModelUtil.makeEditDBTable( resultSet, getSkipRowCount(), maxRowCount, resource, config );
    483                        }
    484
    485                        setExecuteCount( table.getRowCount() );
    486                }
    487                catch( final SQLException ex ) {
    488                        final String errMsg = "テーブルモデルを作成できませんでした。";
    489                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
    490                }
    491        }
    492
    493        /**
    494         * ConnectionFactory.connection( String ); を利用して,Connection
    495         * オブジェクトを取り出します。
    496         *
    497         * コネクションプールが一杯の場合は、即エラーになります。
    498         *
    499         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    500         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為,ApplicationInfoオブジェクトを設定
    501         * @og.rev 5.1.9.0 (2010/08/01) transaction 属性追加。
    502         * @og.rev 6.3.6.1 (2015/08/28) transaction 属性廃止。内部のConnectionを返します。
    503         *
    504         * @return      コネクション
    505         */
    506        protected Connection getConnection() {
    507                return connection;
    508        }
    509
    510        /**
    511         * この接続が、PreparedStatement#getParameterMetaData() を使用するかどうかを判定します。
    512         *
    513         * ConnectionFactory#useParameterMetaData(String) の結果を返します。(postgreSQL対応)
    514         *
    515         * ※ 暫定処理です。もっと、良い方法を考える必要があります。
    516         *
    517         * @og.rev 5.3.8.0 (2011/08/01) 新規追加
    518         * @og.rev 6.3.6.1 (2015/08/28) 内部変数にconnIDが無くなったため、直接所得することになりました。
    519         * @og.rev 6.4.2.0 (2016/01/29) ex.printStackTrace() を、ThrowUtil#ogStackTrace(Throwable) に置き換え。
    520         *
    521         * @return      使用する場合：true / その他:false
    522         * @see org.opengion.fukurou.db.ConnectionFactory#useParameterMetaData(String)
    523         */
    524        protected boolean useParameterMetaData() {
    525        //      return ConnectionFactory.useParameterMetaData( connID );
    526                try {
    527                        return "PostgreSQL".equalsIgnoreCase( connection.getMetaData().getDatabaseProductName() );
    528                }
    529                catch( final Throwable th ) {
    530                        System.err.println( ThrowUtil.ogStackTrace( th ) );                             // 6.4.2.0 (2016/01/29)
    531                }
    532                return false ;
    533        }
    534
    535        //////////////////////////////////////////////////////////////////////////
    536        //
    537        //       Object クラスのオーバーライド部分
    538        //
    539        //////////////////////////////////////////////////////////////////////////
    540
    541        /**
    542         * オブジェクトの識別子として，最後のクエリーを返します。
    543         *
    544         * @return      最後のクエリー
    545         * @og.rtnNotNull
    546         */
    547        @Override
    548        public String toString() {
    549                return  "LastQuery  :[" + getStatement() + "] ";
    550        }
    551}