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

java.lang.Object
  extended by com.sun.xml.ws.api.server.Module
All Implemented Interfaces:
Component
Direct Known Subclasses:
WebModule

public abstract class Module
extends Object
implements Component

Represents an object scoped to the current "module" (like a JavaEE web appliation).

This object can be obtained from Container.getSPI(Class).

The scope of the module is driven by W3CEndpointReferenceBuilder.build()'s requirement that we need to identify a WSEndpoint that has a specific service/port name.

For JavaEE containers this should be scoped to a JavaEE application. For other environment, this could be scoped to any similar notion. If no such notion is available, the implementation of Container can return a new Module object each time Container.getSPI(Class) is invoked.

There's a considerable overlap between this and HttpAdapterList. The SPI really needs to be reconsidered

Since:
2.1 EA3
See Also:
Container

Constructor Summary
Module()
           
 
Method Summary
abstract  List<BoundEndpoint> getBoundEndpoints()
          Gets the list of BoundEndpoint deployed in this module.
<S> S
getSPI(Class<S> spiType)
          Gets the specified SPI.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Module

public Module()
Method Detail

getBoundEndpoints

@NotNull
public abstract List<BoundEndpoint> getBoundEndpoints()
Gets the list of BoundEndpoint deployed in this module.

From the point of view of the Module implementation, it really only needs to provide a List object as a data store. JAX-WS will update this list accordingly.

Returns:
always return the same non-null instance.

getSPI

@Nullable
public <S> S getSPI(@NotNull
                             Class<S> spiType)
Description copied from interface: Component
Gets the specified SPI.

This method works as a kind of directory service for SPIs, allowing various components to define private contract and talk to each other.

Specified by:
getSPI in interface Component
Returns:
null if such an SPI is not provided by this object.


Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.