org.apache.yoko.orb.OB
Interface URLRegistryOperations

All Known Subinterfaces:

URLRegistry

All Known Implementing Classes:

URLRegistry_impl

public interface URLRegistryOperations

The URLRegistry holds all of the supported URL schemes.

See Also:

URLScheme

Method Summary

void	add_scheme(URLScheme scheme) Register a new URL scheme.
void	destroy() Invoke destroy() on all registered schemes, and release any resources held by the object.
URLScheme	find_scheme(String name) Find a scheme with the given name.
Object	parse_url(String url) Convert a URL into an object reference by delegating to a registered URLScheme object.

Method Detail

add_scheme

void add_scheme(URLScheme scheme)
                throws SchemeAlreadyExists

Register a new URL scheme.

Parameters:

scheme - The new scheme.

Throws:

SchemeAlreadyExists - Another scheme already exists with the same name.

find_scheme

URLScheme find_scheme(String name)

Find a scheme with the given name.

Parameters:

name - The scheme name, in lower case.

Returns:

The URLScheme, or nil if no match was found.

parse_url

Object parse_url(String url)

Convert a URL into an object reference by delegating to a registered URLScheme object.

Parameters:

url - The complete URL, including the scheme.

Returns:

An object reference.

Throws:

BAD_PARAM - In case the URL is invalid.

destroy

void destroy()

Invoke destroy() on all registered schemes, and release any resources held by the object.