com.inprise.vbroker.URLNaming
Interface Resolver

All Superinterfaces:

IDLEntity, java.io.Serializable

All Known Implementing Classes:

DotnetResolver, com.inprise.vbroker.URLNaming.ResolverImpl

public interface Resolver
extends IDLEntity

This interface provides a means of bootstrapping to an object through HTTP, by retrieving an object reference from a well-known URL on a web server.

Method Summary

void	force_register_url(java.lang.String url_s, Object obj) The force_register_url() method behaves like register_url(), but it will overwrite an existing binding.
Object	locate(java.lang.String url_s) Deprecated. Use the string_to_object method on the org.omg.CORBA.ORB interface instead, e.g. orb.string_to_object("http://www.acme.com/services/ns.ior");, which is a more portable solution.
void	register_url(java.lang.String url_s, Object obj) The register_url method will publish the IOR of the obj parameter using the URL given in the url_s argument.

Method Detail

register_url

void register_url(java.lang.String url_s,
                  Object obj)
                  throws InvalidURL,
                         CommFailure,
                         ReqFailure,
                         AlreadyExists

The register_url method will publish the IOR of the obj parameter using the URL given in the url_s argument. If an object is already registered under this URL, the AlreadyExists exception will be thrown.

Parameters:

url_s - The URL for the registration

obj - The object reference that is to be registered

Throws:

InvalidURL - The InvalidURL is thrown if the URL is syntactically malformed.

CommFailure - The CommFailure indicates that a communication problem with the HTTP server was encountered.

ReqFailure - The ReqFailure exception will be thrown if the HTTP request fails for some reason.

AlreadyExists - if URL already registered.

force_register_url

void force_register_url(java.lang.String url_s,
                        Object obj)
                        throws InvalidURL,
                               CommFailure,
                               ReqFailure

The force_register_url() method behaves like register_url(), but it will overwrite an existing binding.

Parameters:

url_s - The URL for the registration

obj - The object reference that is to be registered

Throws:

InvalidURL - The InvalidURL is thrown if the URL is syntactically malformed.

CommFailure - The CommFailure indicates that a communication problem with the HTTP server was encountered.

ReqFailure - The ReqFailure exception will be thrown if the HTTP request fails for some reason.

locate

Object locate(java.lang.String url_s)
              throws InvalidURL,
                     CommFailure,
                     ReqFailure

Deprecated. Use the string_to_object method on the org.omg.CORBA.ORB interface instead, e.g. orb.string_to_object("http://www.acme.com/services/ns.ior");, which is a more portable solution.

The locate() method retrieves an object reference stored on a web server, and creates a local CORBA::Object

Parameters:

url_s - The URL to be resolved

Throws:

InvalidURL - The InvalidURL is thrown if the URL is syntactically malformed.

CommFailure - The CommFailure indicates that a communication problem with the HTTP server was encountered.

ReqFailure - The ReqFailure exception will be thrown if the HTTP request fails for some reason.