---

network.HttpClient.h

/*----------------------------------------------------------------------------
  SWORD 2000 - Software With Objects for Rapid Development
  Copyright (C) 2003 Eric NICOLAS
  ----------------------------------------------------------------------------
  SWORD is free software; you can redistribute it and/or modify
  it under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  SWORD is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with SWORD; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  --------------------------------------------------------------------------*/
#ifndef _SWORD_NETWORK_HTTPCLIENT_
#define _SWORD_NETWORK_HTTPCLIENT_

#include "sword/network.HttpSession.h"
#include "sword/network.InetClient.h"
#include "sword/streams.IStorage.h"

namespace sword {

        class SWORDDECL HttpClient : public IStorage {
        public:
                HttpClient(const URL &url, HttpSession &session);
                ~HttpClient();

                // --- Pre-fetch options


                void addHeader(const std::string &line);

                // --- Fetch

                enum Code {
                        Success,        // HTTP code 200
                        AuthRequired,   // HTTP code 401
                        FileNotFound,   // HTTP code 404
                        Error           // Other error codes
                };

                typedef std::map<std::string, std::string> Arguments;
                enum PostMethod {
                        Get,
                        Post
                };

                Code fetch();

                Code fetch(const Arguments &arguments, PostMethod method);

                // --- Post-fetch retrieval


                std::string replyValue(const std::string& name) const;


                word size() const;

                word read(void* buffer, word length);

        private:
                URL          url_;
                InetClient   client_;
                HttpSession &session_;
                std::ostringstream optionalHeader_;

                // retrieved data
                typedef std::map<std::string, std::string> ReplyLines;
                ReplyLines replyLines_;
                word size_;

                // content reader state machine
                enum State { FixedSize_, Streamed_, NeedChunk_, InChunk_ };
                word  size1_;
                State state_;
        };

} // namespace sword

#include "sword.private/network.HttpClient.inl"

#endif // _SWORD_NETWORK_HTTPCLIENT_

---