    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.hayabusa.common.HybsSystem;
    019import org.opengion.hayabusa.common.HybsSystemException;
    020import org.opengion.hayabusa.db.AbstractQuery;
    021import org.opengion.fukurou.util.ErrorMessage;
    022import org.opengion.fukurou.util.StringUtil;
    023import org.opengion.fukurou.util.Closer;
    024
    025import java.sql.PreparedStatement;
    026import java.sql.ResultSet;
    027import java.sql.SQLException;
    028
    029/**
    030 * 引数引き当て(PreparedStatement) を利用した登録系Queryです。
    031 *
    032 * java.sql.PreparedStatement を用いて、データベース検索処理を行います。
    033 * 引数に、指定した値を配列で渡します。
    034 * 内部変数の受け渡しのデフォルト実装は、AbstractQuery クラスを継承している
    035 * ため,ここでは、execute() メソッドを実装しています。
    036 * このクラスでは、ステートメント文を execute() する事により,データベースを
    037 * 検索した結果を DBTableModel に割り当てます。
    038 *
    039 * このクラスは、Query で使用されるより、内部の DBTableModelUtilから、
    040 * 利用されるケースが主です。
    041 * Query で使用する場合は、JDBCPrepared ではなく、JDBCTableUpdate を
    042 * 使用することを、ご検討ください。
    043 *
    044 * @og.formSample
    045 * 例：
    046 *     可変引数付きのＳＱＬ文を実行します。
    047 *     これは、INSERT,UPDATE,DELETE など、どのようなSQL文でも実行できます。
    048 *     names 属性で指定するのは、DBTableModelのカラム名で、その値が順番に、
    049 *     引数(?記号)の個所に設定されます。
    050 *     選択されたデータ(行)の数だけ、繰り返し実行されます。
    051 *
    052 * jsp/TYPE1A/copy.jsp
    053 * &lt;og:value scope=&quot;session&quot;
    054 *            key=&quot;names&quot;
    055 *            value=&quot;CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG&quot; /&gt;
    056 * &lt;og:value scope=&quot;session&quot; key=&quot;SQL&quot; &gt;
    057 *     INSERT INTO GEA08
    058 *         (CLM,NAME_JA,LABEL_NAME,KBSAKU,SYSTEM_ID,LANG,
    059 *          FGJ,DYSET,DYUPD,USRSET,USRUPD,PGUPD)
    060 *     VALUES
    061 *         (?,?,?,?,?,?,
    062 *          &#39;1&#39;,&#39;{&#064;USER.YMDH}&#39;,&#39;{&#064;USER.YMDH}&#39;,&#39;{&#064;USER.ID}&#39;,&#39;{&#064;USER.ID}&#39;,&#39;{&#064;GUI.KEY}&#39;)
    063 * &lt;/og:value&gt;
    064 *
    065 * jsp/TYPE1A/entry.jsp
    066 * &lt;h:tableUpdate
    067 *     command   = &quot;{&#064;command}&quot;
    068 *     queryType = &quot;JDBCPrepared&quot;
    069 *     names     = &quot;{&#064;names}&quot;  &gt;
    070 * {&#064;SQL}
    071 * &lt;/og:tableUpdate&gt;
    072 *
    073 * &lt;!-- 前画面で指定のSQL文を削除します。(scope=&quot;session&quot;なので削除が必要。) --&gt;
    074 * &lt;og:value scope=&quot;session&quot; key=&quot;names&quot; command=&quot;REMOVE&quot; /&gt;
    075 * &lt;og:value scope=&quot;session&quot; key=&quot;SQL&quot;   command=&quot;REMOVE&quot; /&gt;
    076 *
    077 * @og.group データ表示
    078 * @og.group データ編集
    079 *
    080 * @version  4.0
    081 * @author   Kazuhiko Hasegawa
    082 * @since    JDK5.0,
    083 */
    084public class Query_JDBCPrepared extends AbstractQuery {
    085        //* このプログラムのVERSION文字列を設定します。   {@value} */
    086        private static final String VERSION = "5.3.8.0 (2011/08/01)" ;
    087
    088        private PreparedStatement pstmt = null ;
    089
    090        /**
    091         * 引数配列付のクエリーを実行します。
    092         * 処理自体は, #execute() と同様に、各サブクラスの実装に依存します。
    093         * これは、PreparedQuery で使用する引数を配列でセットするものです。
    094         * select * from emp where deptno = ? and job = ? などの PreparedQuery の
    095         * ? 部分の引数を
    096         * 順番にセットしていきます。
    097         *
    098         * @og.rev 2.1.2.3 (2002/12/02) データベース更新時に、更新フラグをセットするように変更
    099         * @og.rev 2.3.1.3 (2003/01/28) Open Cursor が、大量に残る件の対応。ResultSet を close()
    100         * @og.rev 3.1.1.0 (2003/03/28) 同期メソッド(synchronized付き)を非同期に変更する。
    101         * @og.rev 3.3.3.1 (2003/07/18) ＤＢ登録時の後ろスペースを削除する。
    102         * @og.rev 3.5.6.0 (2004/06/18) PreparedStatement をexecute 間で使いまわします。
    103         * @og.rev 3.8.0.8 (2005/10/03) エラーメッセージの出力順をメッセージ＋Queryに変更します。
    104         * @og.rev 5.3.8.0 (2011/08/01) pstmt.setObject で、useParamMetaData の判定を避けるため、pstmt.setString で代用(PostgreSQL対応)
    105         *
    106         * @param   args オブジェクトの引数配列
    107         */
    108        @Override
    109        public void execute( final String[] args ) {
    110                ResultSet resultSet = null ;
    111                try {
    112                        if( pstmt== null ) {
    113                                pstmt = getConnection().prepareStatement( getStatement() );
    114                                pstmt.setQueryTimeout( DB_MAX_QUERY_TIMEOUT );
    115                        }
    116
    117                        if( args != null ) {
    118                                for( int i=0; i<args.length; i++ ) {
    119                                        pstmt.setString( i+1,StringUtil.rTrim( args[i] ) );     // 5.3.8.0 (2011/08/01) 処理の簡素化
    120                                }
    121                        }
    122
    123                        boolean status = pstmt.execute();
    124                        if( status ) {
    125                                resultSet = pstmt.getResultSet();
    126                                createTableModel( resultSet );
    127                                setUpdateFlag( false );
    128                        }
    129                        else {
    130                                setExecuteCount( pstmt.getUpdateCount() );
    131                        }
    132
    133                        setErrorCode( ErrorMessage.OK );
    134                }
    135                catch ( SQLException ex ) {
    136                        setErrorCode( ErrorMessage.EXCEPTION );
    137                        Closer.stmtClose( pstmt );
    138
    139                        String errMsg = ex.getMessage() + ":" + ex.getSQLState() + HybsSystem.CR
    140                                                + getStatement() + HybsSystem.CR;
    141                        rollback();
    142                        realClose();
    143                        throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数の並び順変更
    144                }
    145                finally {
    146                        Closer.resultClose( resultSet );
    147                }
    148        }
    149
    150        /**
    151         * PreparedStatement をクローズします。
    152         */
    153        @Override
    154        public void close() {
    155                Closer.stmtClose( pstmt );
    156                super.close();
    157        }
    158}