org.jgroups.protocols.pbcast

Class DeltaView

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<Address>

org.jgroups.View

org.jgroups.protocols.pbcast.DeltaView

All Implemented Interfaces:

java.lang.Comparable<View>, java.lang.Iterable<Address>, java.util.Collection<Address>, java.util.List<Address>, Streamable

public class DeltaView
extends View

Subclass of View with a null members field. Adds an array for left members and one for joined members compared to the previous view. A recipient receiving a DeltaView can construct a new view by grabbing the view corresponding to View.view_id, removing the left members and adding the new members.

This class is only used with VIEW messages in GMS to install new views (not merge views). When a VIEW message is received, the DeltaView is read from the GMS.GmsHeader, a View is constructured and the header discarded. Therefore, the lifetime of a DeltaView is short: it is created and set in a GmsHeader, the header is then marshalled. On the receiving side, the DeltaView is created from the stream, a View is created and the DeltaView discarded again.

Instances of this class are created by CoordGmsImpl.handleMembershipChange(java.util.Collection).

JIRA issue: https://issues.jboss.org/browse/JGRP-1354

Since:

3.4

Author:

Bela Ban

Field Summary

Fields

Modifier and Type	Field and Description
protected Address[]	left_members Members which left the view corresponding to ref_view_id
protected Address[]	new_members Members which joined the view corresponding to ref_view_id
protected ViewId	ref_view_id The fields left_members and new_members refer to the view corresponding to ref_view_id

Fields inherited from class org.jgroups.View

members, suppress_view_size, view_id

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
DeltaView()
DeltaView(ViewId view_id, ViewId ref_view_id, Address[] left_members, Address[] new_members)

Method Summary

Modifier and Type	Method and Description
Address[]	getLeftMembers()
Address[]	getNewMembers()
ViewId	getRefViewId()
java.util.Iterator<Address>	iterator()
void	readFrom(java.io.DataInput in) Read the state of the current object (including superclasses) from instream Note that the input stream must not be closed
int	serializedSize()
java.lang.String	toString()
void	writeTo(java.io.DataOutput out) Write the entire state of the current object (including superclasses) to outstream.

Methods inherited from class org.jgroups.View

compareTo, containsMember, containsMembers, copy, create, create, deepEquals, diff, equals, get, getCoord, getCreator, getMembers, getMembersRaw, getVid, getViewId, hashCode, leftMembers, size

Methods inherited from class java.util.AbstractList

add, add, addAll, clear, indexOf, lastIndexOf, listIterator, listIterator, remove, removeRange, set, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface java.util.List

addAll, contains, containsAll, isEmpty, remove, removeAll, replaceAll, retainAll, sort, spliterator, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Field Detail

ref_view_id

protected ViewId ref_view_id

The fields left_members and new_members refer to the view corresponding to ref_view_id

left_members

protected Address[] left_members

Members which left the view corresponding to ref_view_id

new_members

protected Address[] new_members

Members which joined the view corresponding to ref_view_id

Constructor Detail

DeltaView

public DeltaView()

DeltaView

public DeltaView(ViewId view_id,
                 ViewId ref_view_id,
                 Address[] left_members,
                 Address[] new_members)

Method Detail

getRefViewId

public ViewId getRefViewId()

getLeftMembers

public Address[] getLeftMembers()

getNewMembers

public Address[] getNewMembers()

serializedSize

public int serializedSize()

Overrides:

serializedSize in class View

writeTo

public void writeTo(java.io.DataOutput out)
             throws java.lang.Exception

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:

java.lang.Exception

readFrom

public void readFrom(java.io.DataInput in)
              throws java.lang.Exception

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:

java.lang.Exception

iterator

public java.util.Iterator<Address> iterator()

Specified by:

iterator in interface java.lang.Iterable<Address>

Specified by:

iterator in interface java.util.Collection<Address>

Specified by:

iterator in interface java.util.List<Address>

Overrides:

iterator in class View

toString

public java.lang.String toString()

Overrides:

toString in class View