The InvalidName exception is raised when the ORB is unable to resolve any of the names returned by list_initial_services to its corresponding implementation object.
public class InvalidName extends UserException
ORG.COM.CORBA.OBJECT
The Object interface is the root interface of the CORBA inheritance hierarchy. It provides runtime type information and platform-independent reference equivalence testing. Table B.1 summarizes the key methods of the Object interface.
TABLE B.1 KEY METHODS OF THE Object INTERFACE
Method Function
bind_options Sets the bind options associated with the current object.
boa Returns the BOA associated with a particular request or the default BOA if no request is active.
clone Creates a copy of the current object, which receives its own server connection.
create_request Creates and initializes a dynamic invocation request.
get_interface Returns the interface definition of the current object.
hash Computes a positive hash value for the current object.
is_a Queries whether an object implements the specified interface.
is_bound Returns true if a network connection to the implementation object has been established.
is_equivalent Compares the Interoperable Object Reference of the specified
object with that of the current object and returns true if they are equivalent.
is_local Returns true if the current object resides in the local address space.
is_persistent Returns true if the current object retains its value beyond the lifetime of its implementing process.
is_remote Returns true if the current object resides in a remote address space.
non_existent Uses ping to determine whether the implementation object is active and returns false if the object is found to be active.
object_name Returns the name of the object implementation.
principal Returns the principal associated with a request on the object or sets the principal associated with the current object to the specified principal.
repository_id Returns the repository identifier of the current object implementation’s most derived interface.
resolve_reference Creates an empty dynamic invocation request. A client application can use the resolve_reference method to resolve the server- side interface with the specified service identifier.
The following method headers specify the arguments of the methods of the Object interface:
public interface Object // Public Methods
public BindOptions _bind_options() public BOA _boa()
public Object _clone()
public Request _create_request(Context context, String op, NVList args , NamedValue result, TypeCode[] exceptions, String [] contexts) public InterfaceDef _get_interface()
public int _hash(int max)
public _is_a(String repository) public boolean _is_bound()
public boolean _is_equivalent(Object obj) public boolean _is_local()
public boolean _is_persistent() public boolean _is_remote() public boolean _non_existent() public String _object_name() public Principal _principal()
public void _principal(Principal principal) public String _repository_id()
public Request _request(String op)
public Object _resolve_reference(String id)
ORG.COM.CORBA.ORB
The ORB class represents an Object Request Broker and provides a way to initialize the CORBA infrastructure, as well as a variety of methods used by clients and servers. Table B.2 summarizes the key methods of the ORB class.
The ORB class also provides a set of methods for handling NamedValue, NVList, DynAny, DynArray, DynEnum, DynSeqeuence, DynStruct, and DynUnion objects and a set of methods that return TypeCode objects of various types. Consult the Visibroker documentation for information about these methods.
TABLE B.2 KEY METHODS OF THE ORB INTERFACE
Method Function
init Initializes the ORB for use by an application or applet.
bind Attempts a bind on the ORB and returns a general reference.
BOA_init Initializes a BOA and returns a reference to the BOA . create_output_cstream Creates an output stream.
create_input_
stream Creates an input stream from an output stream. The input stream lets programs read the bytes written to the output stream.
default_bind_
options Gets or sets the global default bind options.
defaultPrincipal Gets or sets the global default Principal.
get_default_
context Returns the global default Context.
list_initial_
services Returns a list containing the names of object services initially available.
object_to _string Converts an object reference to a String and returns the result.
string_to_ object Converts a String to an object reference, narrowed to a specified interface, and returns the result.
get_next_ response Blocks until a response to a deferred operation request becomes available.
poll_next_ response Returns true if a response to a deferred operation is available.
resolve_initial
_references Resolves a member of the list returned by
list_initial_services to its corresponding implementation object and returns the result.
send_multiple
_requests_deferred Sends a set of operation requests without blocking.
send_multiple
_requests_oneway Sends a set of one way operation requests, which have no return values.
The following method headers specify the arguments of the methods of the ORB class:
public abstract class ORB // Public Class Methods
public static BOA BOA_init()
public static ORB init(String[] args , Properties p) public static ORB init(Applet app, Properties p) // Public Methods
public Object bind(String repository,
String object_name, String host_name, BindOptions opt) public public BOA BOA_init(String boa_type, Properties p) public abstract TypeCode create_alias_to(
String repository, String type_name, TypeCode type ) public abstract Any create_any()
public abstract TypeCode create_array_tc(int len, TypeCode type )
public DynAny create_basic_dyn_any(TypeCode type ) throws InconsistentTypeCode
public abstract ContextList create_context_list() public DynAny create_dyn_any(Any value)
public DynArray create_dyn_array(TypeCode type ) throws InconsistentTypeCode
public DynEnum create_dyn_enum(TypeCode type ) throws InconsistentTypeCode
public DynSequence create_dyn_sequence(TypeCode type ) throws InconsistentTypeCode
public DynStruct create_dyn_struct(TypeCode type ) throws InconsistentTypeCode
public DynUnion create_dyn_union(TypeCode type _ throws InconsistentTypeCode
public TypeCode create_enum_tc(String repository, String type , String [] members)
public abstract Environment create_environment() public abstract TypeCode create_estruct_tc(
String repository, String type , TypeCode base , StructMember [] members)
public abstract TypeCode create_exception_tc(
String repository, String type , StructMember [] members)
public abstract InputStream create_input_stream(
OutputStream out)
public abstract TypeCode create_interface_tc(
String repository, String type )
public abstract NVList create_list(int len) public abstract NamedValue create_named_value(
String name , Any value, int flags)
public abstract NVList create_operation_list(
OperationDef op_def)
public abstract OutputStream create_output_stream() public abstract TypeCode create_recursive_sequence_tc(
int len, int offset)
public abstract TypeCode create_sequence_tc(
int len, TypeCode type )
public abstract TypeCode create_String_tc(int len) public abstract TypeCode create_struct_tc(
String repository, String type , StructMember[] members)
public abstract TypeCode create_union_tc(
String repository, String type , TypeCode disc_type, UnionMembers [] members)
public abstract TypeCode create_wstring_tc(int len) public abstract BindOptions default_bind_options() public abstract void default_bind_options(
BindOptions opts )
public abstract Principal default_principal() public abstract void default_principal(
Principal principal)
public abstract Context get_default_context() public abstract Request get_next_response() public abstract TypeCode get_primitive_tc(
TCKind kind )
public abstract String [] list__initial_services() public abstract String object_to_string(Object obj) public abstract boolean poll_next_response()
public abstract Object resolve_initial_references(
String id) throws InvalidName
public abstract void send_multiple_requests_deferred(
Request [] reqs )
public abstract void send_multiple_requests_oneway(
Request [] reqs )
public abstract Object string_to_object(String ior)