SQL Server

Box.com Streaming Upload File

See more Box Examples

Demonstrates how to upload a file to box.com, streaming the file directly from the filesystem.

Note: This example requires a fix that is included in Chilkat v9.5.0.70 and above.

SQL Server

-- 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)
    DECLARE @success int
    SELECT @success = 0

    -- This requires the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @rest int
    EXEC @hr = sp_OACreate 'Chilkat.Rest', @rest OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    --   Provide a previously obtained OAuth2 access token.
    DECLARE @oauth2 int
    EXEC @hr = sp_OACreate 'Chilkat.OAuth2', @oauth2 OUT

    EXEC sp_OASetProperty @oauth2, 'AccessToken', 'BOX_ACCESS_TOKEN'
    EXEC sp_OAMethod @rest, 'SetAuthOAuth2', @success OUT, @oauth2

    -- First, make the initial connection.
    -- A single REST object, once connected, can be used for many Box REST API calls.
    -- The auto-reconnect indicates that if the already-established HTTPS connection is closed,
    -- then it will be automatically re-established as needed.
    DECLARE @bAutoReconnect int
    SELECT @bAutoReconnect = 1

    -- ----------------------------------------------------------------------
    -- IMPORTANT: Note that the domain is "upload.box.com", not "api.box.com"
    -- ----------------------------------------------------------------------
    EXEC sp_OAMethod @rest, 'Connect', @success OUT, 'upload.box.com', 443, 1, @bAutoReconnect
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @oauth2
        RETURN
      END

    -- The request body uses the "multipart/form-data" format to transmit two "parts". 
    -- The first part is called "attributes" and contains a JSON object with information about the file, including the name of the file 
    -- and the ID of the parent folder. The second part contains the contents of the file. 
    -- (Note that the name of the second "part" is ignored.)

    EXEC sp_OAMethod @rest, 'AddHeader', @success OUT, 'Content-Type', 'multipart/form-data'

    -- Provide the content for each part of the request...

    -- First the JSON attributes.  Use "0" for the root folder.
    --   {"name":"hedgehogs.jpg", "parent":{"id":"0"}}
    DECLARE @jsonAttr int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @jsonAttr OUT

    EXEC sp_OAMethod @jsonAttr, 'UpdateString', @success OUT, 'name', 'hedgehogs.jpg'
    EXEC sp_OAMethod @jsonAttr, 'UpdateString', @success OUT, 'parent.id', '0'

    EXEC sp_OASetProperty @rest, 'PartSelector', '1'
    EXEC sp_OAMethod @rest, 'AddHeader', @success OUT, 'Content-Disposition', 'form-data; name="attributes"; '
    EXEC sp_OAMethod @jsonAttr, 'Emit', @sTmp0 OUT
    EXEC sp_OAMethod @rest, 'SetMultipartBodyString', @success OUT, @sTmp0

    -- The upload will stream directly from a file.
    EXEC sp_OASetProperty @rest, 'PartSelector', '2'
    EXEC sp_OAMethod @rest, 'AddHeader', @success OUT, 'Content-Disposition', 'form-data; name="file"; filename="hedgehogs.jpg"'
    -- "application/octet-stream" can be safely used for any type file..
    EXEC sp_OAMethod @rest, 'AddHeader', @success OUT, 'Content-Type', 'application/octet-stream'

    -- IMPORTANT: This example requires Chilkat v9.5.0.70 or later, for a fix that was made in
    -- multipart/streaming uploads. 
    DECLARE @fileStream int
    EXEC @hr = sp_OACreate 'Chilkat.Stream', @fileStream OUT

    EXEC sp_OASetProperty @fileStream, 'SourceFile', 'qa_data/jpg/hedgehogs.jpg'
    EXEC sp_OAMethod @rest, 'SetMultipartBodyStream', @success OUT, @fileStream

    -- Restore the PartSelector to "0" (for safety, in case something else sends another request on this object)
    EXEC sp_OASetProperty @rest, 'PartSelector', '0'

    -- Send the multipart/form-data request, which uploads the file by streaming directly from the filesystem.
    DECLARE @responseBody nvarchar(4000)
    EXEC sp_OAMethod @rest, 'FullRequestMultipart', @responseBody OUT, 'POST', '/api/2.0/files/content'
    EXEC sp_OAGetProperty @rest, 'LastMethodSuccess', @iTmp0 OUT
    IF @iTmp0 <> 1
      BEGIN
        EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @oauth2
        EXEC @hr = sp_OADestroy @jsonAttr
        EXEC @hr = sp_OADestroy @fileStream
        RETURN
      END

    -- A 201 is received for a successful upload
    EXEC sp_OAGetProperty @rest, 'ResponseStatusCode', @iTmp0 OUT
    IF @iTmp0 <> 201
      BEGIN

        PRINT 'Box.com upload failed.'

        PRINT 'Request header:'
        EXEC sp_OAGetProperty @rest, 'LastRequestHeader', @sTmp0 OUT
        PRINT @sTmp0

        PRINT '---'

        EXEC sp_OAGetProperty @rest, 'ResponseStatusCode', @iTmp0 OUT
        PRINT 'Response status code = ' + @iTmp0

        PRINT 'Response body:'

        PRINT @responseBody
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @oauth2
        EXEC @hr = sp_OADestroy @jsonAttr
        EXEC @hr = sp_OADestroy @fileStream
        RETURN
      END


    PRINT 'File uploaded.'

    EXEC @hr = sp_OADestroy @rest
    EXEC @hr = sp_OADestroy @oauth2
    EXEC @hr = sp_OADestroy @jsonAttr
    EXEC @hr = sp_OADestroy @fileStream


END
GO