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.common.HybsSystem;
019    import org.opengion.hayabusa.common.HybsSystemException;
020    import org.opengion.hayabusa.db.AbstractQuery;
021    import org.opengion.hayabusa.db.DBErrMsg;
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.util.Map;
027    import java.sql.CallableStatement;
028    import java.sql.Connection;
029    import java.sql.SQLException;
030    import java.sql.Types;
031    import java.sql.Array;                                                          // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対応ã?oracle.sql.ARRAY ã®ç½®ãæ›ã?
032    // import oracle.sql.ARRAY;                                                     // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対応ã?oracle.sql.ARRAY ã®ç½®ãæ›ã?
033    // import oracle.jdbc.OracleTypes;                                      // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対応ã?java.sql.Types ã®ç½®ãæ›ã?
034    
035    // import oracle.jdbc.OracleCallableStatement;          // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
036    
037    /**
038     * Callableã®ã‚¨ãƒ©ãƒ¼é…å?対応版ã§ã™ã?ãƒãƒƒãƒç³»æ¨™æº–ã?PL/SQL をコールã™ã‚‹ Query クラスã§ã™ã?
039     *
040     * java.sql.CallableStatement を用ã?¦ã€ãƒ‡ãƒ¼ã‚¿ãƒ™ã?ス検索処ç?‚’行ã„ã¾ã™ã?
041     * 引数ã¯ã€å¾“æ¥ã®PL/SQLã®å®Ÿè¡ŒãŒå¯èƒ½ãªã‚ˆã†ã«ã€ç¬¬ä¸?¼•æ•°ã¯ã‚¨ãƒ©ãƒ¼ã‚³ãƒ¼ãƒ‰ã?第二引数ã¯ã€?
042     * エラーメãƒ?‚»ãƒ¼ã‚¸ã‚’è¿”ã—ã¦ãã¾ã™ã?第三引数以é™ã?ã€è?ç”±ã«æŒ?®šã§ãã¾ã™ã?
043     * å†?ƒ¨å¤‰æ•°ã®å—ã‘æ¸¡ã—ã?ãƒ?ƒ•ォルト実è£??ã€AbstractQuery クラスを継承ã—ã¦ã?‚‹
044     * ãŸã‚,ã“ã“ã§ã¯ã€execute() メソãƒ?ƒ‰ã‚’実è£?—ã¦ã?¾ã™ã?
045     *
046     * @og.formSample
047     * 例�
048     *     第ä¸?¼•æ•°ã€ç¬¬äºŒå¼•æ•°ã¯ã€??常ã®PL/SQLã¨åŒã˜ã€çµæžœ(STATUS)ã¨
049     *     å†?®¹(ERR_CODE)ã‚’è¿”ã—ã¾ã™ã?
050     *     ãれ以é™ã?引数ã«ã¤ã?¦ã¯ã€å?åŠ?IN)ã®ã¿ã§ã™ãŒã€è?ç”±ã«è¨­å®šã§ãã¾ã™ã?
051     *     引数ã«å¤‰æ•°ã‚’使用ã™ã‚‹å ´åˆã?ã€? 記å·ã‚’当ã¦ã¯ã‚ã¾ã™ã?
052     *     第ä¸?¼•æ•°ã€ç¬¬äºŒå¼•æ•°ã¯ã€äºˆç´?¸ˆã¿ã§ã™ãŒã€ãれ以é™ã?ã€å¥½ããªä½ç½®ã«å‰²ã‚Šå½“ã¦ã‚‰ã‚Œã¾ã™ã?
053     *     names 属æ?ã®é ?•ªã«ã€å?ã?‘ãŒã‚»ãƒ?ƒˆã•れã¦ã?ã¾ã™ã?
054     *     下記ã?例ã?ã€å¤‰æ•°ã®å¼•æ•°ã¯ã€ä½¿ç”¨ã—ã¦ã?¾ã›ã‚“ã€?
055     *
056     * <og:query
057     *     command="NEW"
058     *     queryType="JDBCArrayCallable"
059     *     displayMsg="" >
060     *         { call GEP00002.GEP00002( ?,?,'{@GUI.KEY}','{@USER.ID}' ) }
061     * </og:query>
062     *
063     *    CREATE OR REPLACE PACKAGE GEP00002 AS
064     *        PROCEDURE GEP00002(
065     *            P_STATUS    OUT    NUMBER,
066     *            P_ERR_CODE  OUT    ERR_MSG_ARRAY,
067     *            P_MIDDB     IN     VARCHAR2,
068     *            P_USRUPD    IN     VARCHAR2  );
069     *    END;
070     *
071     * @og.group �?タ表示
072     * @og.group �?タ編�
073     *
074     * @version  4.0
075     * @author   高橋正�
076     * @since    JDK5.0,
077     */
078    public class Query_JDBCArrayCallable extends AbstractQuery {
079            //* ã“ã?プログラãƒ??VERSIONæ–?­—å?を設定ã—ã¾ã™ã?       {@value} */
080            private static final String VERSION = "5.7.2.2 (2014/01/24)" ;
081    
082            /**
083             * クエリーを実行ã—ã¾ã™ã?
084             * ã‚»ãƒ?ƒˆã•れã¦ã?‚‹ã‚¹ãƒ??トメント文字å?ã¨ãã?タイプãŒåˆã£ã¦ã?ªã??åˆã?,
085             * エラーã«ãªã‚Šã¾ã™ã?
086             * å®Ÿè¡Œçµæžœã¯ã€DBTableModel ã«ã‚»ãƒ?ƒˆã•れã¾ã™ã?
087             *
088             */
089            @Override
090            public void execute() {
091                    execute( null );
092            }
093    
094            /**
095             * 引数é…å?付ã?クエリーを実行ã—ã¾ã™ã?
096             * 処ç??体ã?, #execute() ã¨åŒæ§˜ã«ã€å„サブクラスã®å®Ÿè£?«ä¾å­˜ã—ã¾ã™ã?
097             * ã“れã¯ã€PreparedQuery ã§ä½¿ç”¨ã™ã‚‹å¼•æ•°ã‚’é?列ã§ã‚»ãƒ?ƒˆã™ã‚‹ã‚‚ã?ã§ã™ã?
098             * select * from emp where deptno = ? and job = ? ãªã©ã® PreparedQuery ã®
099             * ? 部�?引数�
100             * é ?•ªã«ã‚»ãƒ?ƒˆã—ã¦ã?ã¾ã™ã?
101             *
102             * @og.rev 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
103             *
104             * @param   args オブジェクトã?引数é…å?
105             */
106            @Override
107            public void execute( final String[] args ) {
108                    CallableStatement callStmt = null ;
109                    try {
110                            Connection conn = getConnection();
111                            callStmt  = getConnection().prepareCall( getStatement() );
112                            callStmt.setQueryTimeout( DB_MAX_QUERY_TIMEOUT );
113                            Map<String,Class<?>> map = conn.getTypeMap();
114                            map.put( ERR_MSG,DBErrMsg.class );
115    
116                            // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ?対å¿?
117    //                      ArrayDescriptor sd = ArrayDescriptor.createDescriptor( ARG_ARRAY, conn );
118                            callStmt.registerOutParameter(1, Types.INTEGER);
119    //                      callStmt.registerOutParameter(2, OracleTypes.ARRAY,ERR_MSG_ARRAY);
120                            callStmt.registerOutParameter(2, Types.ARRAY,ERR_MSG_ARRAY);
121                            if( args != null ) {
122                                    for( int i=0; i<args.length; i++ ) {
123                                            callStmt.setObject( i+3,StringUtil.rTrim( args[i] ) );
124                                    }
125                            }
126                            callStmt.execute();
127    
128                            int rtnCode = callStmt.getInt(1);
129                            setErrorCode( rtnCode );
130    
131                            if( rtnCode > ErrorMessage.OK ) {            // 正常以外ã?å ´å?
132                                    // 5.7.2.2 (2014/01/24) Oracle11g(11.2.0.3ã®ãƒ‰ãƒ©ã‚¤ãƒ? 対å¿?
133    //                              ARRAY rtn3 = ((OracleCallableStatement)callStmt).getARRAY(2);
134                                    Array rtn3 = callStmt.getArray(2);
135                                    Object[] rtnval3 = (Object[])rtn3.getArray();
136                                    ErrorMessage errMessage = new ErrorMessage( "Query_JDBCArrayCallable Error!!" );
137                                    for( int i=0; i<rtnval3.length; i++ ) {
138                                            DBErrMsg er = (DBErrMsg)rtnval3[i];
139                                            if( er == null ) { break; }
140                                            errMessage.addMessage( er.getErrMsg() );
141                                    }
142                                    setErrorMessage( errMessage );
143                            }
144                    }
145                    catch ( SQLException ex ) {
146                            setErrorCode( ErrorMessage.EXCEPTION );
147                            String errMsg = ex.getMessage() + ":" + ex.getSQLState() + HybsSystem.CR
148                                                    + getStatement() + HybsSystem.CR;
149                            rollback();
150                            realClose();
151                            throw new HybsSystemException( errMsg,ex );
152                    }
153                    finally {
154                            Closer.stmtClose( callStmt );
155                    }
156            }
157    }