JavaGroups.Ensemble
Class Hot_Ensemble

java.lang.Object
  |
  +--JavaGroups.Ensemble.Hot_Ensemble

public class Hot_Ensemble

extends java.lang.Object

implements java.lang.Runnable

Field Summary

int	HOT_ENS_MSG_SEND_CURRENT_VIEW
int	HOT_ENS_MSG_SEND_NEXT_VIEW
int	HOT_ENS_MSG_SEND_UNSPECIFIED_VIEW

Constructor Summary

Hot_Ensemble()
Constructs a Hot_Ensemble object starting the Ensemble Outboard process on a random port between 5000 and 8000

Hot_Ensemble(int port)
Constructs a Hot_Ensemble object starting the Ensemble Outboard process on the specified port.

Method Summary

Hot_Error	Cast(Hot_GroupContext gc, Hot_Message orig_msg, int[] send_view) Broadcast a Hot_Message to the group specified in the Hot_GroupContext
Hot_Error	ChangeProperties(Hot_GroupContext gc, java.lang.String properties) Change the properties of the group specified by the Hot_GroupContext to the properties specified by the String
Hot_Error	ChangeProtocol(Hot_GroupContext gc, java.lang.String protocol) Change the protocol used by the group specified by the Hot_GroupContext to the protocol specified by the String
void	destroyOutboard() Destroys the associated outboard process.
Hot_Error	Join(Hot_JoinOps jops, Hot_GroupContext[] gctx) Join the Ensemble group specified in the Hot_JoinOps structure
Hot_Error	Leave(Hot_GroupContext gc) Leave the Ensemble group specified in the Hot_GroupContext
static void	Panic(java.lang.String s) Halts the application with the error specified by the String
Hot_Error	RequestNewView(Hot_GroupContext gc) Request a new view in the group specified by the Hot_GroupContext
void	run() Mainloop of the process
Hot_Error	Send(Hot_GroupContext gc, Hot_Endpoint dest, Hot_Message orig_msg, int[] send_view) Send a Hot_Message to member specified by the Hot_Endpoint in the group specified by the Hot_GroupContext
void	setDebug(boolean b) Set whether or not to display lots of debug information.
Hot_Error	Suspect(Hot_GroupContext gc, Hot_Endpoint[] suspects) NOT SUPPORTED CURRENTLY IN THE ML
static void	trace(java.lang.String s) Prints (or does not print) the specified string to standard error based upon the debug flag

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HOT_ENS_MSG_SEND_UNSPECIFIED_VIEW

public final int HOT_ENS_MSG_SEND_UNSPECIFIED_VIEW

HOT_ENS_MSG_SEND_NEXT_VIEW

public final int HOT_ENS_MSG_SEND_NEXT_VIEW

HOT_ENS_MSG_SEND_CURRENT_VIEW

public final int HOT_ENS_MSG_SEND_CURRENT_VIEW

Constructor Detail

Hot_Ensemble

public Hot_Ensemble()

Constructs a Hot_Ensemble object starting the Ensemble Outboard process on a random port between 5000 and 8000

Hot_Ensemble

public Hot_Ensemble(int port)

Constructs a Hot_Ensemble object starting the Ensemble Outboard process on the specified port. If you use this version of the constructor, you are expected to make sure the port is not already in use. You can check for successful startup by invoking isOutboardStarted();

Method Detail

destroyOutboard

public void destroyOutboard()

Destroys the associated outboard process. All instances of Hot_Ensemble (in an instance of the VM) use the same outboard process (currently). So, if you destroy the outboard process for one instance, it gets destroyed for all instances. A future version of Ensemble/Java will change this restriction.

setDebug

public void setDebug(boolean b)

Set whether or not to display lots of debug information. Default: false

Join

public Hot_Error Join(Hot_JoinOps jops,
                      Hot_GroupContext[] gctx)

Join the Ensemble group specified in the Hot_JoinOps structure

Leave

public Hot_Error Leave(Hot_GroupContext gc)

Leave the Ensemble group specified in the Hot_GroupContext

Cast

public Hot_Error Cast(Hot_GroupContext gc,
                      Hot_Message orig_msg,
                      int[] send_view)

Broadcast a Hot_Message to the group specified in the Hot_GroupContext

Send

public Hot_Error Send(Hot_GroupContext gc,
                      Hot_Endpoint dest,
                      Hot_Message orig_msg,
                      int[] send_view)

Send a Hot_Message to member specified by the Hot_Endpoint in the group specified by the Hot_GroupContext

Suspect

public Hot_Error Suspect(Hot_GroupContext gc,
                         Hot_Endpoint[] suspects)

NOT SUPPORTED CURRENTLY IN THE ML

ChangeProtocol

public Hot_Error ChangeProtocol(Hot_GroupContext gc,
                                java.lang.String protocol)

Change the protocol used by the group specified by the Hot_GroupContext to the protocol specified by the String

ChangeProperties

public Hot_Error ChangeProperties(Hot_GroupContext gc,
                                  java.lang.String properties)

Change the properties of the group specified by the Hot_GroupContext to the properties specified by the String

RequestNewView

public Hot_Error RequestNewView(Hot_GroupContext gc)

Request a new view in the group specified by the Hot_GroupContext

run

public void run()

Mainloop of the process

Specified by:

run in interface java.lang.Runnable

Panic

public static void Panic(java.lang.String s)

Halts the application with the error specified by the String

trace

public static void trace(java.lang.String s)

Prints (or does not print) the specified string to standard error based upon the debug flag