1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
{-# LANGUAGE OverloadedStrings, DeriveGeneric, GeneralizedNewtypeDeriving, FlexibleContexts, FlexibleInstances #-}
module WebSockets (
runClientApp,
clientApp,
protocolError,
relayFromSocket,
relayToSocket,
negotiateWireVersion,
WireProtocol(..),
Mode(..),
ClientSends(..),
ServerSends(..),
) where
import Types
import SessionID
import Network.WebSockets hiding (Message)
import Control.Concurrent.STM
import Control.Concurrent.Async
import Control.Exception
import GHC.Generics (Generic)
import Data.Aeson (FromJSON, ToJSON)
import qualified Data.Aeson
import qualified Data.Binary
import qualified Data.Text as T
import qualified Data.ByteString.Lazy as L
import Data.List
import Data.Monoid
runClientApp :: ClientApp () -> IO ()
runClientApp app = catchJust catchconnclosed
(runClient "localhost" 8081 "/" app)
(\_ -> return ())
where
-- For some reason, runClient throws ConnectionClosed
-- when the server hangs up cleanly. Catch this unwanted exception.
catchconnclosed ConnectionClosed = Just ()
catchconnclosed _ = Nothing
-- | Make a client that sends and receives LogMessages over a websocket.
clientApp
:: Mode
-> (sent -> LogMessage)
-> (LogMessage -> Maybe received)
-> (TChan sent -> TChan received -> SessionID -> IO a)
-> ClientApp a
clientApp mode mksent filterreceived a conn = do
_v <- negotiateWireVersion conn
sendBinaryData conn (SelectMode ClientSends mode)
r <- receiveData conn
case r of
Ready ServerSends sid -> bracket setup cleanup (go sid)
WireProtocolError e -> error e
_ -> protocolError conn "Did not get expected Ready message from server"
where
setup = do
schan <- newTChanIO
rchan <- newTChanIO
sthread <- async $ relayFromSocket conn $ \v ->
case filterreceived v of
Nothing -> return ()
Just r -> atomically $ writeTChan rchan r
rthread <- async $ relayToSocket conn $
Just . mksent <$> atomically (readTChan schan)
return (schan, rchan, sthread, rthread)
cleanup (_, _, sthread, rthread) = do
sendBinaryData conn Done
cancel sthread
cancel rthread
go sid (schan, rchan, _, _) = a schan rchan sid
relayFromSocket :: Connection -> (LogMessage -> IO ()) -> IO ()
relayFromSocket conn sender = go
where
go = do
r <- receiveData conn
case r of
LogMessage msg -> do
sender msg
go
Done -> return ()
WireProtocolError e -> protocolError conn e
_ -> protocolError conn "Protocol error"
relayToSocket :: Connection -> (IO (Maybe LogMessage)) -> IO ()
relayToSocket conn getter = go
where
go = do
mmsg <- getter
case mmsg of
Nothing -> go
Just msg -> do
sendBinaryData conn (LogMessage msg)
go
-- | Framing protocol used over a websocket connection.
--
-- This is an asynchronous protocol; both client and server can send
-- messages at the same time.
--
-- Messages that only one can send are tagged with ClientSends or
-- ServerSends.
data WireProtocol
= Version [WireVersion]
| SelectMode ClientSends Mode
| Ready ServerSends SessionID
| LogMessage LogMessage
| Done
| WireProtocolError String
data ServerSends = ServerSends
data ClientSends = ClientSends
instance WebSocketsData WireProtocol where
toLazyByteString (Version v) = "V" <> Data.Aeson.encode v
toLazyByteString (SelectMode _ m) = "M" <> Data.Aeson.encode m
toLazyByteString (Ready _ sid) = "R" <> Data.Aeson.encode sid
toLazyByteString (LogMessage msg) = "L" <> Data.Binary.encode msg
toLazyByteString Done = "D"
toLazyByteString (WireProtocolError s) = "E" <> Data.Aeson.encode s
fromLazyByteString b = case L.splitAt 1 b of
("V", v) -> maybe (WireProtocolError "invalid JSON in Version")
Version
(Data.Aeson.decode v)
("M", m) -> maybe (WireProtocolError "invalid JSON in Mode")
(SelectMode ClientSends)
(Data.Aeson.decode m)
("R", sid) -> maybe (WireProtocolError "invalid JSON in SessionID")
(Ready ServerSends)
(Data.Aeson.decode sid)
("L", l) -> case Data.Binary.decodeOrFail l of
Left (_, _, err) -> WireProtocolError $ "Binary decode error: " ++ err
Right (_, _, msg) -> LogMessage msg
("D", "") -> Done
("E", s) -> maybe (WireProtocolError "invalid JSON in WireProtocolError")
WireProtocolError
(Data.Aeson.decode s)
_ -> WireProtocolError "received unknown websocket message"
protocolError :: Connection -> String -> IO a
protocolError conn err = do
sendBinaryData conn (WireProtocolError err)
sendClose conn Done
error err
newtype WireVersion = WireVersion T.Text
deriving (Show, Eq, Generic, Ord)
instance FromJSON WireVersion
instance ToJSON WireVersion
supportedWireVersions :: [WireVersion]
supportedWireVersions = [WireVersion "1"]
-- | Send supportedWireVersions and at the same time receive it from
-- the remote side. The highest version present in both lists will be used.
negotiateWireVersion :: Connection -> IO WireVersion
negotiateWireVersion conn = do
(_, resp) <- concurrently
(sendBinaryData conn $ Version supportedWireVersions)
(receiveData conn)
case resp of
Version remoteversions -> case reverse (intersect (sort supportedWireVersions) (sort remoteversions)) of
(v:_) -> return v
[] -> protocolError conn $
"Unable to negotiate protocol Version. I support: " ++ show supportedWireVersions ++ " They support: " ++ show remoteversions
_ -> protocolError conn "Protocol error, did not receive Version"
-- | Modes of operation that can be requested for a websocket connection.
data Mode
= InitMode T.Text -- ^ Text is unused, but reserved for expansion
| ConnectMode T.Text -- ^ Text specifies the SessionID to connect to
deriving (Show, Eq, Generic)
instance FromJSON Mode
instance ToJSON Mode where
|