com.sun.xml.ws.api.server
Class Container

java.lang.Object
  com.sun.xml.ws.api.server.Container

Direct Known Subclasses:

ClientContainer, ServletContainer

public abstract class Container
extends Object

Root of the SPI implemented by the container (such as application server.)

Often technologies that are built on top of JAX-WS (such as Tango) needs to negotiate private contracts between them and the container. This interface allows such technologies to query the negotiated SPI by using the getSPI(Class).

For example, if a security pipe needs to get some information from a container, they can do the following:

1. Negotiate an interface with the container and define it. (let's call it ContainerSecuritySPI.)
2. The container will implement ContainerSecuritySPI.
3. At the runtime, a security pipe gets WSEndpoint and then to Container.
4. It calls container.getSPI(ContainerSecuritySPI.class)
5. The container returns an instance of ContainerSecuritySPI.
6. The security pipe talks to the container through this SPI.

This protects JAX-WS from worrying about the details of such contracts, while still providing the necessary service of hooking up those parties.

Technologies that run inside JAX-WS server runtime can access this object through WSEndpoint.getContainer(). In the client runtime, it can be accessed from ContainerResolver.getContainer()

See Also:

WSEndpoint

Field Summary

static Container

NONE Constant that represents a "no Container", which always returns null from getSPI(Class).

Constructor Summary

protected

Container() For derived classes.

Method Summary

abstract <T> T

getSPI(Class<T> spiType) Gets the specified SPI.

Methods inherited from class java.lang.Object

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

Field Detail

NONE

public static final Container NONE

Constant that represents a "no Container", which always returns null from getSPI(Class).

Constructor Detail

Container

protected Container()

For derived classes.

Method Detail

getSPI

public abstract <T> T getSPI(Class<T> spiType)

Gets the specified SPI.

This method works as a kind of directory service for SPIs between technologies on top of JAX-WS and the container.

Parameters:

spiType - Always non-null.

Returns:

null if such an SPI is not implemented by this container.