Top Description Constructors Methods
jakarta.websocket

public abstract Class ContainerProvider

extends Object
Class Inheritance
Imports
java.util.Iterator, .ServiceConfigurationError, .ServiceLoader

Provider class that allows the developer to get a reference to the implementation of the WebSocketContainer. The provider class uses the ServiceLoader to load an implementation of ContainerProvider. Specifically, the fully qualified class name of the container implementation of ContainerProvider must be listed in the "META-INF/services/jakarta.websocket.ContainerProvider" file in the implementation JAR file.
Author
dannycoward

Constructor Summary

AccessConstructor and Description
public

Method Summary

Modifier and TypeMethod and Description
protected abstract WebSocketContainer

Returns:

the new instance
getContainer
()

Create a new instance of the the WebSocket container implementation.

public static WebSocketContainer

Returns:

an implementation provided instance of type WebSocketContainer
getWebSocketContainer
()

Obtain a new instance of a WebSocketContainer.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

ContainerProviderback to summary
public ContainerProvider()

Method Detail

getContainerback to summary
protected abstract WebSocketContainer getContainer()

Create a new instance of the the WebSocket container implementation.

Returns:WebSocketContainer

the new instance

getWebSocketContainerback to summary
public static WebSocketContainer getWebSocketContainer()

Obtain a new instance of a WebSocketContainer. The method looks for the ContainerProvider implementation class in the order listed in the "META-INF/services/jakarta.websocket.ContainerProvider" file, returning the first WebSocketContainer implementation from the ContainerProvider implementation that is not null.

Returns:WebSocketContainer

an implementation provided instance of type WebSocketContainer

Exceptions
ServiceConfigurationError:
If there is a problem loading one of the discovered ContainerProvider implementations. A ServiceConfigurationError is viewed as a serious problem so the exception is allowed to propagate rather than swallowing the exception and attempting to load the next provider (if any).