tapestry.api
Class TapestryLocateFailure

java.lang.Object
  |
  +--ostore.network.NetworkMessage
        |
        +--tapestry.api.TapestryLocateFailure

All Implemented Interfaces:

Cloneable, QueueElementIF, QuickSerializable

public class TapestryLocateFailure

extends NetworkMessage

implements QuickSerializable

An event which indicates that a TapestryLocateMsg was not successful. In other words, that the TapestryLocateMsg made its way all the way root without getting a positive query result.

NOTE: This event should be treated in much the same way as a DNS lookup failure. It does not necessary indicate that the query shouldn't have succeeded, only that it didn't. For instance, an intermediate node between the query source and the root could well cause such a failure, perhaps maliciously. Use with caution; you have been warned.

Version:

$Id: TapestryLocateFailure.java,v 1.1.1.1 2004/03/26 19:57:05 hweather Exp $

Author:

Ben Y. Zhao

Field Summary

int	hopCount Number of hops taken by the message on its way to the application
SecureHash	id The hash of the original request.
SecureHash	obj_guid
SecureHash	root The guid where the request was determined to have failed.
TapestryQueryState	state The latest state used by the query when the locate request failed.

Fields inherited from class ostore.network.NetworkMessage

comp_q, est_rtt_ms, inbound, peer, sender, tries, user_data, wait_ms

Constructor Summary

TapestryLocateFailure(InputBuffer buffer)

TapestryLocateFailure(SecureHash root, SecureHash id, SecureHash obj_guid, NodeId req, int hop)

TapestryLocateFailure(SecureHash root, SecureHash id, SecureHash obj_guid, NodeId req, int hop, TapestryQueryState state)

Method Summary

void	serialize(OutputBuffer buffer)
String	toString()

Methods inherited from class ostore.network.NetworkMessage

clone

Methods inherited from class java.lang.Object

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

Field Detail

id

public SecureHash id

The hash of the original request. Used to distinquish this request.

root

public SecureHash root

The guid where the request was determined to have failed. Should be the dynamically mapped root of the object ID originally requested for.

obj_guid

public SecureHash obj_guid

hopCount

public int hopCount

Number of hops taken by the message on its way to the application

state

public TapestryQueryState state

The latest state used by the query when the locate request failed.

Constructor Detail

TapestryLocateFailure

public TapestryLocateFailure(SecureHash root,
                             SecureHash id,
                             SecureHash obj_guid,
                             NodeId req,
                             int hop)

TapestryLocateFailure

public TapestryLocateFailure(SecureHash root,
                             SecureHash id,
                             SecureHash obj_guid,
                             NodeId req,
                             int hop,
                             TapestryQueryState state)

TapestryLocateFailure

public TapestryLocateFailure(InputBuffer buffer)
                      throws QSException

Method Detail

serialize

public void serialize(OutputBuffer buffer)

Specified by:

serialize in interface QuickSerializable

Overrides:

serialize in class NetworkMessage

toString

public String toString()

Overrides:

toString in class NetworkMessage