#include <coherence/util/ServiceEvent.hpp>
Inherits Event.
Public Types | |
typedef spec::Handle | Handle |
ServiceEvent Handle definition. | |
typedef spec::View | View |
ServiceEvent View definition. | |
typedef spec::Holder | Holder |
ServiceEvent Holder definition. | |
typedef TypedHandle < Service > | ServiceHandle |
Service Handle definition. | |
typedef TypedHandle < const Service > | ServiceView |
Service View definition. | |
Public Member Functions | |
virtual void | dispatch (Listeners::View vListeners) const |
Dispatch this event to the specified listeners collection. | |
virtual TypedHandle < const String > | toString () const |
Output a human-readable description of this Object to the given stream. Note that when overriding this method the return type must be TypedHandle<const String> rather then String::View. These two types are assignment compatible but not equivalent and declaring the override with String::View will not be a compatible override. coherence::lang::operator<<(std::ostream, Object::View) is defined and will call into the toString method, to output Objects. If a managed String object is desired, the COH_TO_STRING macro can be used to build up a String from streamable contents and is generally how toString() will be implemented.
Object::View vKey = ... Object::View vValue = ... std::cout << vKey << " = " << vValue << std::endl; String::View vs = COH_TO_STRING(vKey << " = " << vValue); The COH_TO_STRING macro is also the most common way to implement the toString method. For example:
virtual TypedHandle<const String> Person::toString() const { return COH_TO_STRING("Name: " << f_sName << " SSN: " << f_nSSN); }
| |
virtual Id | getId () const |
Return this event's ID. | |
virtual ServiceView | getService () const |
Return the Service that fired the event. | |
Protected Member Functions | |
ServiceEvent (ServiceView vService, Id identity) | |
Create a new ServiceEvent instance. | |
Protected Attributes | |
Id | m_id |
The event's ID. |
ServiceEvent | ( | ServiceView | vService, | |
Id | identity | |||
) | [protected] |
Create a new ServiceEvent instance.
vService | the Service that fired the event | |
identity | the event's ID, one of the Id enum values |
virtual void dispatch | ( | Listeners::View | vListeners | ) | const [virtual] |
Dispatch this event to the specified listeners collection.
vListeners | the listeners collection |
ClassCastException | if any of the targets is not an instance of the ServiceListener interface |
virtual Id getId | ( | ) | const [virtual] |
Return this event's ID.
virtual ServiceView getService | ( | ) | const [virtual] |