1 /* ====================================================================
2 * License:
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions
6 * are met:
7 *
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 *
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in
13 * the documentation and/or other materials provided with the
14 * distribution.
15 *
16 * 3. The end-user documentation included with the redistribution,
17 * if any, must include the following acknowledgment:
18 * "This product includes software developed by
19 * Robert Half International (http://www.rhi.com/)."
20 * Alternately, this acknowledgment may appear in the software itself,
21 * if and wherever such third-party acknowledgments normally appear.
22 *
23 * 4. The names "Parc", "RHI", and "Robert Half International" must
24 * not be used to endorse or promote products derived from this
25 * software without prior written permission. For written
26 * permission, please contact pete.mckinstry@rhi.com.
27 *
28 * 5. Products derived from this software may not be called "PARC",
29 * nor may "PARC" appear in their name, without prior written
30 * permission of Robert Half International.
31 *
32 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
33 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
34 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
35 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
36 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
37 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
38 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
39 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
40 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
41 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
42 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
43 * SUCH DAMAGE.
44 * ====================================================================
45 *
46 */
47 package examples;
48
49 import com.rhi.architecture.parc.ProcessingException;
50 import com.rhi.architecture.parc.Record;
51 import com.rhi.architecture.parc.filter.NotificationFilter;
52
53 import java.util.ArrayList;
54 import java.util.Collection;
55 import java.util.Iterator;
56
57 /***
58 * This class is a somewhat degenerate example of a Filter, but it does show how
59 * one would write a Filter. A filter implements a doWork() method that is
60 * passed a set of records from the inbound channel. The Filter should process
61 * the provided records and return the output records as a Collection. The
62 * Filter may transform the records in-place, or it may toss the original
63 * records and create completely new ones. It's entirely up to the Filter.
64 *
65 * @author <a href="mailto:pmckinstry@users.sourceforge.net">Pete McKinstry</a>
66 */
67 public class MyFilter extends NotificationFilter {
68
69 /***
70 * doWork
71 * @param in
72 * @return Collection of output records.
73 * @throws ProcessingException
74 */
75 protected Collection doWork(Collection in) throws ProcessingException {
76 Collection out = new ArrayList();
77
78 Iterator iter = in.iterator();
79 while (iter.hasNext()) {
80 Record originalRecord = (Record)iter.next();
81 Record updatedRecord = null;
82 try {
83 updatedRecord = transform(originalRecord);
84 }
85 catch (Exception e) {
86 // error detected,
87 updatedRecord = originalRecord;
88 updatedRecord.addError(new MyError("Failure in Transformation"));
89 }
90 out.add(updatedRecord);
91 }
92 return out;
93 }
94
95 /***
96 * Potentially transformations of the data could be performed here.
97 *
98 * @param r
99 * @return Record
100 * @throws Exception
101 */
102 private Record transform(Record r) throws Exception {
103 return r;
104 }
105 }
This page was automatically generated by Maven