(SQL Server) WebSocket Send/Receive Binary Data

Demonstrates how to send and receive binary data on a websocket. This example uses Chilkat's websocket test echo server at ws://websockets.chilkat.io/wsChilkatEcho.ashx

Note: The websockets.chilkat.io server imposes the following limitations:
Messages must be 16K or less, and each connection is limited to a max of 16 echoed messages.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    -- This example requires the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @ws int
    -- Use "Chilkat_9_5_0.WebSocket" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.WebSocket', @ws OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    -- For brevity, this example does not check for errors when etablishing the WebSocket connection.
    -- See Establish WebSocket Connection for more complete sample code for making the connection.

    DECLARE @rest int
    -- Use "Chilkat_9_5_0.Rest" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.Rest', @rest OUT

    -- Connect to websockets.chilkat.io
    -- IMPORTANT: websockets.chilkat.io accepts frames of up to 16K in size and echoes them back.
    -- IMPORTANT: The websockets.chilkat.io server imposes the following limitations: 
    -- ---------- Messages must be 16K or less, and each connection is limited to a max of 16 echoed messages.
    DECLARE @success int
    EXEC sp_OAMethod @rest, 'Connect', @success OUT, 'websockets.chilkat.io', 80, 0, 0
    EXEC sp_OAMethod @ws, 'UseConnection', @success OUT, @rest
    EXEC sp_OAMethod @ws, 'AddClientHeaders', @success OUT
    DECLARE @responseBodyIgnored nvarchar(4000)
    EXEC sp_OAMethod @rest, 'FullRequestNoBody', @responseBodyIgnored OUT, 'GET', '/wsChilkatEcho.ashx'
    EXEC sp_OAMethod @ws, 'ValidateServerHandshake', @success OUT
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @ws, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ws
        EXEC @hr = sp_OADestroy @rest
        RETURN
      END

    -- This example sends a small JPG file (about 7KB) in a websocket frame.
    DECLARE @jpgData int
    -- Use "Chilkat_9_5_0.BinData" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.BinData', @jpgData OUT

    EXEC sp_OAMethod @jpgData, 'LoadFile', @success OUT, 'qa_data/jpg/starfish.jpg'


    EXEC sp_OAGetProperty @jpgData, 'NumBytes', @iTmp0 OUT
    PRINT 'Number of bytes to send = ' + @iTmp0

    -- Send a frame containing the JPG image data.
    -- This will be the first and final frame, and therefore this constitutes the entire message.
    DECLARE @finalFrame int
    SELECT @finalFrame = 1
    EXEC sp_OAMethod @ws, 'SendFrameBd', @success OUT, @jpgData, @finalFrame
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @ws, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ws
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @jpgData
        RETURN
      END

    -- Read the echoed binary frame(s).
    -- (We sent the JPG file in a single frame, but we may receive the echo in multiple frames, but it will be one message.)
    -- Read an incoming frames until we receive the final frame.
    DECLARE @receivedFinalFrame int
    SELECT @receivedFinalFrame = 0
    WHILE @receivedFinalFrame = 0
      BEGIN

        -- The ws object is accumulating the received data internally.  Once we get the final frame, we'll get the 
        -- accumulated data which should constitute the entire JPG.
        EXEC sp_OAMethod @ws, 'ReadFrame', @success OUT
        IF @success <> 1
          BEGIN

            PRINT 'Failed to receive a frame'

            EXEC sp_OAGetProperty @ws, 'ReadFrameFailReason', @iTmp0 OUT
            PRINT 'ReadFrame fail reason = ' + @iTmp0
            EXEC sp_OAGetProperty @ws, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
            EXEC @hr = sp_OADestroy @ws
            EXEC @hr = sp_OADestroy @rest
            EXEC @hr = sp_OADestroy @jpgData
            RETURN
          END

        EXEC sp_OAGetProperty @ws, 'FinalFrame', @receivedFinalFrame OUT

        -- Show the opcode and final frame bit for the frame just received:

        EXEC sp_OAGetProperty @ws, 'FrameOpcode', @sTmp0 OUT
        PRINT 'Frame opcode: ' + @sTmp0

        PRINT 'Final frame: ' + @receivedFinalFrame
      END

    -- Get the accumulated received data.
    DECLARE @jpgReceivedData int
    -- Use "Chilkat_9_5_0.BinData" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.BinData', @jpgReceivedData OUT

    EXEC sp_OAMethod @ws, 'GetFrameDataBd', @success OUT, @jpgReceivedData

    EXEC sp_OAGetProperty @jpgReceivedData, 'NumBytes', @iTmp0 OUT

    PRINT 'Received ' + @iTmp0 + ' bytes'

    -- Save the received JPG to a file so we can check it..
    EXEC sp_OAMethod @jpgReceivedData, 'WriteFile', @success OUT, 'qa_output/starfish_ws.jpg'

    -- Close the websocket connection.
    EXEC sp_OAMethod @ws, 'SendClose', @success OUT, 1, 1000, 'Closing this websocket.'
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @ws, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ws
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @jpgData
        EXEC @hr = sp_OADestroy @jpgReceivedData
        RETURN
      END

    -- Read the Close response.
    EXEC sp_OAMethod @ws, 'ReadFrame', @success OUT
    IF @success <> 1
      BEGIN

        EXEC sp_OAGetProperty @ws, 'ReadFrameFailReason', @iTmp0 OUT
        PRINT 'ReadFrame fail reason = ' + @iTmp0
        EXEC sp_OAGetProperty @ws, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @ws
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @jpgData
        EXEC @hr = sp_OADestroy @jpgReceivedData
        RETURN
      END

    -- Should receive the "Close" opcode.

    EXEC sp_OAGetProperty @ws, 'FrameOpcode', @sTmp0 OUT
    PRINT 'Received opcode: ' + @sTmp0
    -- Should be the same status code we sent (1000)

    EXEC sp_OAGetProperty @ws, 'CloseStatusCode', @iTmp0 OUT
    PRINT 'Received close status code: ' + @iTmp0
    -- The server may echo the close reason.  If not, this will be empty.

    EXEC sp_OAGetProperty @ws, 'CloseReason', @sTmp0 OUT
    PRINT 'Echoed close reason: ' + @sTmp0


    PRINT 'Success.'

    EXEC @hr = sp_OADestroy @ws
    EXEC @hr = sp_OADestroy @rest
    EXEC @hr = sp_OADestroy @jpgData
    EXEC @hr = sp_OADestroy @jpgReceivedData


END
GO