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.column;
017
018// import org.opengion.hayabusa.common.HybsSystem;
019import org.opengion.hayabusa.db.AbstractRenderer;
020import org.opengion.hayabusa.db.CellRenderer;
021import org.opengion.hayabusa.db.DBColumn;
022// import org.opengion.fukurou.util.StringFormat;
023// import org.opengion.fukurou.db.ApplicationInfo;
024// import org.opengion.fukurou.db.DBUtil;
025
026/**
027 * QUERY レンデラーは、表示パラメータで指定された SQL文の実行結果を表示する
028 * クラスで、元のValue を、$1 として使用可能です。
029 * 又、$Cで自身のカラム名が使用可能です。
030 *
031 * ここでは、AAA:BBB:CCC:DDD という値を、$1,$2,$3,$4 に割り当てなおして、
032 * QUERYを実行します。また、$1 は、本来の値として、メニューの初期値設定等に
033 * 使用します。上記の例では、AAA が値で、それ以降は、引数になります。
034 * さらに、元の文字列"AAA:BBB:CCC:DDD"は、$0 に割り当てられます。割り当てがない
035 * 変数は、""(ゼロ文字列)として、扱われます。
036 * 又、$Cには自分自身のカラム名を割り当てます。
037 *
038 *  カラムの表示に必要な属性は、DBColumn オブジェクト より取り出します。
039 * このクラスは、DBColumn オブジェクト毎に1つ作成されます。
040 *
041 * @og.rev 2.1.1.1 (2002/11/15) QUERY レンデラーを新規追加しました。
042 * @og.rev 8.5.7.0 (2024/03/29) QueryFormat を使用して共通部分の処理を行う。
043 * @og.group データ表示
044 *
045 * @version  4.0
046 * @author   Kazuhiko Hasegawa
047 * @since    JDK5.0,
048 */
049public class Renderer_QUERY extends AbstractRenderer {
050        /** このプログラムのVERSION文字列を設定します。   {@value} */
051        private static final String VERSION = "8.5.7.0 (2024/03/29)" ;
052
053        // 8.5.7.0 (2024/03/29) QueryFormat を使用して共通部分の処理を行う。
054//      private final String query ;
055//      private final String dbid ;
056        private final String name ;                                     // 4.3.4.0 (2008/12/01)
057        private final QueryFormat queryFormat;          // 8.5.7.0 (2024/03/29)
058
059//      /** コネクションにアプリケーション情報を追記するかどうか指定 */
060//      public static final boolean USE_DB_APPLICATION_INFO  = HybsSystem.sysBool( "USE_DB_APPLICATION_INFO" ) ;
061
062//      /** 3.8.7.0 (2006/12/15) アクセスログ取得の為、ApplicationInfoオブジェクトを設定 */
063//      private final ApplicationInfo appInfo;
064//      private static final String SYSTEM_ID  = HybsSystem.sys( "SYSTEM_ID" ) ;
065
066        /**
067         * デフォルトコンストラクター。
068         * このコンストラクターで、基本オブジェクトを作成します。
069         *
070         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
071         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為、ApplicationInfoオブジェクトを設定
072         *
073         */
074        public Renderer_QUERY() {
075                super();                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
076                queryFormat = new QueryFormat();                // 8.5.7.0 (2024/03/29)
077//              query   = null;
078//              dbid    = null;
079//              appInfo = makeApplicationInfo( null );
080                name    = null; // 4.3.4.0 (2008/12/01)
081        }
082
083        /**
084         * DBColumnオブジェクトを指定したprivateコンストラクター。
085         *
086         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
087         * @og.rev 3.4.0.0 (2003/09/01) 表示パラメータ、編集パラメータ、文字パラメータの追加。
088         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為、ApplicationInfoオブジェクトを設定
089         * @og.rev 8.5.7.0 (2024/03/29) QueryFormat を使用して共通部分の処理を行う。
090         *
091         * @param       clm     DBColumnオブジェクト
092         */
093        private Renderer_QUERY( final DBColumn clm ) {
094                super();                // 6.4.1.1 (2016/01/16) PMD refactoring. It is a good practice to call super() in a constructor
095                name  = clm.getName();
096                queryFormat = new QueryFormat( clm.getRendererParam(),clm.getDbid(),name );
097//              query = clm.getRendererParam();
098//              dbid  = clm.getDbid();
099//              appInfo = makeApplicationInfo( clm.getName() );
100        }
101
102//      /**
103//       * アクセスログ取得の為、ApplicationInfoオブジェクトを作成します。
104//       *
105//       * @og.rev 3.8.7.0 (2006/12/15) 新規作成
106//       * @og.rev 8.5.7.0 (2024/03/29) QueryFormat を使用して共通部分の処理を行う。
107//       *
108//       * @param       name    オブジェクト
109//       *
110//       * @return      ApplicationInfoオブジェクト
111//       */
112//      private ApplicationInfo makeApplicationInfo( final String name ) {
113//              // 6.3.9.1 (2015/11/27) Found 'DD'-anomaly for variable(PMD)
114//              final ApplicationInfo infoTemp ;
115//
116//              // 3.8.7.0 (2006/12/15) アクセスログ取得の為、ApplicationInfoオブジェクトを設定
117//              if( USE_DB_APPLICATION_INFO ) {
118//                      infoTemp = new ApplicationInfo();
119//                      // ユーザーID,IPアドレス,ホスト名
120//                      infoTemp.setClientInfo( SYSTEM_ID,HybsSystem.HOST_ADRS,HybsSystem.HOST_NAME );
121//                      // 画面ID,操作,プログラムID
122//                      infoTemp.setModuleInfo( "Renderer_QUERY",null,name );
123//              }
124//              else {
125//                      infoTemp = null;                                // 6.3.9.1 (2015/11/27)
126//              }
127//
128//              return infoTemp ;
129//      }
130
131        /**
132         * 各オブジェクトから自分のインスタンスを返します。
133         * 自分自身をキャッシュするのか、新たに作成するのかは、各サブクラスの実装に
134         * まかされます。
135         *
136         * @og.rev 3.1.1.1 (2003/04/03) 各オブジェクトから自分のインスタンスを返すファクトリメソッドを追加。
137         * @og.rev 3.1.2.1 (2003/04/10) synchronized を、削除します。
138         *
139         * @param       clm     DBColumnオブジェクト
140         *
141         * @return      CellRendererオブジェクト
142         * @og.rtnNotNull
143         */
144        public CellRenderer newInstance( final DBColumn clm ) {
145                return new Renderer_QUERY( clm );
146        }
147
148        /**
149         * データの表示用文字列を返します。
150         *
151         * ここでは、AAA:BBB:CCC:DDD という値を、$1,$2,$3,$4 に割り当てなおして、
152         * QUERYを実行します。また、$1 は、本来の値として、メニューの初期値設定等に
153         * 使用します。上記の例では、AAA が値で、それ以降は、引数になります。
154         * さらに、元の文字列"AAA:BBB:CCC:DDD"は、$0 に割り当てられます。割り当てがない
155         * 変数は、""(ゼロ文字列)として、扱われます。
156         * 又、$Cには自分自身のカラム名を割り当てます。
157         *
158         * @og.rev 3.4.0.2 (2003/09/05) AAA:BBB:CCC:DDD という値を、$1,$2,$3,$4 に割り当てます。
159         * @og.rev 3.8.7.0 (2006/12/15) アクセスログ取得の為、ApplicationInfoオブジェクトを設定
160         * @og.rev 4.3.4.0 (2008/12/01) $C対応
161         * @og.rev 5.7.9.0 (2014/08/08) DBUtil.dbExecute 実行時エラーを回避
162         *
163         * @param   value 入力値
164         *
165         * @return  データの表示用文字列
166         * @og.rtnNotNull
167         */
168        @Override
169        public String getValue( final String value ) {
170                return queryFormat.getValue( value );
171//
172//              // StringFormat format = new StringFormat( query,value );
173//              final StringFormat format = new StringFormat( query, value, name ); // 4.3.4.0 (2008/12/01)
174//              final String str = format.format();
175//
176//              // 5.7.9.0 (2014/08/08) DBUtil.dbExecute 実行時エラーを回避
177////            String rtnVal = value == null ? "" : value ;            // 本来、QUERYで変換すべきだが、元の値を設定する。
178//              // 8.5.6.1 (2024/03/29) Editor_QUERY と同様に、先頭の $1 を初期値にします。
179//              String rtnVal = StringFormat.getValue( value ) ;                                                // 6.4.5.3 (2016/05/13) 本来、QUERYで変換すべきだが、元の値を設定する。
180//              try {
181//                      final String[][] rtn = DBUtil.dbExecute( str,null,appInfo,dbid );
182//                      rtnVal = rtn == null || rtn[0] == null || rtn[0][0] == null ? "" : rtn[0][0];                   // 6.4.2.1 (2016/02/05) PMD refactoring. Useless parentheses.
183//              }
184//              catch( final RuntimeException ex ) {
185//                      final String errMsg = "SQL文の処理に失敗しました。" + CR
186//                                                              + "query=" + query + " , inValue=" + value + " , name=" + name
187//                                                              + CR
188//                                                              + ex.getMessage() ;
189//                      System.err.println( errMsg );
190//              }
191//
192//              return rtnVal ;
193        }
194}