mirror of
https://github.com/ultimatepp/ultimatepp.git
synced 2026-05-17 22:03:07 -06:00
134 lines
No EOL
6 KiB
C++
134 lines
No EOL
6 KiB
C++
topic "WebSocket";
|
|
[2 $$0,0#00000000000000000000000000000000:Default]
|
|
[i448;a25;kKO9;2 $$1,0#37138531426314131252341829483380:class]
|
|
[l288;2 $$2,2#27521748481378242620020725143825:desc]
|
|
[0 $$3,0#96390100711032703541132217272105:end]
|
|
[H6;0 $$4,0#05600065144404261032431302351956:begin]
|
|
[i448;a25;kKO9;2 $$5,0#37138531426314131252341829483370:item]
|
|
[l288;a4;*@5;1 $$6,6#70004532496200323422659154056402:requirement]
|
|
[l288;i1121;b17;O9;~~~.1408;2 $$7,0#10431211400427159095818037425705:param]
|
|
[i448;b42;O9;2 $$8,8#61672508125594000341940100500538:tparam]
|
|
[b42;2 $$9,9#13035079074754324216151401829390:normal]
|
|
[{_}%EN-US
|
|
[ {{10000@(113.42.0) [s0; [*@7;4 WebSocket]]}}&]
|
|
[s3;%- &]
|
|
[s1;:WebSocket`:`:class:%- [@(0.0.255)3 class][3 _][*3 WebSocket]&]
|
|
[s2; Provides the WebSocket protocol support. WebSocket is a wrapper
|
|
over existing TcpSocket connection, which performs server handshake
|
|
by calling WebAccept method.&]
|
|
[s0;i448;a25;kKO9;:noref:@(0.0.255)%- &]
|
|
[ {{10000F(128)G(128)@1 [s0; [* Public Method List]]}}&]
|
|
[s3;%- &]
|
|
[s5;:WebSocket`:`:WebAccept`(TcpSocket`&`,HttpHeader`&`):%- [@(0.0.255) bool]_[* WebAccep
|
|
t]([_^TcpSocket^ TcpSocket][@(0.0.255) `&]_[*@3 socket], [_^HttpHeader^ HttpHeader][@(0.0.255) `&
|
|
]_[*@3 hdr])&]
|
|
[s2; Attempts to open websocket connection with [%-*@3 socket], [%-*@3 hdr]
|
|
is HTTP header read from socket `- prereading allows to distinguish
|
|
between websocket and normal HTTP connection to server.&]
|
|
[s3; &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:WebAccept`(TcpSocket`&`):%- [@(0.0.255) bool]_[* WebAccept]([_^TcpSocket^ T
|
|
cpSocket][@(0.0.255) `&]_[*@3 socket])&]
|
|
[s2; Reads HTTP header from [%-*@3 socket] and calls other WebAccept
|
|
variant.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:RecieveRaw`(`):%- [@(0.0.255) bool]_[* RecieveRaw]()&]
|
|
[s2; Recieves the message. This variant does not automatically handle
|
|
PING and CLOSE messages. Returns true on success.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:Recieve`(`):%- [_^String^ String]_[* Recieve]()&]
|
|
[s2; Recieves the message. PING and CLOSE messages are handled and
|
|
are not returned; PING message is replied with PONG and not reported
|
|
to client `- Recieve does not return and waits for the next message,
|
|
CLOSE is replied by CLOSE and Recieve returns. Returns the content
|
|
of message recieved or String`::GetVoid() if there was none. Note:
|
|
If WaitRead was used to wait for read on socket before calling
|
|
Recieve, returning String`::GetVoid() means that connection was
|
|
broken.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:IsFin`(`):%- [@(0.0.255) bool]_[* IsFin]()&]
|
|
[s2; Returns true if the last message was marked as final.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:GetOpCode`(`)const:%- [@(0.0.255) int]_[* GetOpCode]()_[@(0.0.255) const]&]
|
|
[s2; Returns the websocket opcode of the last recieved message.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:IsText`(`)const:%- [@(0.0.255) bool]_[* IsText]()_[@(0.0.255) const]&]
|
|
[s2; Returns true if the last message recieved was text.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:IsBinary`(`)const:%- [@(0.0.255) bool]_[* IsBinary]()_[@(0.0.255) const]&]
|
|
[s2; Returns true if the last message recieved was binary.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:IsClosed`(`)const:%- [@(0.0.255) bool]_[* IsClosed]()_[@(0.0.255) const]&]
|
|
[s2; Returns true if CLOSE message was recieved.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:GetData`(`)const:%- [_^String^ String]_[* GetData]()_[@(0.0.255) const]&]
|
|
[s2; Returns the content of the last message.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:SendRaw`(int`,const void`*`,int64`):%- [@(0.0.255) bool]_[* SendRaw]([@(0.0.255) i
|
|
nt]_[*@3 hdr], [@(0.0.255) const]_[@(0.0.255) void]_`*[*@3 data], [_^int64^ int64]_[*@3 len])
|
|
&]
|
|
[s2; Sends the message, [%-*@3 hdr] is used as the first byte of websocket
|
|
protocol. Returns true on success.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:SendText`(const void`*`,int64`,bool`):%- [@(0.0.255) bool]_[* SendText](
|
|
[@(0.0.255) const]_[@(0.0.255) void]_`*[*@3 data], [_^int64^ int64]_[*@3 len],
|
|
[@(0.0.255) bool]_[*@3 fin]_`=_[@(0.0.255) true])&]
|
|
[s5;:WebSocket`:`:SendText`(const String`&`,bool`):%- [@(0.0.255) bool]_[* SendText]([@(0.0.255) c
|
|
onst]_[_^String^ String][@(0.0.255) `&]_[*@3 data], [@(0.0.255) bool]_[*@3 fin]_`=_[@(0.0.255) t
|
|
rue])&]
|
|
[s2; Sends the text message. Returns true on success.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:SendBinary`(const void`*`,int64`,bool`):%- [@(0.0.255) bool]_[* SendBin
|
|
ary]([@(0.0.255) const]_[@(0.0.255) void]_`*[*@3 data], [_^int64^ int64]_[*@3 len],
|
|
[@(0.0.255) bool]_[*@3 fin]_`=_[@(0.0.255) true])&]
|
|
[s5;:WebSocket`:`:SendBinary`(const String`&`,bool`):%- [@(0.0.255) bool]_[* SendBinary](
|
|
[@(0.0.255) const]_[_^String^ String][@(0.0.255) `&]_[*@3 data], [@(0.0.255) bool]_[*@3 fin]_
|
|
`=_[@(0.0.255) true])&]
|
|
[s2; Sends the binary message. Returns true on success.&]
|
|
[s3; &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:Close`(`):%- [@(0.0.255) void]_[* Close]()&]
|
|
[s2; Closes the websocket.&]
|
|
[s3; &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:IsOpen`(`)const:%- [@(0.0.255) bool]_[* IsOpen]()_[@(0.0.255) const]&]
|
|
[s2; Returns true if WebSocket is associated with open socket.&]
|
|
[s3;%- &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:IsError`(`)const:%- [@(0.0.255) bool]_[* IsError]()_[@(0.0.255) const]&]
|
|
[s2; Returns true if WebSocket is associated with socket and this
|
|
socket returns IsError.&]
|
|
[s3;%- &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:ClearError`(`):%- [@(0.0.255) void]_[* ClearError]()&]
|
|
[s2; Clears error in associated socket (if any).&]
|
|
[s3;%- &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:GetError`(`)const:%- [@(0.0.255) int]_[* GetError]()_[@(0.0.255) const]&]
|
|
[s2; Returns error`-code in associated socket, or zero if there is
|
|
none.&]
|
|
[s3;%- &]
|
|
[s4;%- &]
|
|
[s5;:WebSocket`:`:GetErrorDesc`(`)const:%- [_^String^ String]_[* GetErrorDesc]()_[@(0.0.255) c
|
|
onst]&]
|
|
[s2; Returns error descroption in associated socket, or empty string
|
|
if there is none.&]
|
|
[s3;%- &]
|
|
[s4; &]
|
|
[s5;:WebSocket`:`:MaxLen`(int64`):%- [_^WebSocket^ WebSocket][@(0.0.255) `&]_[* MaxLen]([_^int64^ i
|
|
nt64]_[*@3 maxlen`_])&]
|
|
[s2; Sets the maximum length of recieved message to [%-*@3 maxlen]
|
|
. Default is 10M.&]
|
|
[s3; &]
|
|
[s0; ]] |