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.fukurou.process;
017
018 import org.opengion.fukurou.util.Argument;
019 import org.opengion.fukurou.util.HybsEntry ;
020 import org.opengion.fukurou.util.LogWriter;
021
022 import java.util.Map ;
023 import java.util.LinkedHashMap ;
024
025 /**
026 * Process_TableFilter は、上流から受け取ったデータをフィルタするã€?
027 * ChainProcess インターフェースの実è£?‚¯ラスですã?
028 *
029 * 上æµ?プロセスチェインのãƒ??タは上流から下流へと渡されますã?)から
030 * 受け取ったLineModel をå?にã€??目のフィルタリングを行いますã?
031 * 条件がæ?立したå?合ã?、下流に流しますã?è¤?•°の条件を指定できますがã€?
032 * すべて AND で判定されますã?
033 * (設定条件すべてをæº?�Ÿすå?合ã?み、下流にãƒ??タを流しますã?)
034 *
035 * 引数æ–?—å?中にスペã?スを含ã‚??合ã?、ダブルコーãƒ??ション("") で括って下さã�??
036 * 引数æ–?—å?の ã€?』ã?前後には、スペã?スは挟めません。å¿?�šã€?key=value の様に
037 * 繋げてくださいã€?
038 *
039 * @og.formSample
040 * Process_TableFilter
041 *
042 * [ -prefix_XXXX=接頭è¾? ] ?šé?目å�?XXXX)がã?æŒ?®šã?接頭辞で始まるå?合ã?条件成立ã?
043 * [ -suffix_XXXX=接尾è¾? ] ?šé?目å�?XXXX)がã?æŒ?®šã?接尾辞で終わるå?合ã?条件成立ã?
044 * [ -instr_XXXX=部åˆ?–‡字å? ] ?šé?目å�?XXXX)がã?æŒ?®šã?部åˆ?–‡字å?とä¸??する場合ã?条件成立ã?
045 * [ -equals_XXXX=ä¸?? ] ?šé?目å�?XXXX)がã?æ–?—å?とä¸??する場合ã?条件成立ã?"
046 + CR + "æ–?—å?は、大æ–?—小文字ã?区別しませんã€?equalsIgnoreCase)";
047 * [ -match_XXXX=正規表現 ] ?šé?目å�?XXXX)がã?正規表現とä¸??する場合ã?条件成立ã?
048 * [ -unmatch_XXXX=正規表現 ] ?šé?目å�?XXXX)がã?正規表現とä¸??しなã�??合ã?条件成立ã?
049 * [ -const_XXXX=固定å? ] ??const_FGJ=1
050 * é ?›®å�?XXXX)に、固定å?を設定しますã?
051 * [ -replace_XXXX=固定å? ] ??replace_BIKO="YYYY⇒ZZZZ" (å…??æŒ?®šã?、â�çで区åˆ?‚Šますã?)
052 * é ?›®å�?XXXX)のæ–?—å?から、YYYY とã�?�†æ–?—を ZZZZ に置換しますã?
053 * [ -display=false|true ] ?š結果を標準å?力に表示する(true)かしなã�?false)ã�?初期値:false[表示しない])
054 *
055 * @version 4.0
056 * @author Kazuhiko Hasegawa
057 * @since JDK5.0,
058 */
059 public class Process_TableFilter extends AbstractProcess implements ChainProcess {
060 /** replace_ で使用する区åˆ?‚Š記号 {@value} */
061 public static final char REP_SEP = '� ; // 4.3.1.1 (2008/08/24)
062
063 private static final String PREFIX_KEY = "prefix_" ;
064 private static final String SUFFIX_KEY = "suffix_" ;
065 private static final String INSTR_KEY = "instr_" ;
066 private static final String EQUALS_KEY = "equals_" ;
067 private static final String MATCH_KEY = "match_" ;
068 private static final String UNMATCH_KEY = "unmatch_";
069 private static final String CONST_KEY = "const_" ;
070 private static final String REPLACE_KEY = "replace_" ; // 4.3.1.1 (2008/08/24)
071
072 private final LineModelFilter filter = new LineModelFilter();
073
074 private boolean display = false; // 表示しなã�?
075
076 private String[] cnstClm = null; // 固定å?を設定するカラãƒ?��
077 private int[] cnstClmNos = null; // 固定å?を設定するカラãƒ?•ª号
078 private String[] constVal = null; // カラãƒ?•ª号に対応した固定å?
079
080 // 4.3.1.1 (2008/08/24) 置換関係にå¿?¦�なãƒ??タ
081 private String[] repClm = null; // 置換を設定するカラãƒ?��
082 private int[] repClmNos = null; // 置換を設定するカラãƒ?•ª号
083 private String[] repValFrom = null; // カラãƒ?•ª号に対応した置換å?æ–?—å?
084 private String[] repValTo = null; // カラãƒ?•ª号に対応した置換後文字å?
085
086 private boolean firstRow = true; // æœ??のä¸?¡Œ目
087 private int count = 0;
088
089 private static final Map<String,String> mustProparty ; // ?»プロパティ?½å¿??チェãƒ?‚¯用 Map
090 private static final Map<String,String> usableProparty ; // ?»プロパティ?½整合æ?チェãƒ?‚¯ Map
091
092 static {
093 mustProparty = new LinkedHashMap<String,String>();
094
095 usableProparty = new LinkedHashMap<String,String>();
096 usableProparty.put( PREFIX_KEY , "é ?›®å�?XXXX)がã?æŒ?®šã?接頭辞で始まるå?合ã?条件成立ã?" );
097 usableProparty.put( SUFFIX_KEY , "é ?›®å�?XXXX)がã?æŒ?®šã?接尾辞で終わるå?合ã?条件成立ã?" );
098 usableProparty.put( INSTR_KEY , "é ?›®å�?XXXX)がã?æŒ?®šã?部åˆ?–‡字å?とä¸??する場合ã?条件成立ã?" );
099 usableProparty.put( EQUALS_KEY , "é ?›®å�?XXXX)がã?æ–?—å?とä¸??する場合ã?条件成立ã?" +
100 CR + "(大æ–?—小文字ã?区別しなã�?" );
101 usableProparty.put( MATCH_KEY , "é ?›®å�?XXXX)がã?正規表現とä¸??する場合ã?条件成立ã?" );
102 usableProparty.put( UNMATCH_KEY, "é ?›®å�?XXXX)がã?正規表現とä¸??しなã�??合ã?条件成立ã?" );
103 usableProparty.put( CONST_KEY , "é ?›®å�?XXXX)に、固定å?を設定しますã?" );
104 // 4.3.1.1 (2008/08/24) 置換関ä¿?
105 usableProparty.put( REPLACE_KEY , "é ?›®å�?XXXX)のæ–?—å?から、YYYY とã�?�†æ–?—を ZZZZ に置換しますã?" );
106 usableProparty.put( "display" , "結果を標準å?力に表示する(true)かしなã�?false)ã�? +
107 CR + "(初期値:false:表示しなã�?" );
108 }
109
110 /**
111 * ãƒ?ƒ•ォルトコンストラクターã€?
112 * こã?クラスは、動çš?½œæ?されますã?ãƒ?ƒ•ォルトコンストラクターでã€?
113 * super クラスに対して、å¿?¦�な初期化を行っておきますã?
114 *
115 */
116 public Process_TableFilter() {
117 super( "org.opengion.fukurou.process.Process_TableFilter",mustProparty,usableProparty );
118 }
119
120 /**
121 * プロセスの初期化を行いますã?初めにä¸?º¦ã�?�‘、呼び出されますã?
122 * 初期処ç�?ファイルオープンã€?¼¤?¢オープンç?に使用しますã?
123 *
124 * @og.rev 4.3.1.1 (2008/08/24) 置換関係対å¿?
125 *
126 * @param paramProcess ãƒ??タベã?スの接続å?æƒ??などを持ってã�?‚‹オブジェクãƒ?
127 */
128 public void init( final ParamProcess paramProcess ) {
129 Argument arg = getArgument();
130
131 display = arg.getProparty( "display",display );
132
133 HybsEntry[] entry = arg.getEntrys( PREFIX_KEY );
134 for( int i=0; i<entry.length; i++ ) {
135 filter.add( FilterOperation.PREFIX, entry[i].getKey(), entry[i].getValue() );
136 }
137
138 entry = arg.getEntrys( SUFFIX_KEY );
139 for( int i=0; i<entry.length; i++ ) {
140 filter.add( FilterOperation.SUFFIX, entry[i].getKey(), entry[i].getValue() );
141 }
142
143 entry = arg.getEntrys( INSTR_KEY );
144 for( int i=0; i<entry.length; i++ ) {
145 filter.add( FilterOperation.INSTR, entry[i].getKey(), entry[i].getValue() );
146 }
147
148 entry = arg.getEntrys( EQUALS_KEY );
149 for( int i=0; i<entry.length; i++ ) {
150 filter.add( FilterOperation.EQUALS, entry[i].getKey(), entry[i].getValue() );
151 }
152
153 entry = arg.getEntrys( MATCH_KEY );
154 for( int i=0; i<entry.length; i++ ) {
155 filter.add( FilterOperation.MATCH, entry[i].getKey(), entry[i].getValue() );
156 }
157
158 entry = arg.getEntrys( UNMATCH_KEY );
159 for( int i=0; i<entry.length; i++ ) {
160 filter.add( FilterOperation.UNMATCH, entry[i].getKey(), entry[i].getValue() );
161 }
162
163 HybsEntry[] cnstKey = arg.getEntrys( CONST_KEY );
164 int csize = cnstKey.length;
165 cnstClm = new String[csize];
166 constVal = new String[csize];
167 for( int i=0; i<csize; i++ ) {
168 cnstClm[i] = cnstKey[i].getKey();
169 constVal[i] = cnstKey[i].getValue();
170 }
171
172 // 4.3.1.1 (2008/08/24) 置換関ä¿?
173 HybsEntry[] repKey = arg.getEntrys( REPLACE_KEY );
174 int rsize = repKey.length;
175 repClm = new String[rsize];
176 repValFrom = new String[rsize];
177 repValTo = new String[rsize];
178 for( int i=0; i<rsize; i++ ) {
179 repClm[i] = repKey[i].getKey();
180 String val = repKey[i].getValue();
181 if( val != null ) {
182 int ad = val.indexOf( REP_SEP );
183 if( ad >= 0 ) {
184 repValFrom[i] = val.substring( 0,ad );
185 repValTo[i] = val.substring( ad+1 );
186 }
187 else {
188 repValFrom[i] = val;
189 repValTo[i] = "";
190 }
191 }
192 }
193 }
194
195 /**
196 * 引数の LineModel をå?ç�?�™るメソãƒ?ƒ‰ですã?
197 * 変換処ç�?¾Œã? LineModel を返しますã?
198 * 後続å?ç�?‚’行わなã�??å�?ãƒ??タのフィルタリングを行う場å�?はã€?
199 * null ãƒ??タを返しますã?つまりã?null ãƒ??タは、後続å?ç�?‚’行わなã�?
200 * フラグの代わりにも使用してã�?�¾すã?
201 * なおã?変換処ç�?¾Œã? LineModel と、オリジナルの LineModel がã?
202 * 同ä¸?�‹、コピã?(クローン)かã?、各処ç�?ƒ¡ソãƒ?ƒ‰å†?�§決めてã�?�¾すã?
203 * ドキュメントに明記されてã�?�ªã�??合ã?、副作用が問題になるå?合ã?ã€?
204 * å�??ç�?�”とに自åˆ?�§コピã?(クローン)して下さã�??
205 *
206 * @og.rev 4.3.1.1 (2008/08/24) 置換関係対å¿?
207 *
208 * @param data オリジナルのLineModel
209 *
210 * @return 処ç�?¤‰換後ã?LineModel
211 */
212 public LineModel action( final LineModel data ) {
213 count++ ;
214
215 // if( display ) { println( data.dataLine() ); }
216
217 if( !filter.filter( data ) ) {
218 return null; // 不ä¸??
219 }
220
221 if( firstRow ) {
222 int csize = cnstClm.length;
223 cnstClmNos = new int[csize];
224 for( int i=0; i<csize; i++ ) {
225 cnstClmNos[i] = data.getColumnNo( cnstClm[i] );
226 }
227
228 // 4.3.1.1 (2008/08/24) 置換関係対å¿?
229 int rsize = repClm.length;
230 repClmNos = new int[rsize];
231 for( int i=0; i<rsize; i++ ) {
232 repClmNos[i] = data.getColumnNo( repClm[i] );
233 }
234
235 firstRow = false;
236 }
237
238 for( int i=0; i<cnstClm.length; i++ ) {
239 data.setValue( cnstClmNos[i],constVal[i] );
240 }
241
242 // 4.3.1.1 (2008/08/24) 置換関係対å¿?
243 for( int i=0; i<repClm.length; i++ ) {
244 String val = String.valueOf( data.getValue( repClmNos[i] ) );
245 if( val != null ) {
246 val = val.replaceAll( repValFrom[i],repValTo[i] );
247 data.setValue( repClmNos[i],val );
248 }
249 }
250
251 if( display ) { println( data.dataLine() ); } // 5.1.2.0 (2010/01/01) display の条件変更
252 return data;
253 }
254
255 /**
256 * プロセスの終äº?‚’行いますã?æœ?¾Œにä¸?º¦ã�?�‘、呼び出されますã?
257 * 終äº??ç�?ファイルクローズã€?¼¤?¢クローズç?に使用しますã?
258 *
259 * @og.rev 4.3.1.1 (2008/08/24) 置換関係対å¿?
260 *
261 * @param isOK トã?タルで、OKã�?�£たかどã�?�‹[true:成功/false:失敗]
262 */
263 public void end( final boolean isOK ) {
264 cnstClm = null; // 固定å?を設定するカラãƒ?��
265 cnstClmNos = null; // 固定å?を設定するカラãƒ?•ª号
266 constVal = null; // カラãƒ?•ª号に対応した固定å?
267
268 repClm = null; // 置換を設定するカラãƒ?��
269 repClmNos = null; // 置換を設定するカラãƒ?•ª号
270 repValFrom = null; // カラãƒ?•ª号に対応した置換å?æ–?—å?
271 repValTo = null; // カラãƒ?•ª号に対応した置換後文字å?
272 }
273
274 /**
275 * プロセスの処ç�?µ�果のレポã?ト表現を返しますã?
276 * 処ç�??ログラãƒ?��、å?力件数、å?力件数などのæƒ??ですã?
277 * こã?æ–?—å?をそのまま、標準å?力に出すことで、結果レポã?トと出来るよã�?�ª
278 * 形式で出してくださいã€?
279 *
280 * @return 処ç�?µ�果のレポã?ãƒ?
281 */
282 public String report() {
283 String report = "[" + getClass().getName() + "]" + CR
284 + TAB + "Model Filter : " + filter + CR
285 + TAB + "Output Count : " + count ;
286
287 return report ;
288 }
289
290 /**
291 * こã?クラスの使用方法を返しますã?
292 *
293 * @return こã?クラスの使用方æ³?
294 */
295 public String usage() {
296 StringBuilder buf = new StringBuilder();
297
298 buf.append( "Process_TableFilter は、上流から受け取ったデータをフィルタするã€? ).append( CR );
299 buf.append( "ChainProcess インターフェースの実è£?‚¯ラスですã?" ).append( CR );
300 buf.append( CR );
301 buf.append( "上æµ?プロセスチェインのãƒ??タは上流から下流へと渡されますã?)から" ).append( CR );
302 buf.append( "受け取ったLineModel をå?にã€??目のフィルタリングを行いますã?" ).append( CR );
303 buf.append( "条件がæ?立したå?合ã?、下流に流しますã?è¤?•°の条件を指定できますがã€? ).append( CR );
304 buf.append( "すべて AND で判定されますã?" ).append( CR );
305 buf.append( "(設定条件すべてをæº?�Ÿすå?合ã?み、下流にãƒ??タを流しますã?)" ).append( CR );
306 buf.append( CR );
307 buf.append( "引数æ–?—å?中に空白を含ã‚??合ã?、ダブルコーãƒ??ション(\"\") で括って下さã�??" ).append( CR );
308 buf.append( "引数æ–?—å?の ã€?』ã?前後には、空白は挟めません。å¿?�šã€?key=value の様に" ).append( CR );
309 buf.append( "繋げてくださいã€? ).append( CR );
310 buf.append( CR ).append( CR );
311 buf.append( getArgument().usage() ).append( CR );
312
313 return buf.toString();
314 }
315
316 /**
317 * こã?クラスは、main メソãƒ?ƒ‰から実行できませんã€?
318 *
319 * @param args コマンド引数配å?
320 */
321 public static void main( final String[] args ) {
322 LogWriter.log( new Process_TableFilter().usage() );
323 }
324 }