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.hayabusa.taglib;
017
018 import org.opengion.hayabusa.common.HybsSystem;
019 import org.opengion.hayabusa.common.HybsSystemException;
020 import org.opengion.fukurou.util.HybsEntry;
021
022 import org.opengion.fukurou.util.StringUtil ;
023 import static org.opengion.fukurou.util.StringUtil.nval ;
024
025 /**
026 * WriteTableTag にパラメーターを渡す為のタグクラスです?
027 *
028 * writeTable タグに対して、EXEC_SQL ????tableName??を付加することができます?
029 * WriteTable の、writerClass によって、使用できるキーが異なります?
030 * writerClass="XML"
031 * ??TableName ?XML 形式? ROWSET の table 属?になります?
032 * ??First ?最初に記載して、?期????タクリア?を実行させる、EXEC_SQL ??になります?
033 * ??Last ?最後に記載して??目の設?整合?登録)を行う、EXEC_SQL ??になります?
034 * ??MergeSql ?このSQL? UPDATEして、結果が0件ならINSERTを行う、MERGE_SQL ??になります?
035 * writerClass="JSON"
036 * ??JsonName ?JSON形式で??列をオブジェクトとしてまとめる場合に使?す?
037 * ??LowerCase ?カラ?(=パラメータ?を小文字にする場合?true をセ?しま?初期値:false)?
038 * writerClass="CalcDef"
039 * ??Size ?レコード???タ件数(初期値:25)
040 *
041 * 値は、value 属?で?するか、なければ BODY 部に記述します?
042 *
043 * tableName??は、XMLファイルのROWSET属?にセ?することで、XMLファイルの登録??ブル名を
044 * ?することができます?
045 * EXEC_SQL ??とは、タブ区?ファイルやXML形式ファイルの先?(key="First")
046 * また?、最?key="Last")に、SQL?記述することで、ファイル取り込み時?
047 * 前???後??処?る為の??です?
048 * key="MergeSql" で、MERGE_SQL ??をセ?できます?MERGE_SQL を登録すると?
049 * そ?SQL?、UPDATEして、結果が0件ならINSERTを行います?
050 *
051 * こ???は、?件登録できるため??常の writeTable タグに属?を追?ると?
052 * ?になるため??登録できる用に、?部にタグを持てる構?にします?
053 *
054 * @og.formSample
055 * ●形式?
056 * <og:writeTableParam key="[First|Last|TableName]" >
057 * delete from GE12 where SYSTEM_ID='**' and KBSAKU='0'
058 * </og:writeTableParam
059 *
060 * ●body?あ?EVAL_BODY_BUFFERED:BODYを評価し?{@XXXX} を解析しま?
061 *
062 * ●Tag定義??
063 * <og:writeTableParam
064 * key ○?TAG】パラメータとして渡すキー??([First|Last|MergeSql|TableName|Size|JsonName|LowerCase])を指定しま(??)?
065 * value 【TAG】パラメータとして渡す設定?を指定しま?初期値:null)
066 * caseKey 【TAG】このタグ自体を利用するかど?の条件キーを指定しま?初期値:null)
067 * caseVal 【TAG】このタグ自体を利用するかど?の条件値を指定しま?初期値:null)
068 * caseNN 【TAG】指定?値が?null/ゼロ?? でな???Not Null=NN)は、このタグは使用されま?初期値:true)
069 * caseNull 【TAG】指定?値が?null/ゼロ?? の場合?、このタグは使用されま?初期値:true)
070 * debug 【TAG】デバッグ??を?力するかど?[true/false]を指定しま?初期値:false)
071 * > ... Body ...
072 * </og:writeTableParam>
073 *
074 * ●使用?
075 * <og:writeTable ????? >
076 * <og:writeTableParam
077 * key = "Tablename" value="GE12"
078 * />
079 * <og:writeTableParam
080 * key = "First" First:??に登録
081 * >
082 * insert into GE12bk
083 * select * from GE12
084 * where SYSTEM_ID='**'
085 * </og:writeTableParam
086 * <og:writeTableParam
087 * key = "First" First:の?番目に登録
088 * >
089 * delete from GE12 where SYSTEM_ID='**' and KBSAKU='0'
090 * </og:writeTableParam
091 * <og:writeTableParam
092 * key = "Last" Last:?に登録
093 * >
094 * update GE12 set XXXX='YYYY' where SYSTEM_ID='**' and KBSAKU='0'
095 * </og:writeTableParam
096 * </og:writeTableParam
097 *
098 * @og.rev 4.0.0.0 (2005/01/31) 新規作?
099 * @og.rev 5.6.6.1 (2013/07/12) MERGE_SQL 対?
100 * @og.group ファイル出?
101 *
102 * @version 4.0
103 * @author Kazuhiko Hasegawa
104 * @since JDK5.0,
105 */
106 public class WriteTableParamTag extends CommonTagSupport {
107 //* こ?プログラ??VERSION??を設定します? {@value} */
108 private static final String VERSION = "5.6.6.1 (2013/07/12)" ;
109
110 private static final long serialVersionUID = 566120130712L ;
111
112 // private static final String[] KEY_LIST = new String[] { "First","Last","TableName" };
113 // private static final String[] KEY_LIST = new String[] { "First","Last","TableName","Size" }; // 5.1.6.0 (2010/05/01)
114 // private static final String[] KEY_LIST = new String[] { "First","Last","TableName","Size","JsonName","LowerCase" }; // 5.6.0.3 (2012/01/24)
115 private static final String[] KEY_LIST = new String[] { "First","Last","MergeSql|","TableName","Size","JsonName","LowerCase" }; // 5.6.6.1 (2013/07/12)
116
117 private String key = null; // "First","Last","MergeSql|","TableName","Size","JsonName","LowerCase" のどれか
118 private String value = null ; // 実行するSQL??
119
120 /**
121 * Taglibの開始タグが見つかったときに処??doStartTag() ?オーバ?ライドします?
122 *
123 * @og.rev 5.6.6.1 (2013/07/12) caseKey 、caseVal 属?対?
124 *
125 * @return 後続????
126 */
127 @Override
128 public int doStartTag() {
129 // 5.6.6.1 (2013/07/12) caseKey 、caseVal 属?対?
130 if( useTag() ) {
131 if( value == null ) { return( EVAL_BODY_BUFFERED ); } // Body を評価する? extends BodyTagSupport ?
132 // if( value != null ) {
133 // return(SKIP_BODY); // Body を評価しな?
134 // }
135 // else {
136 // return( EVAL_BODY_BUFFERED ); // Body を評価する? extends BodyTagSupport ?
137 // }
138 }
139 return ( SKIP_BODY ); // Body を評価しな?
140 }
141
142 /**
143 * Taglibのタグ本体を処??doAfterBody() ?オーバ?ライドします?
144 *
145 * @return 後続????(SKIP_BODY)
146 */
147 @Override
148 public int doAfterBody() {
149 value = getBodyString().trim();
150 return(SKIP_BODY);
151 }
152
153 /**
154 * Taglibの終?グが見つかったときに処??doEndTag() ?オーバ?ライドします?
155 *
156 * @og.rev 5.6.6.1 (2013/07/12) caseKey 、caseVal 属?対?
157 *
158 * @return 後続????
159 */
160 @Override
161 public int doEndTag() {
162 debugPrint(); // 4.0.0 (2005/02/28)
163 // 5.6.6.1 (2013/07/12) caseKey 、caseVal 属?対?
164 if( useTag() ) {
165 WriteTableTag writeTable = (WriteTableTag)findAncestorWithClass( this,WriteTableTag.class );
166 if( writeTable == null ) {
167 // String errMsg = "<b>こ?タグは、WriteTableTagの??(要?に記述してください?/b>";
168 String errMsg = "<b>" + getTagName() + "タグは、WriteTableTagの??(要?に記述してください?/b>";
169 throw new HybsSystemException( errMsg );
170 }
171
172 writeTable.addParam( new HybsEntry( key,value ) );
173 }
174 return(EVAL_PAGE);
175 }
176
177 /**
178 * タグリブオブジェクトをリリースします?
179 * キャ?ュされて再利用される?で、フィールド?初期設定を行います?
180 *
181 */
182 @Override
183 protected void release2() {
184 super.release2(); // 3.5.6.0 (2004/06/18) 追?抜けて?)
185 key = null; // KEY_LIST のどれか
186 value = null ; // 実行するSQL??
187 }
188
189 /**
190 * 【TAG】パラメータとして渡すキー??([First|Last|MergeSql||TableName|Size|JsonName|LowerCase])を指定しま?
191 *
192 * @og.tag
193 * WriteTable に渡すパラメータのキー??です?
194 * writerClass によって、使用できるキーが異なります?
195 * writerClass="XML"
196 * ??TableName ?XML 形式? ROWSET の table 属?になります?
197 * ??First ?最初に記載して、?期????タクリア?を実行させる、EXEC_SQL ??になります?
198 * ??Last ?最後に記載して??目の設?整合?登録)を行う、EXEC_SQL ??になります?
199 * ??MergeSql ?このSQL? UPDATEして、結果が0件ならINSERTを行う、MERGE_SQL ??になります?
200 * writerClass="JSON"
201 * ??JsonName ?JSON形式で??列をオブジェクトとしてまとめる場合に使?す?
202 * ??LowerCase ?カラ?(=パラメータ?を小文字にする場合?true をセ?しま?初期値:false)?
203 * writerClass="CalcDef"
204 * ??Size ?レコード???タ件数(初期値:25)
205 *
206 * 値は、value 属?で?するか、なければ BODY 部に記述します?
207 *
208 * @param prmKey パラメータとして渡すキー??([First|Last|MergeSql||TableName|Size|JsonName|LowerCase])
209 */
210 public void setKey( final String prmKey ) {
211 key = nval( getRequestParameter( prmKey ),key );
212 if( ! check( key, KEY_LIST ) ) {
213 String errMsg = "??値は、セ?できません。key=[" + key + "]" + HybsSystem.CR
214 + "次の中から?してください?" + StringUtil.array2csv( KEY_LIST ) + ")" ;
215 throw new HybsSystemException( errMsg );
216 }
217 }
218
219 /**
220 * 【TAG】パラメータとして渡す設定?を指定しま?初期値:null)?
221 *
222 * @og.tag
223 * WriteTable に渡すパラメータの設定?です?
224 * First と Last を指定した?合?、XML 形式で出力す?EXEC_SQL ??になります?
225 * TableName の場合?、XML 形式? ROWSET の table 属?になります?
226 * 値は、value 属?で?するか、なければ BODY 部に記述します?
227 * BODY 部に記述された?合?、文字??trim() します?
228 * 設定?は、value 属?が優先です?ここの値が?null の場合??
229 * BODY 要?値として使用します?
230 *
231 * @param val パラメータとして渡す設定?
232 */
233 public void setValue( final String val ) {
234 value = nval( getRequestParameter( val ),value );
235 }
236
237 /**
238 * こ?オブジェクト???表現を返します?
239 * 基本???目?使用します?
240 *
241 * @return こ?クラスの??表現
242 */
243 @Override
244 public String toString() {
245 return org.opengion.fukurou.util.ToString.title( this.getClass().getName() )
246 .println( "VERSION" ,VERSION )
247 .println( "key" ,key )
248 .println( "value" ,value )
249 .println( "KEY_LIST" ,KEY_LIST )
250 .println( "Other..." ,getAttributes().getAttribute() )
251 .fixForm().toString() ;
252 }
253 }