@Deprecated public final class PrincipalHolder extends Object implements Streamable
A container class for values of type Principal
that is used to store "out" and "inout" parameters in IDL methods.
If an IDL method signature has an IDL Principal as an "out"
or "inout" parameter, the programmer must pass an instance of
PrincipalHolder as the corresponding
parameter in the method invocation; for "inout" parameters, the programmer
must also fill the "in" value to be sent to the server.
Before the method invocation returns, the ORB will fill in the
value corresponding to the "out" value returned from the server.
If myPrincipalHolder is an instance of PrincipalHolder,
the value stored in its value field can be accessed with
myPrincipalHolder.value.
| Modifier and Type | Field and Description |
|---|---|
Principal |
value
Deprecated.
The
Principal value held by this PrincipalHolder
object. |
| Constructor and Description |
|---|
PrincipalHolder()
Deprecated.
Constructs a new
PrincipalHolder object with its
value field initialized to null. |
PrincipalHolder(Principal initial)
Deprecated.
Constructs a new
PrincipalHolder object with its
value field initialized to the given
Principal object. |
| Modifier and Type | Method and Description |
|---|---|
void |
_read(InputStream input)
Deprecated.
Reads data from
istream and initalizes the
value field of the Holder with the unmarshalled data. |
TypeCode |
_type()
Deprecated.
Retrieves the
TypeCode object corresponding to the value
in the value field of the Holder. |
void |
_write(OutputStream output)
Deprecated.
Marshals to
ostream the value in the
value field of the Holder. |
public Principal value
Principal value held by this PrincipalHolder
object.public PrincipalHolder()
PrincipalHolder object with its
value field initialized to null.public PrincipalHolder(Principal initial)
PrincipalHolder object with its
value field initialized to the given
Principal object.initial - the Principal with which to initialize
the value field of the newly-created
PrincipalHolder objectpublic void _read(InputStream input)
Streamableistream and initalizes the
value field of the Holder with the unmarshalled data._read in interface Streamableinput - the InputStream that represents the CDR data from the wire.public void _write(OutputStream output)
Streamableostream the value in the
value field of the Holder._write in interface Streamableoutput - the CDR OutputStreampublic TypeCode _type()
StreamableTypeCode object corresponding to the value
in the value field of the Holder._type in interface StreamableTypeCode object for the value held in the holder Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138