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