llhttpclient.h

Go to the documentation of this file.

#ifndef LL_LLHTTPCLIENT_H
#define LL_LLHTTPCLIENT_H

#include <string>

#include <boost/intrusive_ptr.hpp>

#include "llassettype.h"
#include "llbuffer.h"
#include "lliopipe.h"

extern const F32 HTTP_REQUEST_EXPIRY_SECS;

class LLUUID;
class LLPumpIO;
class LLSD;


class LLHTTPClient
{
public:
        class Responder
        {
        public:
                Responder();
                virtual ~Responder();

                static bool isGoodStatus(U32 status)
                {
                        return((200 <= status) && (status < 300));
                }

                virtual void error(U32 status, const std::string& reason);      // called with bad status codes
                
                virtual void result(const LLSD& content);
                
                // Override point for clients that may want to use this class when the response is some other format besides LLSD
                virtual void completedRaw(U32 status, const std::string& reason, const LLChannelDescriptors& channels,
                                                                const LLIOPipe::buffer_ptr_t& buffer);

                virtual void completed(U32 status, const std::string& reason, const LLSD& content);
        public: /* but not really -- don't touch this */
                U32 mReferenceCount;
        };

        typedef boost::intrusive_ptr<Responder> ResponderPtr;
        
        static void get(const std::string& url, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void get(const std::string& url, ResponderPtr, const LLSD& headers, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void get(const std::string& url, const LLSD& query, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void get(const std::string& url, const LLSD& query, ResponderPtr, const LLSD& headers, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void put(const std::string& url, const LLSD& body, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void post(const std::string& url, const LLSD& body, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void post(const std::string& url, const U8* data, S32 size, ResponderPtr responder, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void postFile(const std::string& url, const std::string& filename, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        static void postFile(const std::string& url, const LLUUID& uuid,
                LLAssetType::EType asset_type, ResponderPtr responder, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);

        // Blocking HTTP get that returns an LLSD map of status and body.
        static LLSD blockingGet(const std::string& url);

        static void del(const std::string& url, ResponderPtr, const F32 timeout=HTTP_REQUEST_EXPIRY_SECS);
        
        
        static void setPump(LLPumpIO& pump);
        static bool hasPump();
        
        static void setCABundle(const std::string& caBundle);
};



namespace boost
{
        void intrusive_ptr_add_ref(LLHTTPClient::Responder* p);
        void intrusive_ptr_release(LLHTTPClient::Responder* p);
};


#endif // LL_LLHTTPCLIENT_H

---