#ifndef MEMCACHE_REQ_H
#define MEMCACHE_REQ_H

#include <sys/queue.h>

#include "../memcache.h"
#include "connection.h"

struct memcache_req {
    // the memcache context that we belong to
    struct memcache *mc;

    // the command to execute
    enum memcache_command cmd_type;

    // the reply we have received, or MEMCACHE_REPLY_INVALID
    enum memcache_reply reply_type;

    // our key/obj
    struct memcache_key key;
    struct memcache_obj obj;
    struct memcache_buf buf;

    // our state
    enum memcache_req_state state;

    // our user callback argument
    void *cb_arg;

    // the conn 
    struct memcache_connection *conn;
    
    // we are a member of struct memcache_server.req_queue
    TAILQ_ENTRY(memcache_req) reqqueue_node;
};

/*
 * Allocate and return a new req, or NULL if unsuccesfull.
 */
struct memcache_req *memcache_req_alloc (struct memcache *mc, enum memcache_command cmd_type, const struct memcache_key *key, void *cb_arg);

/*
 * An error occurred, and the request must be abandoned. This will assume that the req is not active or enqueued
 * anymore, and the req should not be accessed by memcache_* code after this.
 */
void memcache_req_error (struct memcache_req *req);

/*
 * The request has been queued.
 */
void memcache_req_queued (struct memcache_req *req);

/*
 * The request is being sent.
 */
void memcache_req_send (struct memcache_req *req);

/*
 * The response has been received, although if the respones also contains data, that will be notified separately
 */
void memcache_req_reply (struct memcache_req *req, enum memcache_reply reply_type);

/*
 * The request was sent and is now done, and is not associated with the connection anymore.
 *
 * This will be called before req_reply/req_data, but not before/after req_error.
 */
void memcache_req_done (struct memcache_req *req);

/*
 * Free an unused req. Should always be called by the user, not via internal means.
 */
void memcache_req_free (struct memcache_req *req);

#endif /* MEMCACHE_REQ_H */