org.omg.CosNotifyFilter
Interface FilterFactoryOperations

All Known Subinterfaces:
FilterFactory
All Known Implementing Classes:
_FilterFactoryStub, FilterFactoryImpl, FilterFactoryPOA, FilterFactoryPOATie

public interface FilterFactoryOperations

The FilterFactory interface defines operations for creating filter objects.


Method Summary
 Filter create_filter(java.lang.String constraint_grammar)
          The create_filter operation is responsible for creating a new forwarding filter object.
 MappingFilter create_mapping_filter(java.lang.String constraint_grammar, org.omg.CORBA.Any default_value)
          The create_mapping_filter operation is responsible for creating a new mapping filter object.
 

Method Detail

create_filter

Filter create_filter(java.lang.String constraint_grammar)
                     throws InvalidGrammar
The create_filter operation is responsible for creating a new forwarding filter object. It takes as input a string parameter which identifies the grammar in which constraints associated with this filter will have meaning. If the client invoking this operation supplies as input the name of a grammar that is not supported by any forwarding filter implementation this factory is capable of creating, the InvalidGrammar exception is raised. Otherwise, the operation returns the reference to an object supporting the Filter interface, which can subsequently be configured to support constraints in the appropriate grammar.

Parameters:
constraint_grammar - Language of filter's constraints
Returns:
THe new filter
Throws:
InvalidGrammar - The specified grammar is not valid

create_mapping_filter

MappingFilter create_mapping_filter(java.lang.String constraint_grammar,
                                    org.omg.CORBA.Any default_value)
                                    throws InvalidGrammar
The create_mapping_filter operation is responsible for creating a new mapping filter object. It takes as input a string parameter which identifies the grammar in which constraints associated with this filter will have meaning, and an Any which will be set as the default_value of the newly created mapping filter. If the client invoking this operation supplies as input the name of a grammar that is not supported by any mapping filter implementation this factory is capable of creating, the InvalidGrammar exception is raised. Otherwise, the operation returns the reference to an object supporting the MappingFilter interface, which can subsequently be configured to support constraints in the appropriate grammar, along with their associated mapping values.

Parameters:
constraint_grammar - Language of filter's constraints
Returns:
The new Mapping Filter
Throws:
InvalidGrammar - The specified grammar is not valid