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-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org