ostore.archive.events
Class UpdateVerifiableBlocksReq

java.lang.Object
  |
  +--ostore.archive.events.UpdateVerifiableBlocksReq

All Implemented Interfaces:

QueueElementIF, QuickSerializable

public class UpdateVerifiableBlocksReq

extends Object

implements QueueElementIF, QuickSerializable

UpdateVerifiableBlocksReq is an event class that request that a version of an object or be updated with FHASH's or the top of the VHashTree for each modified block.

USAGE

The required field are thisRootBlock (CacheableIdentity of root block), numFragments (number of Fragments generated for block), inverseRate (inverse rate of encoding), erasureType (code for the type of erasure code to use).

NOTE: for copy-on-write only the blocks with null GUID's will be fragmented (archived).

Version:

$Id: UpdateVerifiableBlocksReq.java,v 1.13 2003/11/17 23:52:43 emilong Exp $

Author:

Hakim Weatherspoon

See Also:

GenerateFragsChkptResp, UpdateVerifiableBlocksReq, Fragment, Erasure

Field Summary

SecureHash

_vguid vguid is the resulting guid for fragmentation of checkpoint.

Constructor Summary

UpdateVerifiableBlocksReq()
Constructor: Initializes instance variables to null.

UpdateVerifiableBlocksReq(InputBuffer buffer)
Constructs a UpdateVerifiableBlocksReq from its serialized form.

UpdateVerifiableBlocksReq(VID topBlockId, SecureHash vguid, SecureHash aguid, Map blockIdentifiers)
Constructor.

Method Summary

SecureHash	getAguid() getAguid returns the A-GUID of the object.
SortedMap	getBlockIds() getBlockIds returns a VHASH->FHASH Map containing the blockIds(vhashes) that make up the slice of the of modified and Fragmented blocks of an object.
VID	getTopBlockId() getTopBlockId returns the VID of root block.
SecureHash	getVguid() getVguid returns the V-GUID (i.e. version GUID)of the object.
void	serialize(OutputBuffer buffer) Specified by QuickSerializable
String	toString() Specified by java.lang.Object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

_vguid

public SecureHash _vguid

vguid is the resulting guid for fragmentation of checkpoint.

Constructor Detail

UpdateVerifiableBlocksReq

public UpdateVerifiableBlocksReq()

Constructor: Initializes instance variables to null.

UpdateVerifiableBlocksReq

public UpdateVerifiableBlocksReq(VID topBlockId,
                                 SecureHash vguid,
                                 SecureHash aguid,
                                 Map blockIdentifiers)

Constructor. Initializes the data in this UpdateVerifiableBlocksReq.

Parameters:

topBlockId - VID of the top block.

vguid - V-GUID of DataObject

aguid - A-GUID of DataObject

blockIdentifiers - A VHASH->FHASH Map containing the blockIds(vhashes) that make up the slice of the of modified and Fragmented blocks of an object.

UpdateVerifiableBlocksReq

public UpdateVerifiableBlocksReq(InputBuffer buffer)
                          throws QSException

Constructs a UpdateVerifiableBlocksReq from its serialized form.

Parameters:

buffer - serialized form of object.

Method Detail

getTopBlockId

public VID getTopBlockId()

getTopBlockId returns the VID of root block.

Returns:

the VID of root block.

getVguid

public SecureHash getVguid()

getVguid returns the V-GUID (i.e. version GUID)of the object.

Returns:

V-GUID of object.

getAguid

public SecureHash getAguid()

getAguid returns the A-GUID of the object.

Returns:

A-GUID of object.

getBlockIds

public SortedMap getBlockIds()

getBlockIds returns a VHASH->FHASH Map containing the blockIds(vhashes) that make up the slice of the of modified and Fragmented blocks of an object.

Returns:

a VHASH->FHASH Map containing the blockIds(vhashes) that make up the slice of the of modified and Fragmented blocks of an object.

serialize

public void serialize(OutputBuffer buffer)

Specified by QuickSerializable

Specified by:

serialize in interface QuickSerializable

Parameters:

buffer - the output buffer to add the object to

toString

public String toString()

Specified by java.lang.Object

Overrides:

toString in class Object