MissatgeHTTP.h

Veure la documentació d'aquest fitxer.

#if !defined(_MISSATGE_HTTP_H_)
#define _MISSATGE_HTTP_H_

/*
 * Copyright (c) 2012 Toni Corvera
 *
 * This file is part of TFCWeb.
 *
 * TFCWeb is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * TFCWeb 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with TFCWeb. If not, see <http://www.gnu.org/licenses/>.
 */

#include "CapsaleraHTTP.h"
#include "portabilitat.h"

#include <memory>
#include <vector>

namespace tfc {

// FIXME: RFC 2068 també?
// L'RFC recomana (no exigeix) enviar les capçaleres amb un ordre determinat
// (de més generals a més concretes respecte el contingut del missatge)
//
// Interessa conservar l'ordre d'inserció, si es fa servir una taula hash
// caldrà algún mètode de fer-ho:
// - afegir un vector<string> amb l'ordre d'inserció
// - utilitzar boost::multi_index
//   <http://www.boost.org/doc/libs/1_49_0/libs/multi_index/doc/index.html>
//   <http://stackoverflow.com/questions/1098175/a-stdmap-that-keep-track-of-the-order-of-insertion>

template<typename TCos>
class MissatgeHTTP {
public:
    typedef std::vector<CapsaleraHTTP> tipus_llista_capsaleres;

    std::string capsalera(const std::string & nom, bool * definida = 0) const;

    virtual bool operator==(const MissatgeHTTP<TCos> & m) const {
        if (this == &m) {
            return true;
        }
        return capsaleres_ == m.capsaleres_; // FIXME: == ó std::equal() ? Test case
    }

    void afegeix_capsalera(const std::string & nom, const std::string & valor);

    template<typename Iterador>
    void afegeix_capsaleres(const Iterador & inici, const Iterador & final);

    const tipus_llista_capsaleres& capsaleres() const {
        return capsaleres_;
    }

    void defineix_cos(std::shared_ptr<TCos> cos) {
        cos_ = cos;
    }

    void imprimeix_capsaleres(std::ostream &os, const std::string & le = "\n") const;

    virtual std::weak_ptr<TCos> cos() const { return cos_; }

    bool te_cos() const { return 0 != cos_.get(); }

    bool elimina_capsalera(const std::string & nom) throw();

protected:
    MissatgeHTTP()
        : cos_()
    {
        // buit
    }

    MissatgeHTTP(const MissatgeHTTP & m);
private:

    struct Impressor;

    tipus_llista_capsaleres capsaleres_;

#if 0
    // L'RFC no obliga però recomana ordenar les capçaleres (de més a menys generals)
    // amb aquesta intenció interessa mantenir l'ordre d'inserció. Per a fer-ho
    // cap utilitzar un contenidor addicional (ni map ni unordered_map mantenen l'ordre
    // d'inserció), o un dels contenidors multi-clau de boost
    std::unordered_map<std::string, CapsaleraHTTP> capsaleres_;
    std::vector<std::string> ordre_capsaleres_;
#endif

    std::shared_ptr<TCos> cos_; 
};

} // ns tfc

// Implementació (inclosa directament per ser una classe template)
#include "MissatgeHTTP.hxx"

#endif // _MISSATGE_HTTP_H_

// vim:set ts=4 et ai: //