1CosNotifyFilter_Filter(3) Erlang Module Definition CosNotifyFilter_Filter(3)
2
6 CosNotifyFilter_Filter - This module implements the OMG CosNotifyFil‐
7 ter::Filter interface.
8
10 To get access to the record definitions for the structures use:
11 -include_lib("cosNotification/include/*.hrl").
12
14 _get_constraint_grammar(Filter) -> Grammar
15 Types:
17 Filter = #objref
19 Grammar = string()
20 This operation returns which type of Grammar the Filter uses.
22 Currently, only "EXTENDED_TCL" is supported.
23 add_constraints(Filter, ConstraintExpSeq) -> Reply
25 Types:
27 Filter = #objref
29 ConstraintExpSeq = [Constraint]
30 ConstraintExp = #'CosNotifyFilter_ConstraintExp'{event_types,
31 constraint_expr}
32 event_types = #'CosNotification_EventTypeSeq'{}
33 constraint_expr = string()
34 Reply = ConstraintInfoSeq | {'EXCEPTION', #'CosNotifyFil‐
35 ter_InvalidConstraint'{constr}}
36 constr = ConstraintExp
37 ConstraintInfoSeq = [ConstraintInfo]
38 ConstraintInfo = #'CosNotifyFilter_ConstraintInfo'{con‐
39 straint_expression, constraint_id}
40 constraint_expression = ConstraintExp
41 constraint_id = long()
42 Initially, Filters do not contain any constraints, hence, all
44 events will be forwarded. The add_constraints/2 operation allow
45 us to add constraints to the target object.
46 modify_constraints(Filter, ConstraintIDSeq, ConstraintInfoSeq) -> Reply
48 Types:
50 Filter = #objref
52 ConstraintIDSeq = [ConstraintID]
53 ConstraintID = long()
54 ConstraintInfoSeq = [ConstraintInfo]
55 ConstraintInfo = #'CosNotifyFilter_ConstraintInfo'{con‐
56 straint_expression, constraint_id}
57 constraint_expression = ConstraintExp
58 constraint_id = long()
59 Reply = ok | {'EXCEPTION', #'CosNotifyFilter_InvalidCon‐
60 straint'{constr}} | {'EXCEPTION', #'CosNotifyFilter_Con‐
61 straintNotFound'{id}}
62 constr = ConstraintExp
63 id = long()
64 ConstraintExp = #'CosNotifyFilter_ConstraintExp'{event_types,
65 constraint_expr}
66 event_types = #'CosNotification_EventTypeSeq'{}
67 constraint_expr = string()
68 This operation is invoked by a client in order to modify the
70 constraints associated with the target object. The constraints
71 related to the Id's in the parameter sequence ConstraintIDSeq
72 will, if all values are valid, be deleted. The ConstraintInfoSeq
73 parameter contains of Id-Expression pairs and a constraint
74 matching one of the unique Id's will, if all input values are
75 correct, be updated. If the parameters contain incorrect data en
76 exception will be raised.
77 get_constraints(Filter, ConstraintIDSeq) -> Reply
79 Types:
81 Filter = #objref
83 ConstraintIDSeq = [ConstraintID]
84 ConstraintID = long()
85 Reply = ConstraintInfoSeq | {'EXCEPTION', #'CosNotifyFil‐
86 ter_ConstraintNotFound'{id}}
87 ConstraintInfoSeq = [ConstraintInfo]
88 ConstraintInfo = #'CosNotifyFilter_ConstraintInfo'{con‐
89 straint_expression, constraint_id}
90 constraint_expression = ConstraintExp
91 constraint_id = id = long()
92 This operation return a sequence of ConstraintInfo's, related to
94 the given ConstraintID's, associated with the target object.
95 get_all_constraints(Filter) -> ConstraintInfoSeq
97 Types:
99 Filter = #objref
101 ConstraintInfoSeq = [ConstraintInfo]
102 ConstraintInfo = #'CosNotifyFilter_ConstraintInfo'{con‐
103 straint_expression, constraint_id}
104 constraint_expression = ConstraintExp
105 constraint_id = long()
106 All constraints, and their unique Id, associated with the target
108 object will be returned by this operation.
109 remove_all_constraints(Filter) -> ok
111 Types:
113 Filter = #objref
115 All constraints associated with the target object are removed by
117 this operation and, since the the target object no longer con‐
118 tain any constraints, true will always be the result of any
119 match operation.
120 destroy(Filter) -> ok
122 Types:
124 Filter = #objref
126 This operation terminates the target object.
128 match(Filter, Event) -> Reply
130 Types:
132 Filter = #objref
134 Event = #any
135 Reply = boolean() | {'EXCEPTION', #'CosNotifyFilter_Unsup‐
136 portedFilterableData'{}}
137 This operation accepts an #any{} event and returns true if it
139 satisfies at least one constraint. If the event contains data of
140 the wrong type, e.g., should be a string() but in fact i a
141 short(), an exception is raised.
142 match_structured(Filter, Event) -> Reply
144 Types:
146 Filter = #objref
148 Event = #'CosNotification_StructuredEvent'{}
149 Reply = boolean() | {'EXCEPTION', #'CosNotifyFilter_Unsup‐
150 portedFilterableData'{}}
151 This operation is similar to the match operation but accepts
153 structured events instead.
154 attach_callback(Filter, NotifySubscribe) -> CallbackID
156 Types:
158 Filter = #objref
160 NotifySubscribe = #objref
161 CallbackID = long()
162 This operation connects a NotifySubscribe object, which should
164 be informed when the target object's constraints are updated. A
165 unique Id is returned which must be stored if we ever want to
166 detach the callback object in the future.
167 detach_callback(Filter, CallbackID) -> Reply
169 Types:
171 Filter = #objref
173 CallbackID = long()
174 Reply = ok | {'EXCEPTION', #'CosNotifyFilter_CallbackNot‐
175 Found'{}}
176 If the target object has an associated callback that matches the
178 supplied Id it will be removed and longer informed of any
179 updates. If no object with a matching Id is found an exception
180 is raised.
181 get_callbacks(Filter) -> CallbackIDSeq
183 Types:
185 Filter = #objref
187 CallbackIDSeq = [CallbackID]
188 CallbackID = long()
189 This operation returns a sequence of all connected NotifySub‐
191 scribe object Id's. If no callbacks are associated with the tar‐
192 get object the list will be empty.
193Ericsson AB cosNotification 5.0 CosNotifyFilter_Filter(3)