Synopsis

Determines which events are delivered to a subscription.

OMG IDL

Filter create_filter (
in string constraint_grammar)
raises (InvalidGrammar);

Exceptions

Description

Used in the subscriber application to create a new filter object. This filter is used to determine which events are delivered to a subscription. The subscriber must set up the filter and add it to the proxy within five minutes; otherwise, the filter will be destroyed. The filter grammar must be set to Tobj_Notification::Constraint_grammar; otherwise, the InvalidGrammar exception is raised.

Return Value

Returns the new filter's object reference.

Examples

C++ code example:

filter_factory->create_filter(
      Tobj_Notification::CONSTRAINT_GRAMMAR
);

Java code example:

CosNotifyChannelAdmin::StructuredProxyPushSupplier Class

This class is used by event subscriber applications. The OMG IDL for this class is as follows:

Module CosNotifyChannelAdmin
{
 interface StructuredProxyPushSupplier : 
       ProxySupplier,
       CosNotifyComm::StructuredPushSupplier {

    void connect_structured_push_consumer (
           in CosNotifyComm::StructuredPushConsumer push_consumer)
         raises(CosEventChannelAdmin::AlreadyConnected,
                 CosEventChannelAdmin::TypeError );
    };
    // The following operations are inherited.
    void set_qos(in QoSProperties qos) 
         raises (UnsupportedQoS);
    FilterID add_filter (in Filter new_filter );
    Filter get_filter( in FilterID filter )
         raises ( FilterNotFound);
    void disconnect_structured_push_supplier();
    readonly attribute ProxyType     MyType;
  };
}; //CosNotifyChannelAdmin