123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705 |
- #if !BESTHTTP_DISABLE_WEBSOCKET && (!UNITY_WEBGL || UNITY_EDITOR)
- using System;
- using System.IO;
- using System.Threading;
- using System.Collections.Generic;
- using System.Text;
- using BestHTTP.Extensions;
- using BestHTTP.WebSocket.Frames;
- namespace BestHTTP.WebSocket
- {
- public sealed class WebSocketResponse : HTTPResponse, IHeartbeat, IProtocol
- {
- /// <summary>
- /// Capacity of the RTT buffer where the latencies are kept.
- /// </summary>
- public static int RTTBufferCapacity = 5;
- #region Public Interface
- /// <summary>
- /// A reference to the original WebSocket instance. Used for accessing extensions.
- /// </summary>
- public WebSocket WebSocket { get; internal set; }
- /// <summary>
- /// Called when a Text message received
- /// </summary>
- public Action<WebSocketResponse, string> OnText;
- /// <summary>
- /// Called when a Binary message received
- /// </summary>
- public Action<WebSocketResponse, byte[]> OnBinary;
- /// <summary>
- /// Called when an incomplete frame received. No attempt will be made to reassemble these fragments.
- /// </summary>
- public Action<WebSocketResponse, WebSocketFrameReader> OnIncompleteFrame;
- /// <summary>
- /// Called when the connection closed.
- /// </summary>
- public Action<WebSocketResponse, UInt16, string> OnClosed;
- /// <summary>
- /// Indicates whether the connection to the server is closed or not.
- /// </summary>
- public bool IsClosed { get { return closed; } }
- /// <summary>
- /// On what frequency we have to send a ping to the server.
- /// </summary>
- public TimeSpan PingFrequnecy { get; private set; }
- /// <summary>
- /// Maximum size of a fragment's payload data. Its default value is 32767.
- /// </summary>
- public UInt16 MaxFragmentSize { get; private set; }
- /// <summary>
- /// Length of unsent, buffered up data in bytes.
- /// </summary>
- public int BufferedAmount { get { return this._bufferedAmount; } }
- private int _bufferedAmount;
- /// <summary>
- /// Calculated latency from the Round-Trip Times we store in the rtts field.
- /// </summary>
- public int Latency { get; private set; }
- #endregion
- #region Private Fields
- private List<WebSocketFrameReader> IncompleteFrames = new List<WebSocketFrameReader>();
- private List<WebSocketFrameReader> CompletedFrames = new List<WebSocketFrameReader>();
- private List<WebSocketFrameReader> frameCache = new List<WebSocketFrameReader>();
- private WebSocketFrameReader CloseFrame;
- private object FrameLock = new object();
- private object SendLock = new object();
- private List<WebSocketFrame> unsentFrames = new List<WebSocketFrame>();
- private AutoResetEvent newFrameSignal = new AutoResetEvent(false);
- private volatile bool sendThreadCreated = false;
- /// <summary>
- /// True if we sent out a Close message to the server
- /// </summary>
- private volatile bool closeSent;
- /// <summary>
- /// True if this WebSocket connection is closed
- /// </summary>
- private volatile bool closed;
- /// <summary>
- /// When we sent out the last ping.
- /// </summary>
- private DateTime lastPing = DateTime.MinValue;
- /// <summary>
- /// When we received the last pong.
- /// </summary>
- private DateTime lastMessage = DateTime.MinValue;
-
- /// <summary>
- /// A circular buffer to store the last N rtt times calculated by the pong messages.
- /// </summary>
- private CircularBuffer<int> rtts = new CircularBuffer<int>(WebSocketResponse.RTTBufferCapacity);
- #endregion
- internal WebSocketResponse(HTTPRequest request, Stream stream, bool isStreamed, bool isFromCache)
- : base(request, stream, isStreamed, isFromCache)
- {
- base.IsClosedManually = true;
- closed = false;
- MaxFragmentSize = UInt16.MaxValue / 2;
- }
- internal void StartReceive()
- {
- if (IsUpgraded)
- {
- #if NETFX_CORE
- #pragma warning disable 4014
- Windows.System.Threading.ThreadPool.RunAsync(ReceiveThreadFunc);
- #pragma warning restore 4014
- #else
- ThreadPool.QueueUserWorkItem(ReceiveThreadFunc);
- #endif
- }
- }
- internal void CloseStream()
- {
- var conn = HTTPManager.GetConnectionWith(this.baseRequest);
- if (conn != null)
- conn.Abort(HTTPConnectionStates.Closed);
- }
- #region Public interface for interacting with the server
- /// <summary>
- /// It will send the given message to the server in one frame.
- /// </summary>
- public void Send(string message)
- {
- if (message == null)
- throw new ArgumentNullException("message must not be null!");
- byte[] data = System.Text.Encoding.UTF8.GetBytes(message);
- Send(new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.Text, data));
- }
- /// <summary>
- /// It will send the given data to the server in one frame.
- /// </summary>
- public void Send(byte[] data)
- {
- if (data == null)
- throw new ArgumentNullException("data must not be null!");
- WebSocketFrame frame = new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.Binary, data);
- if (frame.Data != null && frame.Data.Length > this.MaxFragmentSize)
- {
- WebSocketFrame[] additionalFrames = frame.Fragment(this.MaxFragmentSize);
- lock(SendLock)
- {
- Send(frame);
- if (additionalFrames != null)
- for (int i = 0; i < additionalFrames.Length; ++i)
- Send(additionalFrames[i]);
- }
- }
- else
- Send(frame);
- }
- /// <summary>
- /// Will send count bytes from a byte array, starting from offset.
- /// </summary>
- public void Send(byte[] data, ulong offset, ulong count)
- {
- if (data == null)
- throw new ArgumentNullException("data must not be null!");
- if (offset + count > (ulong)data.Length)
- throw new ArgumentOutOfRangeException("offset + count >= data.Length");
- WebSocketFrame frame = new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.Binary, data, offset, count, true, true);
- if (frame.Data != null && frame.Data.Length > this.MaxFragmentSize)
- {
- WebSocketFrame[] additionalFrames = frame.Fragment(this.MaxFragmentSize);
- lock (SendLock)
- {
- Send(frame);
- if (additionalFrames != null)
- for (int i = 0; i < additionalFrames.Length; ++i)
- Send(additionalFrames[i]);
- }
- }
- else
- Send(frame);
- }
- /// <summary>
- /// It will send the given frame to the server.
- /// </summary>
- public void Send(WebSocketFrame frame)
- {
- if (frame == null)
- throw new ArgumentNullException("frame is null!");
- if (closed || closeSent)
- return;
- lock (SendLock)
- {
- this.unsentFrames.Add(frame);
- if (!sendThreadCreated)
- {
- HTTPManager.Logger.Information("WebSocketResponse", "Send - Creating thread");
- #if NETFX_CORE
- #pragma warning disable 4014
- Windows.System.Threading.ThreadPool.RunAsync(SendThreadFunc);
- #pragma warning restore 4014
- #else
- ThreadPool.QueueUserWorkItem(SendThreadFunc);
- #endif
- sendThreadCreated = true;
- }
- }
- Interlocked.Add(ref this._bufferedAmount, frame.Data != null ? frame.Data.Length : 0);
- //if (HTTPManager.Logger.Level <= Logger.Loglevels.All)
- // HTTPManager.Logger.Information("WebSocketResponse", "Signaling SendThread!");
- newFrameSignal.Set();
- }
- /// <summary>
- /// It will send the given frame to the server by inserting the frame into the queue as the first element.
- /// </summary>
- public void Insert(WebSocketFrame frame)
- {
- if (frame == null)
- throw new ArgumentNullException("frame is null!");
- if (closed || closeSent)
- return;
- lock (SendLock)
- {
- this.unsentFrames.Insert(0, frame);
- if (!sendThreadCreated)
- {
- HTTPManager.Logger.Information("WebSocketResponse", "Insert - Creating thread");
- #if NETFX_CORE
- #pragma warning disable 4014
- Windows.System.Threading.ThreadPool.RunAsync(SendThreadFunc);
- #pragma warning restore 4014
- #else
- ThreadPool.QueueUserWorkItem(SendThreadFunc);
- #endif
- sendThreadCreated = true;
- }
- }
- Interlocked.Add(ref this._bufferedAmount, frame.Data != null ? frame.Data.Length : 0);
- newFrameSignal.Set();
- }
- public void SendNow(WebSocketFrame frame)
- {
- if (frame == null)
- throw new ArgumentNullException("frame is null!");
- if (closed || closeSent)
- return;
- byte[] rawData = frame.Get();
- Stream.Write(rawData, 0, rawData.Length);
- Stream.Flush();
- }
- /// <summary>
- /// It will initiate the closing of the connection to the server.
- /// </summary>
- public void Close()
- {
- Close(1000, "Bye!");
- }
- /// <summary>
- /// It will initiate the closing of the connection to the server.
- /// </summary>
- public void Close(UInt16 code, string msg)
- {
- if (closed)
- return;
- lock (SendLock)
- this.unsentFrames.Clear();
- Interlocked.Exchange(ref this._bufferedAmount, 0);
- Send(new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.ConnectionClose, WebSocket.EncodeCloseData(code, msg)));
- }
- public void StartPinging(int frequency)
- {
- if (frequency < 100)
- throw new ArgumentException("frequency must be at least 100 milliseconds!");
- PingFrequnecy = TimeSpan.FromMilliseconds(frequency);
- lastMessage = DateTime.UtcNow;
- SendPing();
- HTTPManager.Heartbeats.Subscribe(this);
- HTTPUpdateDelegator.OnApplicationForegroundStateChanged += OnApplicationForegroundStateChanged;
- }
- #endregion
- #region Private Threading Functions
- private void SendThreadFunc(object param)
- {
- List<WebSocketFrame> localFrames = new List<WebSocketFrame>();
- try
- {
- while (!closed && !closeSent)
- {
- //if (HTTPManager.Logger.Level <= Logger.Loglevels.All)
- // HTTPManager.Logger.Information("WebSocketResponse", "SendThread - Waiting...");
- newFrameSignal.WaitOne();
- try
- {
- lock (SendLock)
- {
- // add frames int reversed order
- for (int i = this.unsentFrames.Count - 1; i >= 0; --i)
- localFrames.Add(this.unsentFrames[i]);
- this.unsentFrames.Clear();
- }
- //if (HTTPManager.Logger.Level <= Logger.Loglevels.All)
- // HTTPManager.Logger.Information("WebSocketResponse", "SendThread - Wait is over, " + localFrames.Count.ToString() + " new frames!");
- while (localFrames.Count > 0)
- {
- WebSocketFrame frame = localFrames[localFrames.Count - 1];
- localFrames.RemoveAt(localFrames.Count - 1);
- if (!closeSent)
- {
- byte[] rawData = frame.Get();
- Stream.Write(rawData, 0, rawData.Length);
- if (frame.Type == WebSocketFrameTypes.ConnectionClose)
- closeSent = true;
- }
- Interlocked.Add(ref this._bufferedAmount, -frame.Data.Length);
- }
- Stream.Flush();
- }
- catch(Exception ex)
- {
- if (HTTPUpdateDelegator.IsCreated)
- {
- this.baseRequest.Exception = ex;
- this.baseRequest.State = HTTPRequestStates.Error;
- }
- else
- this.baseRequest.State = HTTPRequestStates.Aborted;
- closed = true;
- }
- }
- }
- finally
- {
- sendThreadCreated = false;
- HTTPManager.Logger.Information("WebSocketResponse", "SendThread - Closed!");
- }
- }
- private void ReceiveThreadFunc(object param)
- {
- try
- {
- while (!closed)
- {
- try
- {
- WebSocketFrameReader frame = new WebSocketFrameReader();
- frame.Read(Stream);
- lastMessage = DateTime.UtcNow;
- // A server MUST NOT mask any frames that it sends to the client. A client MUST close a connection if it detects a masked frame.
- // In this case, it MAY use the status code 1002 (protocol error)
- // (These rules might be relaxed in a future specification.)
- if (frame.HasMask)
- {
- Close(1002, "Protocol Error: masked frame received from server!");
- continue;
- }
- if (!frame.IsFinal)
- {
- if (OnIncompleteFrame == null)
- IncompleteFrames.Add(frame);
- else
- lock (FrameLock) CompletedFrames.Add(frame);
- continue;
- }
- switch (frame.Type)
- {
- // For a complete documentation and rules on fragmentation see http://tools.ietf.org/html/rfc6455#section-5.4
- // A fragmented Frame's last fragment's opcode is 0 (Continuation) and the FIN bit is set to 1.
- case WebSocketFrameTypes.Continuation:
- // Do an assemble pass only if OnFragment is not set. Otherwise put it in the CompletedFrames, we will handle it in the HandleEvent phase.
- if (OnIncompleteFrame == null)
- {
- frame.Assemble(IncompleteFrames);
- // Remove all incomplete frames
- IncompleteFrames.Clear();
- // Control frames themselves MUST NOT be fragmented. So, its a normal text or binary frame. Go, handle it as usual.
- goto case WebSocketFrameTypes.Binary;
- }
- else
- lock (FrameLock) CompletedFrames.Add(frame);
- break;
- case WebSocketFrameTypes.Text:
- case WebSocketFrameTypes.Binary:
- frame.DecodeWithExtensions(WebSocket);
- lock (FrameLock) CompletedFrames.Add(frame);
- break;
- // Upon receipt of a Ping frame, an endpoint MUST send a Pong frame in response, unless it already received a Close frame.
- case WebSocketFrameTypes.Ping:
- if (!closeSent && !closed)
- Send(new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.Pong, frame.Data));
- break;
- case WebSocketFrameTypes.Pong:
- try
- {
- // Get the ticks from the frame's payload
- long ticksSent = BitConverter.ToInt64(frame.Data, 0);
-
- // the difference between the current time and the time when the ping message is sent
- TimeSpan diff = TimeSpan.FromTicks(lastMessage.Ticks - ticksSent);
- // add it to the buffer
- this.rtts.Add((int)diff.TotalMilliseconds);
- // and calculate the new latency
- this.Latency = CalculateLatency();
- }
- catch
- {
- // https://tools.ietf.org/html/rfc6455#section-5.5
- // A Pong frame MAY be sent unsolicited. This serves as a
- // unidirectional heartbeat. A response to an unsolicited Pong frame is
- // not expected.
- }
- break;
- // If an endpoint receives a Close frame and did not previously send a Close frame, the endpoint MUST send a Close frame in response.
- case WebSocketFrameTypes.ConnectionClose:
- CloseFrame = frame;
- if (!closeSent)
- Send(new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.ConnectionClose, null));
- closed = true;
- break;
- }
- }
- #if !NETFX_CORE
- catch (ThreadAbortException)
- {
- IncompleteFrames.Clear();
- this.baseRequest.State = HTTPRequestStates.Aborted;
- closed = true;
- newFrameSignal.Set();
- }
- #endif
- catch (Exception e)
- {
- if (HTTPUpdateDelegator.IsCreated)
- {
- this.baseRequest.Exception = e;
- this.baseRequest.State = HTTPRequestStates.Error;
- }
- else
- this.baseRequest.State = HTTPRequestStates.Aborted;
- closed = true;
- newFrameSignal.Set();
- }
- }
- }
- finally
- {
- HTTPManager.Heartbeats.Unsubscribe(this);
- HTTPUpdateDelegator.OnApplicationForegroundStateChanged -= OnApplicationForegroundStateChanged;
- HTTPManager.Logger.Information("WebSocketResponse", "ReceiveThread - Closed!");
- }
- }
- #endregion
- #region Sending Out Events
- /// <summary>
- /// Internal function to send out received messages.
- /// </summary>
- void IProtocol.HandleEvents()
- {
- frameCache.Clear();
- lock (FrameLock)
- {
- frameCache.AddRange(CompletedFrames);
- CompletedFrames.Clear();
- }
- for (int i = 0; i < frameCache.Count; ++i)
- {
- WebSocketFrameReader frame = frameCache[i];
- // Bugs in the clients shouldn't interrupt the code, so we need to try-catch and ignore any exception occurring here
- try
- {
- switch (frame.Type)
- {
- case WebSocketFrameTypes.Continuation:
- if (OnIncompleteFrame != null)
- OnIncompleteFrame(this, frame);
- break;
- case WebSocketFrameTypes.Text:
- // Any not Final frame is handled as a fragment
- if (!frame.IsFinal)
- goto case WebSocketFrameTypes.Continuation;
- if (OnText != null)
- OnText(this, frame.DataAsText);
- break;
- case WebSocketFrameTypes.Binary:
- // Any not Final frame is handled as a fragment
- if (!frame.IsFinal)
- goto case WebSocketFrameTypes.Continuation;
- if (OnBinary != null)
- OnBinary(this, frame.Data);
- break;
- }
- }
- catch (Exception ex)
- {
- HTTPManager.Logger.Exception("WebSocketResponse", "HandleEvents", ex);
- }
- }
- frameCache.Clear();
- // 2015.05.09
- // State checking added because if there is an error the OnClose called first, and then the OnError.
- // Now, when there is an error only the OnError event will be called!
- if (IsClosed && OnClosed != null && baseRequest.State == HTTPRequestStates.Processing)
- {
- try
- {
- UInt16 statusCode = 0;
- string msg = string.Empty;
- // If we received any data, we will get the status code and the message from it
- if (CloseFrame != null && CloseFrame.Data != null && CloseFrame.Data.Length >= 2)
- {
- if (BitConverter.IsLittleEndian)
- Array.Reverse(CloseFrame.Data, 0, 2);
- statusCode = BitConverter.ToUInt16(CloseFrame.Data, 0);
- if (CloseFrame.Data.Length > 2)
- msg = Encoding.UTF8.GetString(CloseFrame.Data, 2, CloseFrame.Data.Length - 2);
- }
- OnClosed(this, statusCode, msg);
- }
- catch (Exception ex)
- {
- HTTPManager.Logger.Exception("WebSocketResponse", "HandleEvents - OnClosed", ex);
- }
- }
- }
- #endregion
- #region IHeartbeat Implementation
- void IHeartbeat.OnHeartbeatUpdate(TimeSpan dif)
- {
- DateTime now = DateTime.UtcNow;
- if (now - lastPing >= PingFrequnecy)
- SendPing();
- if (now - (lastMessage + this.PingFrequnecy) > this.WebSocket.CloseAfterNoMesssage)
- {
- HTTPManager.Logger.Warning("WebSocketResponse",
- string.Format("No message received in the given time! Closing WebSocket. LastMessage: {0}, PingFrequency: {1}, Close After: {2}, Now: {3}",
- this.lastMessage, this.PingFrequnecy, this.WebSocket.CloseAfterNoMesssage, now));
- CloseWithError("No message received in the given time!");
- }
- }
- #endregion
- private void OnApplicationForegroundStateChanged(bool isPaused)
- {
- if (!isPaused)
- lastMessage = DateTime.UtcNow;
- }
- private void SendPing()
- {
- lastPing = DateTime.UtcNow;
- try
- {
- long ticks = DateTime.UtcNow.Ticks;
- var ticksBytes = BitConverter.GetBytes(ticks);
- var pingFrame = new WebSocketFrame(this.WebSocket, WebSocketFrameTypes.Ping, ticksBytes);
- Insert(pingFrame);
- }
- catch
- {
- HTTPManager.Logger.Information("WebSocketResponse", "Error while sending PING message! Closing WebSocket.");
- CloseWithError("Error while sending PING message!");
- }
- }
- private void CloseWithError(string message)
- {
- this.baseRequest.Exception = new Exception(message);
- this.baseRequest.State = HTTPRequestStates.Error;
- this.closed = true;
- HTTPManager.Heartbeats.Unsubscribe(this);
- HTTPUpdateDelegator.OnApplicationForegroundStateChanged -= OnApplicationForegroundStateChanged;
- newFrameSignal.Set();
- CloseStream();
- }
-
- private int CalculateLatency()
- {
- if (this.rtts.Count == 0)
- return 0;
- int sumLatency = 0;
- for (int i = 0; i < this.rtts.Count; ++i)
- sumLatency += this.rtts[i];
- return sumLatency / this.rtts.Count;
- }
- }
- }
- #endif
|