You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2013/11/20 12:06:59 UTC
svn commit: r1543772 - /tomcat/trunk/webapps/docs/web-socket-howto.xml
Author: markt
Date: Wed Nov 20 11:06:59 2013
New Revision: 1543772
URL: http://svn.apache.org/r1543772
Log:
Clarify purposes of buffers.
Modified:
tomcat/trunk/webapps/docs/web-socket-howto.xml
Modified: tomcat/trunk/webapps/docs/web-socket-howto.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/web-socket-howto.xml?rev=1543772&r1=1543771&r2=1543772&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/web-socket-howto.xml (original)
+++ tomcat/trunk/webapps/docs/web-socket-howto.xml Wed Nov 20 11:06:59 2013
@@ -62,15 +62,23 @@
the timeout to use in milliseconds. For an infinite timeout, use
<code>-1</code>.</p>
-<p>The default buffer size for binary messages is 8192 bytes. This may be
- changed for a web application by setting the servlet context initialization
- parameter <code>org.apache.tomcat.websocket.binaryBufferSize</code> to the
- desired value in bytes.</p>
-
-<p>The default buffer size for text messages is 8192 bytes. This may be
- changed for a web application by setting the servlet context initialization
- parameter <code>org.apache.tomcat.websocket.textBufferSize</code> to the
- desired value in bytes.</p>
+<p>If the application does not define a <code>MessageHandler.Partial</code> for
+ incoming binary messages, any incoming binary messages must be buffered so
+ the entire message can be delivered in a single call to the registered
+ <code>MessageHandler.Whole</code> for binary messages. The default buffer
+ size for binary messages is 8192 bytes. This may be changed for a web
+ application by setting the servlet context initialization parameter
+ <code>org.apache.tomcat.websocket.binaryBufferSize</code> to the desired
+ value in bytes.</p>
+
+<p>If the application does not define a <code>MessageHandler.Partial</code> for
+ incoming text messages, any incoming text messages must be buffered so the
+ entire message can be delivered in a single call to the registered
+ <code>MessageHandler.Whole</code> for text messages. The default buffer size
+ for text messages is 8192 bytes. This may be changed for a web application by
+ setting the servlet context initialization parameter
+ <code>org.apache.tomcat.websocket.textBufferSize</code> to the desired value
+ in bytes.</p>
<p>The Java WebSocket specification 1.0 does not permit programmatic deployment
after the first endpoint has started a WebSocket handshake. By default,
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org