ostore.tapestry.api
Class TapestryLocateFailure

java.lang.Object
  |
  +--ostore.network.NetworkMessage
        |
        +--ostore.tapestry.api.TapestryLocateFailure
All Implemented Interfaces:
Cloneable, QueueElementIF, QuickSerializable

public class TapestryLocateFailure
extends NetworkMessage

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.2 2002/01/28 20:12:57 ravenben Exp $
Author:
Ben Y. Zhao

Field Summary
 SecureHash obj_guid
           
 SecureHash req_hash
          The hash of the original request.
 SecureHash root
          The guid where the request was determined to have failed.
 
Fields inherited from class ostore.network.NetworkMessage
inbound, peer
 
Constructor Summary
TapestryLocateFailure(byte[] buffer, int[] offset)
           
TapestryLocateFailure(SecureHash root, SecureHash req_hash, SecureHash obj_guid, NodeId req)
           
 
Method Summary
 void to_bytes(byte[] buffer, int[] offset)
          Store the object in its "on the wire" form in the byte array data, starting at index offset [0], and increment offset [0] by the number of bytes written; if data == null, increment offset [0] by the number of bytes that would have been written otherwise.
 int type_code()
          Returns the unique integer associated with this class in the TypeTable.
 
Methods inherited from class ostore.network.NetworkMessage
clone, toString
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

req_hash

public SecureHash req_hash
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
Constructor Detail

TapestryLocateFailure

public TapestryLocateFailure(SecureHash root,
                             SecureHash req_hash,
                             SecureHash obj_guid,
                             NodeId req)

TapestryLocateFailure

public TapestryLocateFailure(byte[] buffer,
                             int[] offset)
                      throws QSException
Method Detail

to_bytes

public void to_bytes(byte[] buffer,
                     int[] offset)
Description copied from interface: QuickSerializable
Store the object in its "on the wire" form in the byte array data, starting at index offset [0], and increment offset [0] by the number of bytes written; if data == null, increment offset [0] by the number of bytes that would have been written otherwise.
Overrides:
to_bytes in class NetworkMessage
Following copied from interface: ostore.util.QuickSerializable
Parameters:
data - The byte array to store into, or null.
offset - A single element array whose first element is the index in data to begin writing at on function entry, and which on function exit has been incremented by the number of bytes written.

type_code

public int type_code()
Description copied from interface: QuickSerializable
Returns the unique integer associated with this class in the TypeTable.
Overrides:
type_code in class NetworkMessage
Following copied from interface: ostore.util.QuickSerializable
Returns:
an integer unique to this class