ostore.client
Class OSRegisterAppRequest

java.lang.Object
  |
  +--ostore.client.OSRequest
        |
        +--ostore.client.OSRegisterAppRequest
All Implemented Interfaces:
QueueElementIF, QuickSerializable

public class OSRegisterAppRequest
extends OSRequest

The OSRegisterAppRequest request registers the application with the ClientStage. An application must register with the ClientStage to receive an OSAppId before sending any other requests. The application identitifier must be included in all other requests to OceanStore. All results sent back to the application will include the application identifier of the requesting application allowing applications to filter results intended for them.

Because the registration request and result must be exchanged without the benefit of an application identifier, the request/result pair includes a nonce for uniqueness. The application wishing to register with the ClientStage should include a nonce in its registration request. That nonce will be included in the result to allow the registering application to determine if a result is in response to its request.

Version:
$Id: OSRegisterAppRequest.java,v 1.10 2003/04/04 11:15:01 hweather Exp $
Author:
Patrick R. Eaton
See Also:
OSRegisterAppResult

Field Summary
 
Fields inherited from class ostore.client.OSRequest
app_id
 
Constructor Summary
OSRegisterAppRequest(InputBuffer buffer)
           
OSRegisterAppRequest(long nonce)
           
 
Method Summary
 long getNonce()
           
 String getRequestType()
           
 void serialize(OutputBuffer buffer)
          Add the object to the buffer.
 String toString()
           
 
Methods inherited from class ostore.client.OSRequest
clone, getAppId, getDispatchTime, getSeqNum, getUserTag, setUserTag
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

OSRegisterAppRequest

public OSRegisterAppRequest(long nonce)

OSRegisterAppRequest

public OSRegisterAppRequest(InputBuffer buffer)
                     throws QSException
Method Detail

serialize

public void serialize(OutputBuffer buffer)
Description copied from interface: QuickSerializable
Add the object to the buffer.

Specified by:
serialize in interface QuickSerializable
Overrides:
serialize in class OSRequest
Parameters:
buffer - the output buffer to add the object to

getNonce

public long getNonce()

toString

public String toString()
Overrides:
toString in class Object

getRequestType

public String getRequestType()
Overrides:
getRequestType in class OSRequest