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     */
016    package org.opengion.plugin.query;
017    
018    import org.opengion.hayabusa.db.AbstractQuery;
019    import org.opengion.hayabusa.db.DBErrMsg;
020    import org.opengion.hayabusa.common.HybsSystem;
021    import org.opengion.hayabusa.common.HybsSystemException;
022    import org.opengion.fukurou.util.ErrorMessage;
023    import org.opengion.fukurou.util.StringUtil;
024    import org.opengion.fukurou.util.Closer;
025    
026    import java.sql.Types;
027    import java.sql.Connection;
028    import java.sql.CallableStatement;
029    import java.sql.SQLException;
030    // import java.sql.Array;                                               // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対応ã?oracle.sql.ARRAY ã®ç½®ãæ›ã?
031    import oracle.sql.ARRAY;                                                // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
032    import oracle.sql.ArrayDescriptor;                              // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
033    // import oracle.jdbc.OracleConnection;                 // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
034    
035    import oracle.jdbc.OracleTypes;                                 // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対応ã?oracle.sql.Types ã®ç½®ãæ›ã?
036    import oracle.jdbc.OracleCallableStatement;             // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
037    
038    import java.util.Map;
039    
040    /**
041     * PL/SQL ã«ã‚¨ãƒ³ãƒˆãƒªæƒ??ã‚’é?列渡ã—ã™ã‚‹ã?Query 実行クラスã§ã™ã?
042     *
043     * java.sql.CallableStatement を用ã?¦ã€ãƒ‡ãƒ¼ã‚¿ãƒ™ã?ス登録処ç?‚’行ã„ã¾ã™ã?
044     * 引数ã«ã€ã‚­ãƒ¼ã¨å€¤ã‚’ã‚»ãƒ?ƒˆã§é…å?æŒ?®šã§æ¸¡ã™ã“ã¨ãŒå?æ¥?Œã‚¨ãƒ©ãƒ¼æ™‚ã«ã¯ã€?
045     * DBErrMsg オブジェクトã«ã‚¨ãƒ©ãƒ¼æƒ??ã‚’æ?ç´ã—ã¦è¿”ã™ã“ã¨ãŒå¯èƒ½ã§ã™ã?
046     * å†?ƒ¨å¤‰æ•°ã®å—ã‘æ¸¡ã—ã?ãƒ?ƒ•ォルト実è£??ã€AbstractQuery クラスを継承ã—ã¦ã?‚‹
047     * ãŸã‚,ã“ã“ã§ã¯ã€execute() メソãƒ?ƒ‰ã‚’実è£?—ã¦ã?¾ã™ã?
048     * ã“ã?クラスã§ã¯ã€ã‚¹ãƒ??トメント文ã‚?execute() ã™ã‚‹äº‹ã«ã‚ˆã‚Š,ãƒ??タベã?スã‚?
049     * 検索ã—ãŸçµæžœã‚?DBTableModel ã«å‰²ã‚Šå½“ã¦ã¾ã™ã?
050     *
051     * @og.formSample
052     * 例�
053     *     第ä¸?¼•æ•°ã€ç¬¬äºŒå¼•æ•°ã¯ã€çµæžœ(KEKKA)ã¨ã‚¨ãƒ©ãƒ¼ãƒ¡ãƒ?‚»ãƒ¼ã‚¸é…å?ã‚’è¿”ã—ã¾ã™ã?
054     *     キーエントリã§ã¯ã€ã‚¨ãƒ³ãƒˆãƒª(リクエスト情報)ã®ã‚­ãƒ¼ã¨å€¤ã‚’ã‚»ãƒ?ƒˆã§
055     *     引数ã®é…å?ã«è¨­å®šã—ã¾ã™ã?
056     *     キーをå?ã«ã€å?を利用ã™ã‚‹å ´åˆã«ä½¿ç”¨ã—ã¾ã™ã?
057     *     下記ã?例ã?ã€å‹•çš?‚«ãƒ©ãƒ?‚’実ç¾ã—ã¦ã?‚‹PL/SQLã®ä¾‹ã§ã™ã?
058     *
059     * <og:entryQuery
060     *     command    = "NEW"
061     *     queryType  = "JDBCKeyEntry" >
062     *         { call DYNAMIC_PKG.DYNAMIC_TEST( ?,?,?,? ) }
063     * </og:entryQuery>
064     *
065     *    CREATE OR REPLACE PACKAGE DYNAMIC_PKG AS
066     *        PROCEDURE DYNAMIC_TEST(
067     *            P_KEKKA       OUT    NUMBER,
068     *            P_ERRMSGS     OUT    ERR_MSG_ARRAY,
069     *            P_KEYS        IN     ARG_ARRAY,
070     *            P_ARGS        IN     ARG_ARRAY );
071     *    END;
072     *
073     * @og.group �?タ編�
074     *
075     * @version  4.0
076     * @author   Kazuhiko Hasegawa
077     * @since    JDK5.0,
078     */
079    public class Query_JDBCKeyEntry extends AbstractQuery {
080            //* ã“ã?プログラãƒ??VERSIONæ–?­—å?を設定ã—ã¾ã™ã?       {@value} */
081            private static final String VERSION = "5.7.2.3 (2014/01/31)" ;
082    
083            /**
084             * 引数é…å?付ã?クエリーを実行ã—ã¾ã™ã?
085             * 処ç??体ã?, #execute() ã¨åŒæ§˜ã«ã€å„サブクラスã®å®Ÿè£?«ä¾å­˜ã—ã¾ã™ã?
086             * ã“れã¯ã€PreparedQuery ã§ä½¿ç”¨ã™ã‚‹å¼•æ•°ã‚’é?列ã§ã‚»ãƒ?ƒˆã™ã‚‹ã‚‚ã?ã§ã™ã?
087             * select * from emp where deptno = ? and job = ? ãªã©ã® PreparedQuery ã®
088             * ? 部�?引数�
089             * é ?•ªã«ã‚»ãƒ?ƒˆã—ã¦ã?ã¾ã™ã?
090             *
091             * @og.rev 3.1.1.0 (2003/03/28) åŒæœŸãƒ¡ã‚½ãƒ?ƒ‰(synchronized付ã)ã‚’éžåŒæœŸã«å¤‰æ›´ã™ã‚‹ã€?
092             * @og.rev 3.3.3.1 (2003/07/18) ?¤?¢ç™»éŒ²æ™‚ã?後ã‚スペã?スを削除ã™ã‚‹ã€?
093             * @og.rev 3.5.2.0 (2003/10/20) å†?ƒ¨ã‚ªãƒ–ジェクトタイプåã‚?シスãƒ?ƒ ãƒ‘ラメータ ã§å®šç¾©ã—ã¾ã™ã?
094             * @og.rev 3.5.6.0 (2004/06/18) nullã«å¯¾ã™ã‚‹ç„¡é§?ªæ¯”è¼?‚’削除ã—ã¾ã™ã?
095             * @og.rev 3.8.0.8 (2005/10/03) エラーメãƒ?‚»ãƒ¼ã‚¸ã®å‡ºåŠ›é?をメãƒ?‚»ãƒ¼ã‚¸?‹Queryã«å¤‰æ›´ã—ã¾ã™ã?
096             * @og.rev 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
097             * @og.rev 5.7.2.3 (2014/01/31) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対応ã?ã€Ver5 ã§ã¯è¡Œã‚ãªã?戻ã?ã€?
098             *
099             * @param   keys オブジェクトã?キーé…å?
100             * @param   args オブジェクトã?引数é…å?
101             */
102            @Override
103            public void execute( final String[] keys, final String[] args ) {
104                    CallableStatement callStmt = null ;
105                    try {
106                            Connection conn = getConnection();
107                            callStmt  = getConnection().prepareCall( getStatement() );
108                            callStmt.setQueryTimeout( DB_MAX_QUERY_TIMEOUT );
109                            Map<String,Class<?>> map = conn.getTypeMap();
110                            map.put( ERR_MSG,DBErrMsg.class );      // 4.0.0 (2005/01/31)
111    
112                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?http://docs.oracle.com/cd/E28389_01/web.1111/b60995/thirdparty.htm
113                            ArrayDescriptor sd_key = ArrayDescriptor.createDescriptor( ARG_ARRAY, conn );
114                            ARRAY newArray_key = new ARRAY( sd_key,conn,keys );
115    //                      Array newArray_key = ((OracleConnection)conn).createOracleArray( ARG_ARRAY, keys );             // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
116    
117                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?http://docs.oracle.com/cd/E28389_01/web.1111/b60995/thirdparty.htm
118                            ArrayDescriptor sd_val = ArrayDescriptor.createDescriptor( ARG_ARRAY, conn );
119                            ARRAY newArray_val = new ARRAY( sd_val,conn,StringUtil.rTrims( args ) );
120    //                      Array newArray_val = ((OracleConnection)conn).createOracleArray( ARG_ARRAY, StringUtil.rTrims( args ));         // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
121    
122                            callStmt.registerOutParameter(1, Types.INTEGER);
123                            callStmt.registerOutParameter(2, OracleTypes.ARRAY,ERR_MSG_ARRAY);                      // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
124    //                      callStmt.registerOutParameter(2, Types.ARRAY,ERR_MSG_ARRAY);                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
125                            ((OracleCallableStatement)callStmt).setARRAY( 3,newArray_key );                         // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
126                            ((OracleCallableStatement)callStmt).setARRAY( 4,newArray_val );                         // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
127    //                      callStmt.setArray( 3,newArray_key );                                                                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
128    //                      callStmt.setArray( 4,newArray_val );                                                                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
129    
130                            callStmt.execute();
131    
132                            int rtnCode = callStmt.getInt(1);
133                            setErrorCode( rtnCode );
134                            if( rtnCode > ErrorMessage.OK ) {            // 正常以外ã?å ´å?
135                                    ARRAY rtn3 = ((OracleCallableStatement)callStmt).getARRAY(2);                   // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
136    //                              Array rtn3 = callStmt.getArray(2);                                                                              // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
137                                    Object[] rtnval3 = (Object[])rtn3.getArray();
138                                    ErrorMessage errMessage = new ErrorMessage( "Query_JDBCKeyEntry Error!!" );
139                                    for( int i=0; i<rtnval3.length; i++ ) {
140                                            DBErrMsg er = (DBErrMsg)rtnval3[i];
141                                            if( er == null ) { break; }
142                                            errMessage.addMessage( er.getErrMsg() );
143                                    }
144                                    setErrorMessage( errMessage );
145                            }
146                    }
147                    catch (SQLException ex) {
148                            setErrorCode( ErrorMessage.EXCEPTION );
149                            String errMsg = ex.getMessage() + ":" + ex.getSQLState() + HybsSystem.CR
150                                                    + getStatement() + HybsSystem.CR ;
151                            rollback();
152                            realClose();
153                            throw new HybsSystemException( errMsg,ex );             // 3.5.5.4 (2004/04/15) 引数ã®ä¸¦ã³é ?¤‰æ›´
154                    }
155                    finally {
156                            Closer.stmtClose( callStmt );
157                    }
158            }
159    }