Filter Calls

The filter clause of the MQL Add Store statement (as well as Modify Store) lets you add a Java class to allow filtering or special processing on the data stream during file check in and check out.

The keyword filter indicates the store has a Java class configured to perform filtering. You can use either the file or the params keywords to provide the parameters as necessary.

add store NAME [filter FILTERCLASS [| file PARAMSFILE    |]] 
                                    | params PARAMSSTRING|;

FILTERCLASS is the name of the Java class that does filtering on the input or output stream. This class must implement the com.matrixone.fcs.fcs.FCSStreamFilter interface.

PARAMSFILE is the name of an XML file containing parameters to pass to the filtering class. See The Parameters File for details.

PARAMSSTRING is a string of XML code containing parameters to pass to the filtering class, as an alternative to using an external PARAMSFILE.

When adding or modifying external stores, you can combine this parameters file with the one that is specified for the Web Service (external) store.

For example:

add store test type captured directory c:\storesDir\ filter 
filterClass file paramsFile.xml

The system verifies the validity of this class at the time the store is configured, thus, the class must be available in the classpath at the time of schema creation.

Note: Filters can only be defined on stores, not on locations.