com.sun.xml.ws.api
Class ResourceLoader

java.lang.Object
  com.sun.xml.ws.api.ResourceLoader

public abstract class ResourceLoader
extends Object

Used to locate resources for jax-ws extensions. Using this, extensions do not to have to write container specific code to locate resources.

Constructor Summary

ResourceLoader()

Method Summary

abstract URL

getResource(String resource) Returns the actual location of the resource from the 'resource' arg that represents a virtual locaion of a file understood by a container.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ResourceLoader

public ResourceLoader()

Method Detail

getResource

public abstract URL getResource(String resource)
                         throws MalformedURLException

Returns the actual location of the resource from the 'resource' arg that represents a virtual locaion of a file understood by a container. ResourceLoader impl for a Container knows how to map this virtual location to actual location.

Extensions can get hold of this object using Container.

for e.g.:

 ResourceLoader loader = container.getSPI(ResourceLoader.class);
 URL catalog = loader.get("jax-ws-catalog.xml");
 

A ResourceLoader for servlet environment, may do the following.

 URL getResource(String resource) {
     return servletContext.getResource("/WEB-INF/"+resource);
 }
 

Parameters:

resource - Designates a path that is understood by the container. The implementations must support "jax-ws-catalog.xml" resource.

Returns:

the actual location, if found, or null if not found.

Throws:

MalformedURLException - if there is an error in creating URL