blob: b58011d49bf6a61aae5fb633139c416a97e1dc69 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<title>jakarta.websocket</title>
<link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="jakarta.websocket";
}
}
catch(err) {
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../overview-summary.html">Overview</a></li>
<li class="navBarCell1Rev">Package</li>
<li>Class</li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../index-all.html">Index</a></li>
<li><a href="../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../jakarta/transaction/package-summary.html">Prev&nbsp;Package</a></li>
<li><a href="../../jakarta/websocket/server/package-summary.html">Next&nbsp;Package</a></li>
</ul>
<ul class="navList">
<li><a href="../../index.html?jakarta/websocket/package-summary.html" target="_top">Frames</a></li>
<li><a href="package-summary.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<div class="header">
<h1 title="Package" class="title">Package&nbsp;jakarta.websocket</h1>
<div class="docSummary">
<div class="block">This package contains all the Jakartq WebSocket APIs common to both the client and server side.</div>
</div>
<p>See:&nbsp;<a href="#package.description">Description</a></p>
</div>
<div class="contentContainer">
<ul class="blockList">
<li class="blockList">
<table class="typeSummary" border="0" cellpadding="3" cellspacing="0" summary="Interface Summary table, listing interfaces, and an explanation">
<caption><span>Interface Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Interface</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket">ClientEndpointConfig</a></td>
<td class="colLast">
<div class="block">The ClientEndpointConfig is a special kind of endpoint configuration object that contains web socket configuration
information specific only to client endpoints.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/CloseReason.CloseCode.html" title="interface in jakarta.websocket">CloseReason.CloseCode</a></td>
<td class="colLast">
<div class="block">A marker interface for the close codes.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Decoder.html" title="interface in jakarta.websocket">Decoder</a></td>
<td class="colLast">
<div class="block">The Decoder interface holds member interfaces that define how a developer can provide the web socket container a way
web socket messages into developer defined custom objects.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Decoder.Binary.html" title="interface in jakarta.websocket">Decoder.Binary</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how a custom object (of type T) is decoded from a web socket message in the form of a byte
buffer.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Decoder.BinaryStream.html" title="interface in jakarta.websocket">Decoder.BinaryStream</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how a custom object is decoded from a web socket message in the form of a binary stream.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Decoder.Text.html" title="interface in jakarta.websocket">Decoder.Text</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how a custom object is decoded from a web socket message in the form of a string.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Decoder.TextStream.html" title="interface in jakarta.websocket">Decoder.TextStream</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how a custom object of type T is decoded from a web socket message in the form of a
character stream.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Encoder.html" title="interface in jakarta.websocket">Encoder</a></td>
<td class="colLast">
<div class="block">The Encoder interface defines how developers can provide a way to convert their custom objects into web socket
messages.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Encoder.Binary.html" title="interface in jakarta.websocket">Encoder.Binary</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how to provide a way to convert a custom object into a binary message.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Encoder.BinaryStream.html" title="interface in jakarta.websocket">Encoder.BinaryStream</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface may be implemented by encoding algorithms that want to write the encoded object to a binary
stream.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Encoder.Text.html" title="interface in jakarta.websocket">Encoder.Text</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface defines how to provide a way to convert a custom object into a text message.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Encoder.TextStream.html" title="interface in jakarta.websocket">Encoder.TextStream</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This interface may be implemented by encoding algorithms that want to write the encoded object to a character
stream.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/EndpointConfig.html" title="interface in jakarta.websocket">EndpointConfig</a></td>
<td class="colLast">
<div class="block">The endpoint configuration contains all the information needed during the handshake process for this end point.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/Extension.html" title="interface in jakarta.websocket">Extension</a></td>
<td class="colLast">
<div class="block">A simple representation of a websocket extension as a name and map of extension parameters.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Extension.Parameter.html" title="interface in jakarta.websocket">Extension.Parameter</a></td>
<td class="colLast">
<div class="block">This member interface defines a single websocket extension parameter.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/HandshakeResponse.html" title="interface in jakarta.websocket">HandshakeResponse</a></td>
<td class="colLast">
<div class="block">The handshake response represents the WebSocket-defined HTTP response that is the response to the opening handshake
request.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/MessageHandler.html" title="interface in jakarta.websocket">MessageHandler</a></td>
<td class="colLast">
<div class="block">Developers implement MessageHandlers in order to receive incoming messages during a web socket conversation.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/MessageHandler.Partial.html" title="interface in jakarta.websocket">MessageHandler.Partial</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This kind of handler is notified by the implementation as it becomes ready to deliver parts of a whole message.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/MessageHandler.Whole.html" title="interface in jakarta.websocket">MessageHandler.Whole</a>&lt;T&gt;</td>
<td class="colLast">
<div class="block">This kind of handler is notified by the container on arrival of a complete message.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/PongMessage.html" title="interface in jakarta.websocket">PongMessage</a></td>
<td class="colLast">
<div class="block">The PongMessage interface represents a web socket pong.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/RemoteEndpoint.html" title="interface in jakarta.websocket">RemoteEndpoint</a></td>
<td class="colLast">
<div class="block">The RemoteEndpoint object is supplied by the container and represents the 'other end' or peer of the Web Socket
conversation.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/RemoteEndpoint.Async.html" title="interface in jakarta.websocket">RemoteEndpoint.Async</a></td>
<td class="colLast">
<div class="block">This representation of the peer of a web socket conversation has the ability to send messages asynchronously.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/RemoteEndpoint.Basic.html" title="interface in jakarta.websocket">RemoteEndpoint.Basic</a></td>
<td class="colLast">
<div class="block">This representation of the peer of a web socket conversation has the ability to send messages synchronously.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/SendHandler.html" title="interface in jakarta.websocket">SendHandler</a></td>
<td class="colLast">
<div class="block">A simple callback object for asynchronous sending of web socket messages.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Session.html" title="interface in jakarta.websocket">Session</a></td>
<td class="colLast">
<div class="block">A Web Socket session represents a conversation between two web socket endpoints.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/WebSocketContainer.html" title="interface in jakarta.websocket">WebSocketContainer</a></td>
<td class="colLast">
<div class="block">A WebSocketContainer is an implementation provided object that provides applications a view on the container running
it.</div>
</td>
</tr>
</tbody>
</table>
</li>
<li class="blockList">
<table class="typeSummary" border="0" cellpadding="3" cellspacing="0" summary="Class Summary table, listing classes, and an explanation">
<caption><span>Class Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Class</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></td>
<td class="colLast">
<div class="block">The ClientEndpointConfig.Builder is a class used for creating <a href="../../jakarta/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket"><code>ClientEndpointConfig</code></a> objects for the
purposes of deploying a client endpoint.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/ClientEndpointConfig.Configurator.html" title="class in jakarta.websocket">ClientEndpointConfig.Configurator</a></td>
<td class="colLast">
<div class="block">The Configurator class may be extended by developers who want to provide custom configuration algorithms, such as
intercepting the opening handshake, or providing arbitrary methods and algorithms that can be accessed from each
endpoint instance configured with this configurator.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/CloseReason.html" title="class in jakarta.websocket">CloseReason</a></td>
<td class="colLast">
<div class="block">A class encapsulating the reason why a web socket has been closed, or why it is being asked to close.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/ContainerProvider.html" title="class in jakarta.websocket">ContainerProvider</a></td>
<td class="colLast">
<div class="block">Provider class that allows the developer to get a reference to the implementation of the WebSocketContainer.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/Endpoint.html" title="class in jakarta.websocket">Endpoint</a></td>
<td class="colLast">
<div class="block">The Web Socket Endpoint represents an object that can handle websocket conversations.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/SendResult.html" title="class in jakarta.websocket">SendResult</a></td>
<td class="colLast">
<div class="block">The result of asynchronously sending a web socket message.</div>
</td>
</tr>
</tbody>
</table>
</li>
<li class="blockList">
<table class="typeSummary" border="0" cellpadding="3" cellspacing="0" summary="Enum Summary table, listing enums, and an explanation">
<caption><span>Enum Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Enum</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/CloseReason.CloseCodes.html" title="enum in jakarta.websocket">CloseReason.CloseCodes</a></td>
<td class="colLast">
<div class="block">An Enumeration of status codes for a web socket close that are defined in the specification.</div>
</td>
</tr>
</tbody>
</table>
</li>
<li class="blockList">
<table class="typeSummary" border="0" cellpadding="3" cellspacing="0" summary="Exception Summary table, listing exceptions, and an explanation">
<caption><span>Exception Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Exception</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/DecodeException.html" title="class in jakarta.websocket">DecodeException</a></td>
<td class="colLast">
<div class="block">A general exception that occurs when trying to decode a custom object from a text or binary message.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/DeploymentException.html" title="class in jakarta.websocket">DeploymentException</a></td>
<td class="colLast">
<div class="block">Checked exception indicating some kind of failure either to publish an endpoint on its server, or a failure to
connect a client to its server.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/EncodeException.html" title="class in jakarta.websocket">EncodeException</a></td>
<td class="colLast">
<div class="block">A general exception that occurs when trying to encode a custom object to a string or binary message.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/SessionException.html" title="class in jakarta.websocket">SessionException</a></td>
<td class="colLast">
<div class="block">A SessionException represents a general exception type reporting problems occurring on a websocket session.</div>
</td>
</tr>
</tbody>
</table>
</li>
<li class="blockList">
<table class="typeSummary" border="0" cellpadding="3" cellspacing="0" summary="Annotation Types Summary table, listing annotation types, and an explanation">
<caption><span>Annotation Types Summary</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Annotation Type</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/ClientEndpoint.html" title="annotation in jakarta.websocket">ClientEndpoint</a></td>
<td class="colLast">
<div class="block">The ClientEndpoint annotation a class level annotation is used to denote that a POJO is a web socket client and can
be deployed as such.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/OnClose.html" title="annotation in jakarta.websocket">OnClose</a></td>
<td class="colLast">
<div class="block">This method level annotation can be used to decorate a Java method that wishes to be called when a web socket session
is closing.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/OnError.html" title="annotation in jakarta.websocket">OnError</a></td>
<td class="colLast">
<div class="block">This method level annotation can be used to decorate a Java method that wishes to be called in order to handle
errors.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><a href="../../jakarta/websocket/OnMessage.html" title="annotation in jakarta.websocket">OnMessage</a></td>
<td class="colLast">
<div class="block">This method level annotation can be used to make a Java method receive incoming web socket messages.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><a href="../../jakarta/websocket/OnOpen.html" title="annotation in jakarta.websocket">OnOpen</a></td>
<td class="colLast">
<div class="block">This method level annotation can be used to decorate a Java method that wishes to be called when a new web socket
session is open.</div>
</td>
</tr>
</tbody>
</table>
</li>
</ul>
<a name="package.description">
<!-- -->
</a>
<h2 title="Package jakarta.websocket Description">Package jakarta.websocket Description</h2>
<div class="block">This package contains all the Jakartq WebSocket APIs common to both the client and server side.</div>
</div>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../overview-summary.html">Overview</a></li>
<li class="navBarCell1Rev">Package</li>
<li>Class</li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../index-all.html">Index</a></li>
<li><a href="../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../jakarta/transaction/package-summary.html">Prev&nbsp;Package</a></li>
<li><a href="../../jakarta/websocket/server/package-summary.html">Next&nbsp;Package</a></li>
</ul>
<ul class="navList">
<li><a href="../../index.html?jakarta/websocket/package-summary.html" target="_top">Frames</a></li>
<li><a href="package-summary.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</body>
</html>