/******************************************************************************* * Copyright (c) 2011 Intalio, Inc. * ====================================================================== * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * and Apache License v2.0 which accompanies this distribution. * * The Eclipse Public License is available at * http://www.eclipse.org/legal/epl-v10.html * * The Apache License v2.0 is available at * http://www.opensource.org/licenses/apache2.0.php * * You may elect to redistribute this code under either of these licenses. *******************************************************************************/ // ======================================================================== // Copyright (c) 2010 Mort Bay Consulting Pty. Ltd. // ------------------------------------------------------------------------ // All rights reserved. This program and the accompanying materials // are made available under the terms of the Eclipse Public License v1.0 // and Apache License v2.0 which accompanies this distribution. // The Eclipse Public License is available at // http://www.eclipse.org/legal/epl-v10.html // The Apache License v2.0 is available at // http://www.opensource.org/licenses/apache2.0.php // You may elect to redistribute this code under either of these licenses. // ======================================================================== package org.eclipse.jetty.websocket; import java.io.IOException; import java.io.UnsupportedEncodingException; import java.security.MessageDigest; import java.util.Collections; import java.util.List; import org.eclipse.jetty.io.AbstractConnection; import org.eclipse.jetty.io.AsyncEndPoint; import org.eclipse.jetty.io.Buffer; import org.eclipse.jetty.io.ByteArrayBuffer; import org.eclipse.jetty.io.Connection; import org.eclipse.jetty.io.EndPoint; import org.eclipse.jetty.util.B64Code; import org.eclipse.jetty.util.StringUtil; import org.eclipse.jetty.util.Utf8StringBuilder; import org.eclipse.jetty.util.log.Log; import org.eclipse.jetty.util.log.Logger; import org.eclipse.jetty.websocket.WebSocket.OnBinaryMessage; import org.eclipse.jetty.websocket.WebSocket.OnControl; import org.eclipse.jetty.websocket.WebSocket.OnFrame; import org.eclipse.jetty.websocket.WebSocket.OnTextMessage; public class WebSocketConnectionD08 extends AbstractConnection implements WebSocketConnection { private static final Logger LOG = Log.getLogger(WebSocketConnectionD08.class); final static byte OP_CONTINUATION = 0x00; final static byte OP_TEXT = 0x01; final static byte OP_BINARY = 0x02; final static byte OP_EXT_DATA = 0x03; final static byte OP_CONTROL = 0x08; final static byte OP_CLOSE = 0x08; final static byte OP_PING = 0x09; final static byte OP_PONG = 0x0A; final static byte OP_EXT_CTRL = 0x0B; final static int CLOSE_NORMAL=1000; final static int CLOSE_SHUTDOWN=1001; final static int CLOSE_PROTOCOL=1002; final static int CLOSE_BADDATA=1003; final static int CLOSE_NOCODE=1005; final static int CLOSE_NOCLOSE=1006; final static int CLOSE_NOTUTF8=1007; final static int FLAG_FIN=0x8; final static int VERSION=8; static boolean isLastFrame(byte flags) { return (flags&FLAG_FIN)!=0; } static boolean isControlFrame(byte opcode) { return (opcode&OP_CONTROL)!=0; } private final static byte[] MAGIC; private final List<Extension> _extensions; private final WebSocketParserD08 _parser; private final WebSocketParser.FrameHandler _inbound; private final WebSocketGeneratorD08 _generator; private final WebSocketGenerator _outbound; private final WebSocket _webSocket; private final OnFrame _onFrame; private final OnBinaryMessage _onBinaryMessage; private final OnTextMessage _onTextMessage; private final OnControl _onControl; private final String _protocol; private final int _draft; private final ClassLoader _context; private volatile int _closeCode; private volatile String _closeMessage; private volatile boolean _closedIn; private volatile boolean _closedOut; private int _maxTextMessageSize=-1; private int _maxBinaryMessageSize=-1; static { try { MAGIC="258EAFA5-E914-47DA-95CA-C5AB0DC85B11".getBytes(StringUtil.__ISO_8859_1); } catch (UnsupportedEncodingException e) { throw new RuntimeException(e); } } private final WebSocketParser.FrameHandler _frameHandler= new WSFrameHandler(); private final WebSocket.FrameConnection _connection = new WSFrameConnection(); /* ------------------------------------------------------------ */ public WebSocketConnectionD08(WebSocket websocket, EndPoint endpoint, WebSocketBuffers buffers, long timestamp, int maxIdleTime, String protocol, List<Extension> extensions,int draft) throws IOException { this(websocket,endpoint,buffers,timestamp,maxIdleTime,protocol,extensions,draft,null); } /* ------------------------------------------------------------ */ public WebSocketConnectionD08(WebSocket websocket, EndPoint endpoint, WebSocketBuffers buffers, long timestamp, int maxIdleTime, String protocol, List<Extension> extensions,int draft, MaskGen maskgen) throws IOException { super(endpoint,timestamp); _context=Thread.currentThread().getContextClassLoader(); _draft=draft; _endp.setMaxIdleTime(maxIdleTime); _webSocket = websocket; _onFrame=_webSocket instanceof OnFrame ? (OnFrame)_webSocket : null; _onTextMessage=_webSocket instanceof OnTextMessage ? (OnTextMessage)_webSocket : null; _onBinaryMessage=_webSocket instanceof OnBinaryMessage ? (OnBinaryMessage)_webSocket : null; _onControl=_webSocket instanceof OnControl ? (OnControl)_webSocket : null; _generator = new WebSocketGeneratorD08(buffers, _endp,maskgen); _extensions=extensions; if (_extensions!=null) { int e=0; for (Extension extension : _extensions) { extension.bind( _connection, e==extensions.size()-1?_frameHandler:extensions.get(e+1), e==0?_generator:extensions.get(e-1)); e++; } } _outbound=(_extensions==null||_extensions.size()==0)?_generator:extensions.get(extensions.size()-1); _inbound=(_extensions==null||_extensions.size()==0)?_frameHandler:extensions.get(0); _parser = new WebSocketParserD08(buffers, endpoint,_inbound,maskgen==null); _protocol=protocol; } /* ------------------------------------------------------------ */ public WebSocket.Connection getConnection() { return _connection; } /* ------------------------------------------------------------ */ public List<Extension> getExtensions() { if (_extensions==null) return Collections.emptyList(); return _extensions; } /* ------------------------------------------------------------ */ public Connection handle() throws IOException { Thread current = Thread.currentThread(); ClassLoader oldcontext = current.getContextClassLoader(); current.setContextClassLoader(_context); try { // handle the framing protocol boolean progress=true; while (progress) { int flushed=_generator.flushBuffer(); int filled=_parser.parseNext(); progress = flushed>0 || filled>0; if (filled<0 || flushed<0) { _endp.close(); break; } } } catch(IOException e) { try { _endp.close(); } catch(IOException e2) { LOG.ignore(e2); } throw e; } finally { current.setContextClassLoader(oldcontext); _parser.returnBuffer(); _generator.returnBuffer(); if (_endp.isOpen()) { if (_closedIn && _closedOut && _outbound.isBufferEmpty()) _endp.close(); else if (_endp.isInputShutdown() && !_closedIn) closeIn(CLOSE_NOCLOSE,null); else checkWriteable(); } } return this; } /* ------------------------------------------------------------ */ public void onInputShutdown() throws IOException { // TODO } /* ------------------------------------------------------------ */ public boolean isIdle() { return _parser.isBufferEmpty() && _outbound.isBufferEmpty(); } /* ------------------------------------------------------------ */ @Override public void onIdleExpired(long idleForMs) { closeOut(WebSocketConnectionD08.CLOSE_NORMAL,"Idle for "+idleForMs+"ms > "+_endp.getMaxIdleTime()+"ms"); } /* ------------------------------------------------------------ */ public boolean isSuspended() { return false; } /* ------------------------------------------------------------ */ public void onClose() { final boolean closed; synchronized (this) { closed=_closeCode==0; if (closed) _closeCode=WebSocketConnectionD08.CLOSE_NOCLOSE; } if (closed) _webSocket.onClose(WebSocketConnectionD08.CLOSE_NOCLOSE,"closed"); } /* ------------------------------------------------------------ */ public void closeIn(int code,String message) { LOG.debug("ClosedIn {} {}",this,message); final boolean closedOut; final boolean closed; synchronized (this) { closedOut=_closedOut; _closedIn=true; closed=_closeCode==0; if (closed) { _closeCode=code; _closeMessage=message; } } try { if (closed) _webSocket.onClose(code,message); } finally { try { if (closedOut) _endp.close(); else closeOut(code,message); } catch(IOException e) { LOG.ignore(e); } } } /* ------------------------------------------------------------ */ public void closeOut(int code,String message) { LOG.debug("ClosedOut {} {}",this,message); final boolean close; final boolean closed; synchronized (this) { close=_closedIn || _closedOut; _closedOut=true; closed=_closeCode==0; if (closed) { _closeCode=code; _closeMessage=message; } } try { if (closed) _webSocket.onClose(code,message); } finally { try { if (close) _endp.close(); else { if (code<=0) code=WebSocketConnectionD08.CLOSE_NORMAL; byte[] bytes = ("xx"+(message==null?"":message)).getBytes(StringUtil.__ISO_8859_1); bytes[0]=(byte)(code/0x100); bytes[1]=(byte)(code%0x100); _outbound.addFrame((byte)FLAG_FIN,WebSocketConnectionD08.OP_CLOSE,bytes,0,bytes.length); } _outbound.flush(); } catch(IOException e) { LOG.ignore(e); } } } public void shutdown() { final WebSocket.Connection connection = _connection; if (connection != null) connection.close(CLOSE_SHUTDOWN, null); } /* ------------------------------------------------------------ */ public void fillBuffersFrom(Buffer buffer) { _parser.fill(buffer); } /* ------------------------------------------------------------ */ private void checkWriteable() { if (!_outbound.isBufferEmpty() && _endp instanceof AsyncEndPoint) { ((AsyncEndPoint)_endp).scheduleWrite(); } } protected void onFrameHandshake() { if (_onFrame != null) { _onFrame.onHandshake(_connection); } } protected void onWebSocketOpen() { _webSocket.onOpen(_connection); } /* ------------------------------------------------------------ */ private class WSFrameConnection implements WebSocket.FrameConnection { volatile boolean _disconnecting; /* ------------------------------------------------------------ */ public void sendMessage(String content) throws IOException { if (_closedOut) throw new IOException("closedOut "+_closeCode+":"+_closeMessage); byte[] data = content.getBytes(StringUtil.__UTF8); _outbound.addFrame((byte)FLAG_FIN,WebSocketConnectionD08.OP_TEXT,data,0,data.length); checkWriteable(); } /* ------------------------------------------------------------ */ public void sendMessage(byte[] content, int offset, int length) throws IOException { if (_closedOut) throw new IOException("closedOut "+_closeCode+":"+_closeMessage); _outbound.addFrame((byte)FLAG_FIN,WebSocketConnectionD08.OP_BINARY,content,offset,length); checkWriteable(); } /* ------------------------------------------------------------ */ public void sendFrame(byte flags,byte opcode, byte[] content, int offset, int length) throws IOException { if (_closedOut) throw new IOException("closedOut "+_closeCode+":"+_closeMessage); _outbound.addFrame(flags,opcode,content,offset,length); checkWriteable(); } /* ------------------------------------------------------------ */ public void sendControl(byte ctrl, byte[] data, int offset, int length) throws IOException { if (_closedOut) throw new IOException("closedOut "+_closeCode+":"+_closeMessage); _outbound.addFrame((byte)FLAG_FIN,ctrl,data,offset,length); checkWriteable(); } /* ------------------------------------------------------------ */ public boolean isMessageComplete(byte flags) { return isLastFrame(flags); } /* ------------------------------------------------------------ */ public boolean isOpen() { return _endp!=null&&_endp.isOpen(); } /* ------------------------------------------------------------ */ public void close(int code, String message) { if (_disconnecting) return; _disconnecting=true; WebSocketConnectionD08.this.closeOut(code,message); } /* ------------------------------------------------------------ */ public void setMaxIdleTime(int ms) { try { _endp.setMaxIdleTime(ms); } catch(IOException e) { LOG.warn(e); } } /* ------------------------------------------------------------ */ public void setMaxTextMessageSize(int size) { _maxTextMessageSize=size; } /* ------------------------------------------------------------ */ public void setMaxBinaryMessageSize(int size) { _maxBinaryMessageSize=size; } /* ------------------------------------------------------------ */ public int getMaxIdleTime() { return _endp.getMaxIdleTime(); } /* ------------------------------------------------------------ */ public int getMaxTextMessageSize() { return _maxTextMessageSize; } /* ------------------------------------------------------------ */ public int getMaxBinaryMessageSize() { return _maxBinaryMessageSize; } /* ------------------------------------------------------------ */ public String getProtocol() { return _protocol; } /* ------------------------------------------------------------ */ public byte binaryOpcode() { return OP_BINARY; } /* ------------------------------------------------------------ */ public byte textOpcode() { return OP_TEXT; } /* ------------------------------------------------------------ */ public byte continuationOpcode() { return OP_CONTINUATION; } /* ------------------------------------------------------------ */ public byte finMask() { return FLAG_FIN; } /* ------------------------------------------------------------ */ public boolean isControl(byte opcode) { return isControlFrame(opcode); } /* ------------------------------------------------------------ */ public boolean isText(byte opcode) { return opcode==OP_TEXT; } /* ------------------------------------------------------------ */ public boolean isBinary(byte opcode) { return opcode==OP_BINARY; } /* ------------------------------------------------------------ */ public boolean isContinuation(byte opcode) { return opcode==OP_CONTINUATION; } /* ------------------------------------------------------------ */ public boolean isClose(byte opcode) { return opcode==OP_CLOSE; } /* ------------------------------------------------------------ */ public boolean isPing(byte opcode) { return opcode==OP_PING; } /* ------------------------------------------------------------ */ public boolean isPong(byte opcode) { return opcode==OP_PONG; } /* ------------------------------------------------------------ */ public void disconnect() { close(); } /* ------------------------------------------------------------ */ public void close() { close(CLOSE_NORMAL,null); } /* ------------------------------------------------------------ */ public void setAllowFrameFragmentation(boolean allowFragmentation) { _parser.setFakeFragments(allowFragmentation); } /* ------------------------------------------------------------ */ public boolean isAllowFrameFragmentation() { return _parser.isFakeFragments(); } /* ------------------------------------------------------------ */ @Override public String toString() { return this.getClass().getSimpleName()+"D08@"+_endp.getLocalAddr()+":"+_endp.getLocalPort()+"<->"+_endp.getRemoteAddr()+":"+_endp.getRemotePort(); } } /* ------------------------------------------------------------ */ /* ------------------------------------------------------------ */ /* ------------------------------------------------------------ */ private class WSFrameHandler implements WebSocketParser.FrameHandler { private final Utf8StringBuilder _utf8 = new Utf8StringBuilder(); private ByteArrayBuffer _aggregate; private byte _opcode=-1; public void onFrame(final byte flags, final byte opcode, final Buffer buffer) { boolean lastFrame = isLastFrame(flags); synchronized(WebSocketConnectionD08.this) { // Ignore incoming after a close if (_closedIn) return; } try { byte[] array=buffer.array(); // Deliver frame if websocket is a FrameWebSocket if (_onFrame!=null) { if (_onFrame.onFrame(flags,opcode,array,buffer.getIndex(),buffer.length())) return; } if (_onControl!=null && isControlFrame(opcode)) { if (_onControl.onControl(opcode,array,buffer.getIndex(),buffer.length())) return; } switch(opcode) { case WebSocketConnectionD08.OP_CONTINUATION: { // If text, append to the message buffer if (_onTextMessage!=null && _opcode==WebSocketConnectionD08.OP_TEXT) { if (_utf8.append(buffer.array(),buffer.getIndex(),buffer.length(),_connection.getMaxTextMessageSize())) { // If this is the last fragment, deliver the text buffer if (lastFrame) { _opcode=-1; String msg =_utf8.toString(); _utf8.reset(); _onTextMessage.onMessage(msg); } } else textMessageTooLarge(); } if (_opcode>=0 && _connection.getMaxBinaryMessageSize()>=0) { if (checkBinaryMessageSize(_aggregate.length(),buffer.length())) { _aggregate.put(buffer); // If this is the last fragment, deliver if (lastFrame && _onBinaryMessage!=null) { try { _onBinaryMessage.onMessage(_aggregate.array(),_aggregate.getIndex(),_aggregate.length()); } finally { _opcode=-1; _aggregate.clear(); } } } } break; } case WebSocketConnectionD08.OP_PING: { LOG.debug("PING {}",this); if (!_closedOut) _connection.sendControl(WebSocketConnectionD08.OP_PONG,buffer.array(),buffer.getIndex(),buffer.length()); break; } case WebSocketConnectionD08.OP_PONG: { LOG.debug("PONG {}",this); break; } case WebSocketConnectionD08.OP_CLOSE: { int code=WebSocketConnectionD08.CLOSE_NOCODE; String message=null; if (buffer.length()>=2) { code=buffer.array()[buffer.getIndex()]*0x100+buffer.array()[buffer.getIndex()+1]; if (buffer.length()>2) message=new String(buffer.array(),buffer.getIndex()+2,buffer.length()-2,StringUtil.__UTF8); } closeIn(code,message); break; } case WebSocketConnectionD08.OP_TEXT: { if(_onTextMessage!=null) { if (_connection.getMaxTextMessageSize()<=0) { // No size limit, so handle only final frames if (lastFrame) _onTextMessage.onMessage(buffer.toString(StringUtil.__UTF8)); else { LOG.warn("Frame discarded. Text aggregation disabled for {}",_endp); _connection.close(WebSocketConnectionD08.CLOSE_BADDATA,"Text frame aggregation disabled"); } } // append bytes to message buffer (if they fit) else if (_utf8.append(buffer.array(),buffer.getIndex(),buffer.length(),_connection.getMaxTextMessageSize())) { if (lastFrame) { String msg =_utf8.toString(); _utf8.reset(); _onTextMessage.onMessage(msg); } else { _opcode=WebSocketConnectionD08.OP_TEXT; } } else textMessageTooLarge(); } break; } default: { if (_onBinaryMessage!=null && checkBinaryMessageSize(0,buffer.length())) { if (lastFrame) { _onBinaryMessage.onMessage(array,buffer.getIndex(),buffer.length()); } else if (_connection.getMaxBinaryMessageSize()>=0) { _opcode=opcode; if (_aggregate==null) _aggregate=new ByteArrayBuffer(_connection.getMaxBinaryMessageSize()); _aggregate.put(buffer); } else { LOG.warn("Frame discarded. Binary aggregation disabed for {}",_endp); _connection.close(WebSocketConnectionD08.CLOSE_BADDATA,"Binary frame aggregation disabled"); } } } } } catch(Throwable th) { LOG.warn(th); } } private boolean checkBinaryMessageSize(int bufferLen, int length) { int max = _connection.getMaxBinaryMessageSize(); if (max>0 && (bufferLen+length)>max) { LOG.warn("Binary message too large > {}B for {}",_connection.getMaxBinaryMessageSize(),_endp); _connection.close(WebSocketConnectionD08.CLOSE_BADDATA,"Message size > "+_connection.getMaxBinaryMessageSize()); _opcode=-1; if (_aggregate!=null) _aggregate.clear(); return false; } return true; } private void textMessageTooLarge() { LOG.warn("Text message too large > {} chars for {}",_connection.getMaxTextMessageSize(),_endp); _connection.close(WebSocketConnectionD08.CLOSE_BADDATA,"Text message size > "+_connection.getMaxTextMessageSize()+" chars"); _opcode=-1; _utf8.reset(); } public void close(int code,String message) { if (code!=CLOSE_NORMAL) LOG.warn("Close: "+code+" "+message); _connection.close(code,message); } @Override public String toString() { return WebSocketConnectionD08.this.toString()+"FH"; } } /* ------------------------------------------------------------ */ public static String hashKey(String key) { try { MessageDigest md = MessageDigest.getInstance("SHA1"); md.update(key.getBytes("UTF-8")); md.update(MAGIC); return new String(B64Code.encode(md.digest())); } catch (Exception e) { throw new RuntimeException(e); } } /* ------------------------------------------------------------ */ @Override public String toString() { return String.format("WS/D%d p=%s g=%s", _draft, _parser, _generator); } }