gnu.CORBA.GIOP

Class RequestHeader

Implemented Interfaces:
IDLEntity, Serializable
Known Direct Subclasses:
RequestHeader

public abstract class RequestHeader
extends ContextHandler
implements IDLEntity

The GIOP request message.

Field Summary

byte[]
object_key
Identifies the object that is the target of the invocation.
String
operation
The operation being invoked (IDL scope name).
int
request_id
This is used to associate the reply message with the previous request message.
byte[]
requesting_principal
Deprecated. by CORBA 2.2.
protected boolean
response_expected
If true, the response from the server is expected.

Fields inherited from class gnu.CORBA.GIOP.ContextHandler

NO_CONTEXT, service_context

Method Summary

String
bytes(byte[] array)
Converts an byte array into hexadecimal string values.
static int
getNextId()
Get next free request id.
abstract boolean
isResponseExpected()
Return true if response is expected.
abstract void
read(AbstractCdrInput in)
Reads the header from the stream.
abstract void
setResponseExpected(boolean expected)
Set if the sender expects any response to this message.
abstract String
toString()
Return a string representation.
abstract void
write(AbstractCdrOutput out)
Writes the header to the stream.

Methods inherited from class gnu.CORBA.GIOP.ContextHandler

addContext

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

object_key

public byte[] object_key
Identifies the object that is the target of the invocation.

operation

public String operation
The operation being invoked (IDL scope name).

request_id

public int request_id
This is used to associate the reply message with the previous request message. Initialised each time by the different value, increasing form 1 to Integer.MAX_VALUE.

requesting_principal

public byte[] requesting_principal

Deprecated. by CORBA 2.2.

A value identifying the requesting principal. Initialised into a single zero byte.

response_expected

protected boolean response_expected
If true, the response from the server is expected.

Method Details

bytes

public String bytes(byte[] array)
Converts an byte array into hexadecimal string values. Used in various toString() methods.

getNextId

public static int getNextId()
Get next free request id. The value of the free request id starts from 0x02345678, it is incremented each time this function is called and is reset to 1 after reaching Integer.MAX_VALUE.
Returns:
the next free request id.

isResponseExpected

public abstract boolean isResponseExpected()
Return true if response is expected.

read

public abstract void read(AbstractCdrInput in)
Reads the header from the stream.
Parameters:
in - a stream to read from.

setResponseExpected

public abstract void setResponseExpected(boolean expected)
Set if the sender expects any response to this message.

toString

public abstract String toString()
Return a string representation.
Overrides:
toString in interface Object

write

public abstract void write(AbstractCdrOutput out)
Writes the header to the stream.
Parameters:
out - a stream to write into.

RequestHeader.java -- The GIOP 1.0 request message. Copyright (C) 2005 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.