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    }