DDS — New definition for ObjectFilter

Issue [THALES]:
Selection could be slightly enhanced, by providing to the filter the fact if the object was previously a member.
proposal [THALES]
carry the fact that the object was previously part of the selection to the filter so that it may return quicker the result when appropriate
Concrete changes
IDL
enum MembershipState

;

local interface ObjectFilter

;
in section 3.1.6.3.8 ObjectFilter
in the table, add a parameter to the check_object operation by adding the following entry:
membership_state enum MembershipState
in the following text, add the following text to the bullet
[check ... (check_object);] this method is called with s first parameter the object to be checked and as second parameter an indication whether the object previously passed the filter (membership_state); this last parameter (which is actually an enumeration with three possible values - UNDEFINED_MEMBERSHIP, ALREADY_MEMBER and NOT_MEMBER) is useful when the ObjectFilter is attached to a Selection to allow the writing of optimized filters.
ref-1051: New definition for Selections (clarification)
Issue [THALES]
As notification_scope has been removed from the ObjectHome (cf. issue ref-1049), it is necessary to pass the information whether the modification of objects inside a Selection should be appreciated only on the object basis, or on the object + its contained objects basis
clarification is requested regarding when the SelectionListener is activated
Proposal [THALES]
add a parameter concerns_contained when the Selection is created and add this characteristic in the selection attributes
add a paragraph to specify when the Selection Listener is activated
in SelectionListener::on_object_out, the ObjectRoot may no more exist, therefore passing the ObjectReference is better
Concrete changes
in IDL
local interface Selection

;
local interface SelectionListener

;
in section 3.1.6.3.7 Selection
in the table, attribute list, add the following entry (as third attribute)
concerns_contained boolean
in the following text, starting with "It has the following attributes:"
add the following text at the end of the second bullet:
"; it is given at Selection creation time(cf. ObjectHome::create_selection)"
add a bullet in third position, with the following content:
"a boolean concerns_contained that indicates whether the Selection considers the modification of one of its members based on its content only (FALSE) or based on it content or the content of its contained objects (TRUE); it is given at Selection creation time(cf. ObjectHome::create_selection);"
add at the end of the section, the following paragraph:
"The SelectionListener is activated when the composition of the Selection is modified or when one of its members is modified. A member can be considered as modified, either only when it is itself modified or when itself or one of its contained objects is modifie (depending on the value of concerns_contained). Modifications in the Selection are considered with respects to the state of the Selection last time it was examined, i.e.:
add one bullet with the following text:
" at each incoming updates processing if autro_refresh is TRUE;"
add a second bullet with the following text:
"at each explicit call to refresh, if auto-refresh is FALSE."

see below