NAME

       TSHttpTxnPostBufferReaderGet - TSHttpTxnPostBufferReaderGet API function

SYNOPSIS

          #include <ts/ts.h>

       TSIOBufferReader TSHttpTxnPostBufferReaderGet(TSHttpTxn txnp)

DESCRIPTION

       Retrieve  the  client request body for the transaction referenced by txnp.  The body is read from via the
       returned TSIOBufferReader. The returned TSIOBufferReader is owned by the caller and the caller must  free
       it    via    TSIOBufferReaderFree().    This    function    should   be   used   in   the   handler   for
       TS_HTTP_REQUEST_BUFFER_READ_COMPLETE_HOOK.   The    following    example    handler    makes    use    of
       TSHttpTxnPostBufferReaderGet().

          int
          CB_Read_Request_Body_Hook(TSCont contp, TSEvent event, void* data) {
            ink_assert(event == TS_EVENT_HTTP_REQUEST_BUFFER_COMPLETE);
            auto txnp = reinterpret_cast<TSHttpTxn>(data);

            TSIOBufferReader post_buffer_reader = TSHttpTxnPostBufferReaderGet(txnp);
            int64_t read_avail                  = TSIOBufferReaderAvail(post_buffer_reader);

            if (read_avail > 0) {
              char *body_bytes = reinterpret_cast<char *>(TSmalloc(sizeof(char) * read_avail));

              int64_t consumed      = 0;
              TSIOBufferBlock block = TSIOBufferReaderStart(post_buffer_reader);
              while (block != NULL) {
                int64_t data_len        = 0;
                const char *block_bytes = TSIOBufferBlockReadStart(block, post_buffer_reader, &data_len);
                memcpy(body_bytes + consumed, block_bytes, data_len);
                consumed += data_len;
                block = TSIOBufferBlockNext(block);
              }

              // Now do something with body_bytes which contains the contents of the
              // request's body.
            }

            // Remember to free the TSIOBufferReader.
            TSIOBufferReaderFree(post_buffer_reader);

            TSHttpTxnReenable(txnp);
            return 0;
          }

       example/plugins/c-api/request_buffer/request_buffer.c  is a simple yet complete plugin that accesses HTTP
       request bodies.

COPYRIGHT

       2024, dev@trafficserver.apache.org