(PureBasic) Azure Service Bus - Delete Message

See more Azure Service Bus Examples

Deletes a message from a queue or subscription.

For more information, see https://docs.microsoft.com/en-us/rest/api/servicebus/unlock-message

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkRest.pb"
IncludeFile "CkStringBuilder.pb"

Procedure ChilkatExample()

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

    ; Make the initial connection.
    ; A single REST object, once connected, can be used for many Azure Service Bus 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.
    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    bAutoReconnect.i = 1
    success.i = CkRest::ckConnect(rest,"<yournamespace>.servicebus.windows.net",443,1,bAutoReconnect)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        ProcedureReturn
    EndIf

    ; Let's load a previously computed SAS token and use it.
    ; See Azure Shared Access Signature for an example to genenerate an Azure SAS token.
    sbToken.i = CkStringBuilder::ckCreate()
    If sbToken.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckLoadFile(sbToken,"qa_data/tokens/serviceBusSas.txt","utf-8")

    ; Tell the REST object to use the Azure Shared Access Signature for authorization.
    CkStringBuilder::ckPrepend(sbToken,"SharedAccessSignature ")
    CkRest::ckAddHeader(rest,"Authorization",CkStringBuilder::ckGetAsString(sbToken))

    ; ----------------------------------------------------------------------------------------------
    ; The code above this comment could be placed inside a function/subroutine within the application
    ; because the connection does not need to be made for every request.  Once the connection is made
    ; the app may send many requests..
    ; ----------------------------------------------------------------------------------------------

    ; To delete a message, we'll need either the SequenceNumber or MessageId.
    ; When the message was peek-locked, the SequenceNumber and MessageId of the locked message
    ; was returned in the HTTP response header named "BrokerProperties, which contained
    ; JSON such as the following:
    ; 
    ; 	{
    ; 	  "DeliveryCount": 1,
    ; 	  "EnqueuedSequenceNumber": 3000004,
    ; 	  "EnqueuedTimeUtc": "Wed, 07 Dec 2016 17:42:48 GMT",
    ; 	  "Label": "M3",
    ; 	  "LockToken": "6eeee205-e541-4cb6-95fb-4c81da5f6858",
    ; 	  "LockedUntilUtc": "Thu, 08 Dec 2016 00:57:32 GMT",
    ; 	  "MessageId": "e8028116d63c43f191577f2789b1cca7",
    ; 	  "SequenceNumber": 4,
    ; 	  "State": "Active",
    ; 	  "TimeToLive": 922337193600
    ; 	}
    ; 
    ; 
    ; The path for unlocking a message is constructed as follows, depending on
    ; whether it is a message on a queue or subscription:
    ; 
    ; (for a queue)
    ; /{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}
    ; 
    ; (for a subscription)
    ; /{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}

    ; This example will build a path to delete a message contained in a subscription.
    topicName.s = "gilaMonster"
    subscriptionName.s = "feedings"
    messageId.s = "e8028116d63c43f191577f2789b1cca7"
    lockToken.s = "6eeee205-e541-4cb6-95fb-4c81da5f6858"

    ; Build the path..
    sbPath.i = CkStringBuilder::ckCreate()
    If sbPath.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppend(sbPath,"/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}")
    numReplaced.i = CkStringBuilder::ckReplace(sbPath,"{topicPath}",topicName)
    numReplaced = CkStringBuilder::ckReplace(sbPath,"{subscriptionName}",subscriptionName)
    numReplaced = CkStringBuilder::ckReplace(sbPath,"{messageId|sequenceNumber}",messageId)
    numReplaced = CkStringBuilder::ckReplace(sbPath,"{lockToken}",lockToken)

    ; Add a timeout parameter.
    CkRest::ckAddQueryParam(rest,"timeout","20")

    ; Use the DELETE HTTP verb to delete the message.
    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkRest::ckFullRequestNoBodySb(rest,"DELETE",CkStringBuilder::ckGetAsString(sbPath),sbResponseBody)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkStringBuilder::ckDispose(sbToken)
        CkStringBuilder::ckDispose(sbPath)
        CkStringBuilder::ckDispose(sbResponseBody)
        ProcedureReturn
    EndIf

    Debug "Response Status Code = " + Str(CkRest::ckResponseStatusCode(rest))

    ; Check for a success response.
    If CkRest::ckResponseStatusCode(rest) <> 200
        Debug CkRest::ckLastRequestStartLine(rest)
        Debug CkRest::ckLastRequestHeader(rest)
        Debug CkStringBuilder::ckGetAsString(sbResponseBody)
        Debug "Failed."
        CkRest::ckDispose(rest)
        CkStringBuilder::ckDispose(sbToken)
        CkStringBuilder::ckDispose(sbPath)
        CkStringBuilder::ckDispose(sbResponseBody)
        ProcedureReturn
    EndIf

    ; If successful, the response body would be empty..
    Debug "Success."


    CkRest::ckDispose(rest)
    CkStringBuilder::ckDispose(sbToken)
    CkStringBuilder::ckDispose(sbPath)
    CkStringBuilder::ckDispose(sbResponseBody)


    ProcedureReturn
EndProcedure