Package org.jgroups

Class MergeView

java.lang.Object

org.jgroups.View

org.jgroups.MergeView

All Implemented Interfaces:

Externalizable, Serializable, Cloneable, Streamable

public class MergeView
extends View

A view that is sent as a result of a merge. Whenever a group splits into subgroups, e.g., due to a network partition, and later the subgroups merge back together, a MergeView instead of a View will be received by the application. The MergeView class is a subclass of View and contains as additional instance variable: the list of views that were merged. For example, if the group denoted by view V1:(p,q,r,s,t) splits into subgroups V2:(p,q,r) and V2:(s,t), the merged view might be V3:(p,q,r,s,t). In this case the MergeView would contain a list of 2 views: V2:(p,q,r) and V2:(s,t).

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Vector<View>	subgroups

Fields inherited from class org.jgroups.View

members, payload, vid

Constructor Summary

Constructors

Constructor	Description
MergeView()	Used by externalization
MergeView(Address creator, long id, Vector<Address> members, Vector<View> subgroups)	Creates a new view
MergeView(ViewId vid, Vector<Address> members, Vector<View> subgroups)	Creates a new view

Method Summary

Modifier and Type	Method	Description
Object	clone()	creates a copy of this view
Vector<View>	getSubgroups()
void	readExternal(ObjectInput in)
void	readFrom(DataInputStream in)	Read the state of the current object (including superclasses) from instream Note that the input stream must not be closed
int	serializedSize()
String	toString()
void	writeExternal(ObjectOutput out)
void	writeTo(DataOutputStream out)	Write the entire state of the current object (including superclasses) to outstream.

Methods inherited from class org.jgroups.View

addPayload, containsMember, equals, getCreator, getMembers, getPayload, getVid, hashCode, printDetails, size

Methods inherited from class java.lang.Object

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

Field Details

subgroups

protected Vector<View> subgroups

Constructor Details

MergeView

public MergeView()

Used by externalization

MergeView

public MergeView(ViewId vid,
 Vector<Address> members,
 Vector<View> subgroups)

Creates a new view

Parameters:

vid - The view id of this view (can not be null)

members - Contains a list of all the members in the view, can be empty but not null.

subgroups - A list of Views representing the former subgroups

MergeView

public MergeView(Address creator,
 long id,
 Vector<Address> members,
 Vector<View> subgroups)

Creates a new view

Parameters:

creator - The creator of this view (can not be null)

id - The lamport timestamp of this view

members - Contains a list of all the members in the view, can be empty but not null.

subgroups - A list of Views representing the former subgroups

Method Details

getSubgroups

public Vector<View> getSubgroups()

clone

public Object clone()

creates a copy of this view

Overrides:

clone in class View

Returns:

a copy of this view

toString

public String toString()

Overrides:

toString in class View

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class View

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class View

Throws:

IOException

ClassNotFoundException

writeTo

public void writeTo(DataOutputStream out)
             throws IOException

Description copied from interface: Streamable

Write the entire state of the current object (including superclasses) to outstream. Note that the output stream must not be closed

Specified by:

writeTo in interface Streamable

Overrides:

writeTo in class View

Throws:

IOException

readFrom

public void readFrom(DataInputStream in)
              throws IOException,
IllegalAccessException,
InstantiationException

Description copied from interface: Streamable

Read the state of the current object (including superclasses) from instream Note that the input stream must not be closed

Specified by:

readFrom in interface Streamable

Overrides:

readFrom in class View

Throws:

IOException

IllegalAccessException

InstantiationException

serializedSize

public int serializedSize()

Overrides:

serializedSize in class View