![[Previous]](../pics/prev.gif){kind=small}
![[Contents]](../pics/toc.gif){kind=small}
![[Next]](../pics/next.gif){kind=small}
![[IONA Technologies]](../pics/iona.gif){kind=small}
BaseObject implements functionality common to all OrbixWeb objects. This functionality includes the implementation of all methods defined in the interface CORBA._ObjectRef and allows the characteristics of an OrbixWeb object reference to be retrieved and manipulated.Programmers never need to directly instantiate
CORBA.BaseObject; Java classes generated from IDL interface definitions implement _ObjectRef by inheriting from class CORBA.BaseObject. In an OrbixWeb client, the methods of this class are called on a proxy, unless collocation is set.
// Java
package IE.Iona.Orbix2.CORBA;
public class BaseObject
implements IE.Iona.Orbix2.CORBA._ObjectRef {
// Methods
public boolean _isNull();
public boolean _isRemote();
public String _object_to_string();
public String _object_to_string(int kind);
public String toString();
public Object clone();
public Request _request(String operation)
throws SystemException;
public int _create_request(Context ctx,
String operation,
NVList arg_list,
NamedValue result,
IE.Iona.Orbix2.CORBA.RequestHolder hrequest,
Flags req_flags)
throws SystemException;
public IE.Iona.Orbix2.CORBA._sequence_String
_baseInterfaces();
// Object reference field methods
public String _host();
public String _implementation();
public void _implementation(String serverName)
throws SystemException;
public String _marker();
public void _marker(String marker)
throws SystemException;
public String _interfaceHost();
public String _interfaceImplementation();
public String _interfaceMarker();
public String _get_implementation()
throws SystemException;
public IE.Iona.Orbix2._InterfaceDefRef _get_interface()
throws SystemException
}
CORBA._ObjectRef
public IE.Iona.Orbix2.CORBA._sequence_String _baseInterfaces();
public int _create_request(
IE.Iona.Orbix2.CORBA.Context ctx,
String operation,
IE.Iona.Orbix2.CORBA.NVList arg_list,
IE.Iona.Orbix2.CORBA.NamedValue result,
IE.Iona.Orbix2.CORBA.RequestHolder hrequest,
IE.Iona.Orbix2.CORBA.Flags req_flags)
throws IE.Iona.Orbix2.CORBA.SystemException;
Request object. See CORBA.BaseObject._request() for an alternative way to create a Request. See Chapter 19, "Dynamic Invocation Interface", of the OrbixWeb Programming Guide for examples of the use of this method.
Parameters:
Return Value:
Returns 1 if successful, 0 otherwise. Notes:
CORBA defined. This method is part of the Dynamic Invocation Interface. See Also:
CORBA.BaseObject._request()CORBA.RequestCORBA.ContextCORBA.FlagsCORBA.Request.arguments()CORBA.NVListCORBA.NamedValue
public String _get_implementation()
throws IE.Iona.Orbix2.CORBA.SystemException;
CORBA.BOA.impl_is_ready() or set by CORBA.ORB.setServerName().
CORBA.BaseObject._implementation()
public IE.Iona.Orbix2._InterfaceDefRef _get_interface()
throws IE.Iona.Orbix2.CORBA.SystemException;
Note that the
-R switch (which generates support for use of the Interface Repository) must have been specified to the IDL compiler when the interface was compiled. Otherwise, _get_interface() raises an exception.
public String _host();
public String _implementation();
CORBA.BOA.impl_is_ready() or CORBA.BOA.obj_is_ready() or set by CORBA.ORB.setServerName().
CORBA.BaseObject._get_implementation().
CORBA.BaseObject._get_implementation()
public String _implementation(String serverName);
CORBA.BOA.impl_is_ready() or CORBA.ORB.setServerName() has been called.
CORBA.BaseObject._implementation()
CORBA.BOA.impl_is_ready()
CORBA.ORB.setServerName()
public String _interfaceHost();
public String _interfaceImplementation();
public String _interfaceMarker();
-R and -d switches are passed to the IDL compiler. For example, if interface Account is defined in the file bank.idl, then possible return values for a call to this method on an object of type Account are:|
No switches to IDL compiler
|
Account
|
-R
|
bank.idl$Account
|
-R -d banks/commercialBanks
|
banks/CommercialBanks/bank.idl$Account
|
public boolean _isNull();
true if the object is a null object, returns false otherwise. This method also returns true if the invoked object is a null proxy.
CORBA.is_nil()
public boolean _isRemote();
true if the reference is to a remote object (that is, the target of the call is a proxy), returns false otherwise.
CORBA.ORB.collocated()
public String _marker();
CORBA.BaseObject._marker(String marker)
public void _marker(String marker);
Notes:
OrbixWeb specific. See Also:
CORBA.BaseObject._marker()
public String _object_to_string();
An OrbixWeb stringified object reference in Orbix protocol format has the form:
:\host:serverName:marker:IR_host:IR_Server:interfaceMarkerSee
CORBA.ORB.object_to_string() for an explanation of these fields.
CORBA.ORB.object_to_string() for CORBA defined version of this function.
CORBA.BaseObject._object_to_string(int kind)CORBA.ORB.object_to_string()
public String _object_to_string(int kind);
kind is _CORBA.IT_ORBIX_OR_KIND, then the string returned is in the standard Orbix reference string format:
:\host:serverName:marker:IR_host:IR_Server:interfaceMarkerIf the value of
kind is _CORBA.IT_INTEROPERABLE_OR_KIND, then the string returned is a CORBA Interoperable Object Reference (IOR) for use with the Internet Inter-ORB Protocol (IIOP), as described in Chapter 9, "ORB Interoperability", of the OrbixWeb Programming Guide.
See
CORBA.ORB.object_to_string() for an explanation of the fields in the Orbix object reference format. Parameters:
Return Value:
Returns a stringified object reference. Notes:
OrbixWeb specific. See CORBA.ORB.object_to_string() for CORBA defined version of this function. See Also:
_CORBACORBA.BaseObject._object_to_string()CORBA.ORB.object_to_string()
public IE.Iona.Orbix2.CORBA.Request _request( String operation);
Request on the target object. This is the shorter form of CORBA.BaseObject._create_request().Arguments and contexts may be added after construction using
CORBA.Request.arguments() and CORBA.Request.ctx(). See Chapter 19, "Dynamic Invocation Interface" of the OrbixWeb Programming Guide for examples of the use of this method.
Parameters:
operation
The name of the operation. Notes:
CORBA defined. See Also:
CORBA.BaseObject._create_request()CORBA.Request.arguments()CORBA.Request.ctx()
public String toString();
_object_to_string(). See CORBA.BaseObject._object_to_string() for details.
CORBA.BaseObject._object_to_string()