blob: df55b6c95fb9b27fb173c0d9c17526a6db21ed5c [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>ClientEndpointConfig.Builder</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="ClientEndpointConfig.Builder";
}
}
catch(err) {
}
//-->
var methods = {"i0":10,"i1":10,"i2":9,"i3":10,"i4":10,"i5":10,"i6":10};
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</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><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">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/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../jakarta/websocket/ClientEndpointConfig.Configurator.html" title="class in jakarta.websocket"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../index.html?jakarta/websocket/ClientEndpointConfig.Builder.html" target="_top">Frames</a></li>
<li><a href="ClientEndpointConfig.Builder.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>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">jakarta.websocket</div>
<h2 title="Class ClientEndpointConfig.Builder" class="title">Class ClientEndpointConfig.Builder</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li>jakarta.websocket.ClientEndpointConfig.Builder</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>Enclosing interface:</dt>
<dd><a href="../../jakarta/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket">ClientEndpointConfig</a></dd>
</dl>
<hr>
<br>
<pre>public static final class <span class="typeNameLabel">ClientEndpointConfig.Builder</span>
extends java.lang.Object</pre>
<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. Here are some examples: Building a plain configuration with no encoders,
decoders, subprotocols or extensions. <code>
ClientEndpointConfig cec = ClientEndpointConfig.Builder.create().build();
</code>
Building a configuration with no subprotocols and a custom configurator.
<pre>
<code>
ClientEndpointConfig customCec = ClientEndpointConfig.Builder.create()
.preferredSubprotocols(mySubprotocols)
.configurator(new MyClientConfigurator())
.build();
</code>
</pre></div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket">ClientEndpointConfig</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#build--">build</a></span>()</code>
<div class="block">Builds a configuration object using the attributes set on this builder.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#configurator-jakarta.websocket.ClientEndpointConfig.Configurator-">configurator</a></span>(<a href="../../jakarta/websocket/ClientEndpointConfig.Configurator.html" title="class in jakarta.websocket">ClientEndpointConfig.Configurator</a>&nbsp;clientEndpointConfigurator)</code>
<div class="block">Sets the configurator object for the configuration this builder will build.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>static <a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#create--">create</a></span>()</code>
<div class="block">Creates a new builder object with no subprotocols, extensions, encoders, decoders and a <code>null</code>
configurator.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#decoders-java.util.List-">decoders</a></span>(java.util.List&lt;java.lang.Class&lt;? extends <a href="../../jakarta/websocket/Decoder.html" title="interface in jakarta.websocket">Decoder</a>&gt;&gt;&nbsp;decoders)</code>
<div class="block">Assign the list of decoder implementation classes the client will use.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#encoders-java.util.List-">encoders</a></span>(java.util.List&lt;java.lang.Class&lt;? extends <a href="../../jakarta/websocket/Encoder.html" title="interface in jakarta.websocket">Encoder</a>&gt;&gt;&nbsp;encoders)</code>
<div class="block">Assign the list of encoder implementation classes the client will use.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#extensions-java.util.List-">extensions</a></span>(java.util.List&lt;<a href="../../jakarta/websocket/Extension.html" title="interface in jakarta.websocket">Extension</a>&gt;&nbsp;extensions)</code>
<div class="block">Set the extensions for the configuration this builder will build.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html#preferredSubprotocols-java.util.List-">preferredSubprotocols</a></span>(java.util.List&lt;java.lang.String&gt;&nbsp;preferredSubprotocols)</code>
<div class="block">Set the preferred sub protocols for the configuration this builder will build.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="create--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>create</h4>
<pre>public static&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;create()</pre>
<div class="block">Creates a new builder object with no subprotocols, extensions, encoders, decoders and a <code>null</code>
configurator.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a new builder object.</dd>
</dl>
</li>
</ul>
<a name="build--">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>build</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket">ClientEndpointConfig</a>&nbsp;build()</pre>
<div class="block">Builds a configuration object using the attributes set on this builder.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a new configuration object.</dd>
</dl>
</li>
</ul>
<a name="configurator-jakarta.websocket.ClientEndpointConfig.Configurator-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>configurator</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;configurator(<a href="../../jakarta/websocket/ClientEndpointConfig.Configurator.html" title="class in jakarta.websocket">ClientEndpointConfig.Configurator</a>&nbsp;clientEndpointConfigurator)</pre>
<div class="block">Sets the configurator object for the configuration this builder will build.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>clientEndpointConfigurator</code> - the configurator</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the builder instance</dd>
</dl>
</li>
</ul>
<a name="preferredSubprotocols-java.util.List-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>preferredSubprotocols</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;preferredSubprotocols(java.util.List&lt;java.lang.String&gt;&nbsp;preferredSubprotocols)</pre>
<div class="block">Set the preferred sub protocols for the configuration this builder will build. The list is treated in order
of preference, favorite first, that this client would like to use for its sessions.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>preferredSubprotocols</code> - the preferred subprotocol names.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the builder instance</dd>
</dl>
</li>
</ul>
<a name="extensions-java.util.List-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>extensions</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;extensions(java.util.List&lt;<a href="../../jakarta/websocket/Extension.html" title="interface in jakarta.websocket">Extension</a>&gt;&nbsp;extensions)</pre>
<div class="block">Set the extensions for the configuration this builder will build. The list is treated in order of preference,
favorite first, that the client would like to use for its sessions.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>extensions</code> - the extensions</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the builder instance</dd>
</dl>
</li>
</ul>
<a name="encoders-java.util.List-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>encoders</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;encoders(java.util.List&lt;java.lang.Class&lt;? extends <a href="../../jakarta/websocket/Encoder.html" title="interface in jakarta.websocket">Encoder</a>&gt;&gt;&nbsp;encoders)</pre>
<div class="block">Assign the list of encoder implementation classes the client will use.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>encoders</code> - the encoder implementation classes</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the builder instance</dd>
</dl>
</li>
</ul>
<a name="decoders-java.util.List-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>decoders</h4>
<pre>public&nbsp;<a href="../../jakarta/websocket/ClientEndpointConfig.Builder.html" title="class in jakarta.websocket">ClientEndpointConfig.Builder</a>&nbsp;decoders(java.util.List&lt;java.lang.Class&lt;? extends <a href="../../jakarta/websocket/Decoder.html" title="interface in jakarta.websocket">Decoder</a>&gt;&gt;&nbsp;decoders)</pre>
<div class="block">Assign the list of decoder implementation classes the client will use.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>decoders</code> - the decoder implementation classes</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>this builder instance</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= 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><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">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/websocket/ClientEndpointConfig.html" title="interface in jakarta.websocket"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../jakarta/websocket/ClientEndpointConfig.Configurator.html" title="class in jakarta.websocket"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../index.html?jakarta/websocket/ClientEndpointConfig.Builder.html" target="_top">Frames</a></li>
<li><a href="ClientEndpointConfig.Builder.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>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</body>
</html>