ostore.dtree
Class DTreeLocateMsg

java.lang.Object
  |
  +--dd.api.DDLocateMsg
        |
        +--ostore.dtree.DTreeLocateMsg

All Implemented Interfaces:

QueueElementIF, QuickSerializable

public class DTreeLocateMsg

extends DDLocateMsg

Messages sent towards dissemination trees. Only DTreeNode stages should dispatch or subscribe to events of this type.

DTreeNodes use these messages to communicate with replicas in trees which they are not members. For example, when sending DTreeServiceReqs to new trees.

Version:

$Id: DTreeLocateMsg.java,v 1.20 2004/05/13 20:13:52 hweather Exp $

Author:

Dennis Geels

Field Summary

QuickSerializable

content The message to send.

Fields inherited from class dd.api.DDLocateMsg

forward, guid, hopCount, id, inbound, INTERMEDIATE_NONE, INTERMEDIATE_PTRS_CACHE_ONLY, INTERMEDIATE_PTRS_DISK, INTERMEDIATE_STRING, INTERMEDIATE_UPCALL_ONLY, intermediate_upcall_policy, one_hop, peer, query, query_state, recursive_route, TTL, vc, VC_NONE, vc_policy, VC_ROOT, VC_SRC, VC_STRING, VC_SUPPLIED

Constructor Summary

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

DTreeLocateMsg(SecureHash tree_id, QuickSerializable content, QSInt max_depth, Double max_distance, boolean forward, boolean recursive_route, boolean one_hop, byte intermediate_upcall_policy, byte vc_policy, bamboo.vivaldi.VirtualCoordinate vc)
Creates a new DTreeLocateMsg with an upper bound on the depth of nodes in the dissemination tree and/or the distance to the tree root.

Method Summary

void	serialize(OutputBuffer buffer) Add the object to the buffer.
String	toString() Returns a human-readable representation of this DTreeLocateMsg.

Methods inherited from class java.lang.Object

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

Field Detail

content

public QuickSerializable content

The message to send.

Constructor Detail

DTreeLocateMsg

public DTreeLocateMsg(SecureHash tree_id,
                      QuickSerializable content,
                      QSInt max_depth,
                      Double max_distance,
                      boolean forward,
                      boolean recursive_route,
                      boolean one_hop,
                      byte intermediate_upcall_policy,
                      byte vc_policy,
                      bamboo.vivaldi.VirtualCoordinate vc)

Creates a new DTreeLocateMsg with an upper bound on the depth of nodes in the dissemination tree and/or the distance to the tree root.

Parameters:

tree_id - The name of the dissemination tree.

content - The message to send to the tree. Currently must be of type DTreeServiceReq.

max_depth - The maximum acceptable depth in the tree, or null if any will do.

max_distance - The maximum acceptable distance from the root tree, or null if any will do.

forward - See DDLocateMsg.forward for details.

recursive_route - See DDLocateMsg.recursive_route for details.

one_hop - See DDLocateMsg.one_hop for details.

intermediate_upcall_policy - See DDLocateMsg.recursive_route for details.

vc_policy - See DDLocateMsg.recursive_route for details.

vc - See DDLocateMsg.forward for details.

DTreeLocateMsg

public DTreeLocateMsg(InputBuffer buffer)
               throws QSException

Constructs a DTreeLocateMsg from its serialized form.

Method Detail

serialize

public void serialize(OutputBuffer buffer)

Description copied from interface: QuickSerializable

Add the object to the buffer.

Parameters:

buffer - the output buffer to add the object to

toString

public String toString()

Returns a human-readable representation of this DTreeLocateMsg.

Overrides:

toString in class Object