2011-05-24 Yuta Kitamura <yutak@chromium.org>
[WebKit-https.git] / Source / WebCore / websockets / WebSocketChannel.cpp
1 /*
2  * Copyright (C) 2009 Google Inc.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
8  *     * Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  *     * Redistributions in binary form must reproduce the above
11  * copyright notice, this list of conditions and the following disclaimer
12  * in the documentation and/or other materials provided with the
13  * distribution.
14  *     * Neither the name of Google Inc. nor the names of its
15  * contributors may be used to endorse or promote products derived from
16  * this software without specific prior written permission.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29  */
30
31 #include "config.h"
32
33 #if ENABLE(WEB_SOCKETS)
34
35 #include "WebSocketChannel.h"
36
37 #include "CookieJar.h"
38 #include "Document.h"
39 #include "InspectorInstrumentation.h"
40 #include "Logging.h"
41 #include "Page.h"
42 #include "ProgressTracker.h"
43 #include "ScriptCallStack.h"
44 #include "ScriptExecutionContext.h"
45 #include "SocketStreamError.h"
46 #include "SocketStreamHandle.h"
47 #include "WebSocketChannelClient.h"
48 #include "WebSocketHandshake.h"
49
50 #include <wtf/text/CString.h>
51 #include <wtf/text/WTFString.h>
52 #include <wtf/text/StringHash.h>
53 #include <wtf/Deque.h>
54 #include <wtf/FastMalloc.h>
55 #include <wtf/HashMap.h>
56
57 namespace WebCore {
58
59 WebSocketChannel::WebSocketChannel(ScriptExecutionContext* context, WebSocketChannelClient* client, const KURL& url, const String& protocol)
60     : m_context(context)
61     , m_client(client)
62     , m_handshake(url, protocol, context)
63     , m_buffer(0)
64     , m_bufferSize(0)
65     , m_resumeTimer(this, &WebSocketChannel::resumeTimerFired)
66     , m_suspended(false)
67     , m_closed(false)
68     , m_shouldDiscardReceivedData(false)
69     , m_unhandledBufferedAmount(0)
70     , m_identifier(0)
71 {
72     if (m_context->isDocument())
73         if (Page* page = static_cast<Document*>(m_context)->page())
74             m_identifier = page->progress()->createUniqueIdentifier();
75
76     if (m_identifier)
77         InspectorInstrumentation::didCreateWebSocket(m_context, m_identifier, url, m_context->url());
78 }
79
80 WebSocketChannel::~WebSocketChannel()
81 {
82     fastFree(m_buffer);
83 }
84
85 void WebSocketChannel::connect()
86 {
87     LOG(Network, "WebSocketChannel %p connect", this);
88     ASSERT(!m_handle);
89     ASSERT(!m_suspended);
90     m_handshake.reset();
91     ref();
92     m_handle = SocketStreamHandle::create(m_handshake.url(), this);
93 }
94
95 bool WebSocketChannel::send(const String& msg)
96 {
97     LOG(Network, "WebSocketChannel %p send %s", this, msg.utf8().data());
98     ASSERT(m_handle);
99     ASSERT(!m_suspended);
100     Vector<char> buf;
101     buf.append('\0');  // frame type
102     CString utf8 = msg.utf8();
103     buf.append(utf8.data(), utf8.length());
104     buf.append('\xff');  // frame end
105     return m_handle->send(buf.data(), buf.size());
106 }
107
108 unsigned long WebSocketChannel::bufferedAmount() const
109 {
110     LOG(Network, "WebSocketChannel %p bufferedAmount", this);
111     ASSERT(m_handle);
112     ASSERT(!m_suspended);
113     return m_handle->bufferedAmount();
114 }
115
116 void WebSocketChannel::close()
117 {
118     LOG(Network, "WebSocketChannel %p close", this);
119     ASSERT(!m_suspended);
120     if (m_handle)
121         m_handle->close();  // will call didClose()
122 }
123
124 void WebSocketChannel::fail(const String& reason)
125 {
126     LOG(Network, "WebSocketChannel %p fail: %s", this, reason.utf8().data());
127     ASSERT(!m_suspended);
128     if (m_context)
129         m_context->addMessage(JSMessageSource, LogMessageType, ErrorMessageLevel, reason, 0, m_handshake.clientOrigin(), 0);
130     if (m_handle)
131         m_handle->close(); // Will call didClose().
132 }
133
134 void WebSocketChannel::disconnect()
135 {
136     LOG(Network, "WebSocketChannel %p disconnect", this);
137     if (m_identifier && m_context)
138         InspectorInstrumentation::didCloseWebSocket(m_context, m_identifier);
139     m_handshake.clearScriptExecutionContext();
140     m_client = 0;
141     m_context = 0;
142     if (m_handle)
143         m_handle->close();
144 }
145
146 void WebSocketChannel::suspend()
147 {
148     m_suspended = true;
149 }
150
151 void WebSocketChannel::resume()
152 {
153     m_suspended = false;
154     if ((m_buffer || m_closed) && m_client && !m_resumeTimer.isActive())
155         m_resumeTimer.startOneShot(0);
156 }
157
158 void WebSocketChannel::didOpen(SocketStreamHandle* handle)
159 {
160     LOG(Network, "WebSocketChannel %p didOpen", this);
161     ASSERT(handle == m_handle);
162     if (!m_context)
163         return;
164     if (m_identifier)
165         InspectorInstrumentation::willSendWebSocketHandshakeRequest(m_context, m_identifier, m_handshake.clientHandshakeRequest());
166     CString handshakeMessage = m_handshake.clientHandshakeMessage();
167     if (!handle->send(handshakeMessage.data(), handshakeMessage.length())) {
168         m_context->addMessage(JSMessageSource, LogMessageType, ErrorMessageLevel, "Error sending handshake message.", 0, m_handshake.clientOrigin(), 0);
169         handle->close();
170     }
171 }
172
173 void WebSocketChannel::didClose(SocketStreamHandle* handle)
174 {
175     LOG(Network, "WebSocketChannel %p didClose", this);
176     if (m_identifier && m_context)
177         InspectorInstrumentation::didCloseWebSocket(m_context, m_identifier);
178     ASSERT_UNUSED(handle, handle == m_handle || !m_handle);
179     m_closed = true;
180     if (m_handle) {
181         m_unhandledBufferedAmount = m_handle->bufferedAmount();
182         if (m_suspended)
183             return;
184         WebSocketChannelClient* client = m_client;
185         m_client = 0;
186         m_context = 0;
187         m_handle = 0;
188         if (client)
189             client->didClose(m_unhandledBufferedAmount);
190     }
191     deref();
192 }
193
194 void WebSocketChannel::didReceiveData(SocketStreamHandle* handle, const char* data, int len)
195 {
196     LOG(Network, "WebSocketChannel %p didReceiveData %d", this, len);
197     RefPtr<WebSocketChannel> protect(this); // The client can close the channel, potentially removing the last reference.
198     ASSERT(handle == m_handle);
199     if (!m_context) {
200         return;
201     }
202     if (!m_client) {
203         m_shouldDiscardReceivedData = true;
204         handle->close();
205         return;
206     }
207     if (m_shouldDiscardReceivedData)
208         return;
209     if (!appendToBuffer(data, len)) {
210         m_shouldDiscardReceivedData = true;
211         handle->close();
212         return;
213     }
214     while (!m_suspended && m_client && m_buffer)
215         if (!processBuffer())
216             break;
217 }
218
219 void WebSocketChannel::didFail(SocketStreamHandle* handle, const SocketStreamError& error)
220 {
221     LOG(Network, "WebSocketChannel %p didFail", this);
222     ASSERT(handle == m_handle || !m_handle);
223     if (m_context) {
224         String message;
225         if (error.isNull())
226             message = "WebSocket network error";
227         else if (error.localizedDescription().isNull())
228             message = "WebSocket network error: error code " + String::number(error.errorCode());
229         else
230             message = "WebSocket network error: " + error.localizedDescription();
231         String failingURL = error.failingURL();
232         ASSERT(failingURL.isNull() || m_handshake.url().string() == failingURL);
233         if (failingURL.isNull())
234             failingURL = m_handshake.url().string();
235         m_context->addMessage(OtherMessageSource, NetworkErrorMessageType, ErrorMessageLevel, message, 0, failingURL, 0);
236     }
237     m_shouldDiscardReceivedData = true;
238     handle->close();
239 }
240
241 void WebSocketChannel::didReceiveAuthenticationChallenge(SocketStreamHandle*, const AuthenticationChallenge&)
242 {
243 }
244
245 void WebSocketChannel::didCancelAuthenticationChallenge(SocketStreamHandle*, const AuthenticationChallenge&)
246 {
247 }
248
249 bool WebSocketChannel::appendToBuffer(const char* data, size_t len)
250 {
251     size_t newBufferSize = m_bufferSize + len;
252     if (newBufferSize < m_bufferSize) {
253         LOG(Network, "WebSocket buffer overflow (%lu+%lu)", static_cast<unsigned long>(m_bufferSize), static_cast<unsigned long>(len));
254         return false;
255     }
256     char* newBuffer = 0;
257     if (tryFastMalloc(newBufferSize).getValue(newBuffer)) {
258         if (m_buffer)
259             memcpy(newBuffer, m_buffer, m_bufferSize);
260         memcpy(newBuffer + m_bufferSize, data, len);
261         fastFree(m_buffer);
262         m_buffer = newBuffer;
263         m_bufferSize = newBufferSize;
264         return true;
265     }
266     m_context->addMessage(JSMessageSource, LogMessageType, ErrorMessageLevel, "WebSocket frame (at " + String::number(static_cast<unsigned long>(newBufferSize)) + " bytes) is too long.", 0, m_handshake.clientOrigin(), 0);
267     return false;
268 }
269
270 void WebSocketChannel::skipBuffer(size_t len)
271 {
272     ASSERT(len <= m_bufferSize);
273     m_bufferSize -= len;
274     if (!m_bufferSize) {
275         fastFree(m_buffer);
276         m_buffer = 0;
277         return;
278     }
279     memmove(m_buffer, m_buffer + len, m_bufferSize);
280 }
281
282 bool WebSocketChannel::processBuffer()
283 {
284     ASSERT(!m_suspended);
285     ASSERT(m_client);
286     ASSERT(m_buffer);
287     if (m_shouldDiscardReceivedData)
288         return false;
289
290     if (m_handshake.mode() == WebSocketHandshake::Incomplete) {
291         int headerLength = m_handshake.readServerHandshake(m_buffer, m_bufferSize);
292         if (headerLength <= 0)
293             return false;
294         if (m_handshake.mode() == WebSocketHandshake::Connected) {
295             if (m_identifier)
296                 InspectorInstrumentation::didReceiveWebSocketHandshakeResponse(m_context, m_identifier, m_handshake.serverHandshakeResponse());
297             if (!m_handshake.serverSetCookie().isEmpty()) {
298                 if (m_context->isDocument()) {
299                     Document* document = static_cast<Document*>(m_context);
300                     if (cookiesEnabled(document)) {
301                         ExceptionCode ec; // Exception (for sandboxed documents) ignored.
302                         document->setCookie(m_handshake.serverSetCookie(), ec);
303                     }
304                 }
305             }
306             // FIXME: handle set-cookie2.
307             LOG(Network, "WebSocketChannel %p connected", this);
308             skipBuffer(headerLength);
309             m_client->didConnect();
310             LOG(Network, "remaining in read buf %lu", static_cast<unsigned long>(m_bufferSize));
311             return m_buffer;
312         }
313         LOG(Network, "WebSocketChannel %p connection failed", this);
314         skipBuffer(headerLength);
315         m_shouldDiscardReceivedData = true;
316         if (!m_closed)
317             m_handle->close();
318         return false;
319     }
320     if (m_handshake.mode() != WebSocketHandshake::Connected)
321         return false;
322
323     const char* nextFrame = m_buffer;
324     const char* p = m_buffer;
325     const char* end = p + m_bufferSize;
326
327     unsigned char frameByte = static_cast<unsigned char>(*p++);
328     if ((frameByte & 0x80) == 0x80) {
329         size_t length = 0;
330         bool errorFrame = false;
331         while (p < end) {
332             if (length > std::numeric_limits<size_t>::max() / 128) {
333                 LOG(Network, "frame length overflow %lu", static_cast<unsigned long>(length));
334                 errorFrame = true;
335                 break;
336             }
337             size_t newLength = length * 128;
338             unsigned char msgByte = static_cast<unsigned char>(*p);
339             unsigned int lengthMsgByte = msgByte & 0x7f;
340             if (newLength > std::numeric_limits<size_t>::max() - lengthMsgByte) {
341                 LOG(Network, "frame length overflow %lu+%u", static_cast<unsigned long>(newLength), lengthMsgByte);
342                 errorFrame = true;
343                 break;
344             }
345             newLength += lengthMsgByte;
346             if (newLength < length) { // sanity check
347                 LOG(Network, "frame length integer wrap %lu->%lu", static_cast<unsigned long>(length), static_cast<unsigned long>(newLength));
348                 errorFrame = true;
349                 break;
350             }
351             length = newLength;
352             ++p;
353             if (!(msgByte & 0x80))
354                 break;
355         }
356         if (p + length < p) {
357             LOG(Network, "frame buffer pointer wrap %p+%lu->%p", p, static_cast<unsigned long>(length), p + length);
358             errorFrame = true;
359         }
360         if (errorFrame) {
361             skipBuffer(m_bufferSize); // Save memory.
362             m_shouldDiscardReceivedData = true;
363             m_client->didReceiveMessageError();
364             if (!m_client)
365                 return false;
366             if (!m_closed)
367                 m_handle->close();
368             return false;
369         }
370         ASSERT(p + length >= p);
371         if (p + length < end) {
372             p += length;
373             nextFrame = p;
374             ASSERT(nextFrame > m_buffer);
375             skipBuffer(nextFrame - m_buffer);
376             m_client->didReceiveMessageError();
377             return m_buffer;
378         }
379         return false;
380     }
381
382     const char* msgStart = p;
383     while (p < end && *p != '\xff')
384         ++p;
385     if (p < end && *p == '\xff') {
386         int msgLength = p - msgStart;
387         ++p;
388         nextFrame = p;
389         if (frameByte == 0x00) {
390             String msg = String::fromUTF8(msgStart, msgLength);
391             skipBuffer(nextFrame - m_buffer);
392             m_client->didReceiveMessage(msg);
393         } else {
394             skipBuffer(nextFrame - m_buffer);
395             m_client->didReceiveMessageError();
396         }
397         return m_buffer;
398     }
399     return false;
400 }
401
402 void WebSocketChannel::resumeTimerFired(Timer<WebSocketChannel>* timer)
403 {
404     ASSERT_UNUSED(timer, timer == &m_resumeTimer);
405
406     RefPtr<WebSocketChannel> protect(this); // The client can close the channel, potentially removing the last reference.
407     while (!m_suspended && m_client && m_buffer)
408         if (!processBuffer())
409             break;
410     if (!m_suspended && m_client && m_closed && m_handle)
411         didClose(m_handle.get());
412 }
413
414 }  // namespace WebCore
415
416 #endif  // ENABLE(WEB_SOCKETS)