de.novanic.eventservice.client.event.domain

Class DefaultDomain

java.lang.Object

de.novanic.eventservice.client.event.domain.DefaultDomain

All Implemented Interfaces:

Domain, Serializable, Comparable<Domain>

public final class DefaultDomain
extends Object
implements Domain

Domains/contexts are used to specify the range where events should occur and listened. That supports the reuse of events (Event and listeners (RemoteEventListener.

Example:
Your application is a multiplayer online game with a conversation system. You defined the following events and listeners.

Events: NewUserEvent
Listeners: ConversationListener, ConversationChannelListener, PlayerListListener

It makes sense to divide your elements into different domains, to ensure that a NewUserEvent affects only the right context/domain. For example one conversation domain and one game domain. ConversationListener and ConversationChannelListener should be added to the conversation domain and the PlayerListListener should be added to the game domain. Now you can distinguish the context of the NewUserEvent. If a user joined a conversation (NewUserEvent added to conversation domain), the two conversation listeners will recognize it and the PlayerListListener won't be informed about the NewUserEvent in the conversation context/domain.

Author:

sstrohschein
Date: 15.08.2008
Time: 22:42:20

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DefaultDomain() Deprecated. That constructor is only for serialization! Please use DefaultDomain(String) instead.
DefaultDomain(String aName) Creates a new domain with a specified name.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(Domain aDomain)
boolean	equals(Object anObject)
String	getName() Return the name of the domain.
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DefaultDomain

@Deprecated
public DefaultDomain()

Deprecated. That constructor is only for serialization! Please use DefaultDomain(String) instead.

See Also:

DefaultDomain(String)

DefaultDomain

public DefaultDomain(String aName)

Creates a new domain with a specified name. The name should be unique to avoid 'collision' of events.

Parameters:

aName - unique domain name

Method Detail

getName

public String getName()

Return the name of the domain.

Specified by:

getName in interface Domain

Returns:

domain name

compareTo

public int compareTo(Domain aDomain)

Specified by:

compareTo in interface Comparable<Domain>

equals

public boolean equals(Object anObject)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object