fulmine.event.subscription
Interface ISubscriptionParameters

All Superinterfaces:

IAddressable, IDestroyable

All Known Subinterfaces:

ISubscription

All Known Implementing Classes:

ContainerSubscription, RxSubscription, Subscription, SubscriptionParameters, TxSubscription

public interface ISubscriptionParameters
extends IDestroyable, IAddressable

Represents the parameters of a subscription for an IEventSource. This extends the IAddressable interface and encapsulates the type, domain and identity attributes of event sources that would match.

The wildcards

• ISubscription.WILDCARD_ID_REGEX
• ISubscription.WILDCARD_TYPE
• ISubscription.WILDCARD_DOMAIN

can be used for the relevant attribute of the subscription.

Instances are compared to each other using their attribute values; a wildcard attribute will only match a wildcard attribute for comparison.

Author:

Ramon Servadei

See Also:

ISubscription

Method Summary

boolean

includes(IAddressable other) Determine if the IAddressable attributes of this parameters instance would include those of another.

Methods inherited from interface fulmine.IDestroyable

destroy

Methods inherited from interface fulmine.IAddressable

getAddress, getDomain, getIdentity, getType

Method Detail

includes

boolean includes(IAddressable other)

Determine if the IAddressable attributes of this parameters instance would include those of another. For this instance to include the other, each attribute of this instance must be an exact match or a more generalised match of corresponding attribute in the other.

For example, assuming the type and domain are equal, if this instance has the identity regular expression "foo.*" and the other instance has the identity "foo bar", then this instance effectively includes the other (it is more generalised). However, it would not include the other if the other instance has an identity regular expression ".*" as this is now more generalised than this instance.

Parameters:

other - the other IAddressable instance to compare with this

Returns:

true if the attributes of this instance include those of the other