//------------------------------------------------------------------------------ /* This file is part of Beast: https://github.com/vinniefalco/Beast Copyright 2013, Vinnie Falco Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ //============================================================================== #ifndef BEAST_UTILITY_PROPERTYSTREAM_H_INCLUDED #define BEAST_UTILITY_PROPERTYSTREAM_H_INCLUDED #include #include #include #include #include #include namespace beast { //------------------------------------------------------------------------------ /** Abstract stream with RAII containers that produce a property tree. */ class PropertyStream { public: class Map; class Set; class Source; PropertyStream() = default; virtual ~PropertyStream() = default; protected: virtual void map_begin() = 0; virtual void map_begin(std::string const& key) = 0; virtual void map_end() = 0; virtual void add(std::string const& key, std::string const& value) = 0; void add(std::string const& key, char const* value) { add(key, std::string(value)); } template void lexical_add(std::string const& key, Value value) { std::stringstream ss; ss << value; add(key, ss.str()); } virtual void add(std::string const& key, bool value); virtual void add(std::string const& key, char value); virtual void add(std::string const& key, signed char value); virtual void add(std::string const& key, unsigned char value); virtual void add(std::string const& key, short value); virtual void add(std::string const& key, unsigned short value); virtual void add(std::string const& key, int value); virtual void add(std::string const& key, unsigned int value); virtual void add(std::string const& key, long value); virtual void add(std::string const& key, unsigned long value); virtual void add(std::string const& key, long long value); virtual void add(std::string const& key, unsigned long long value); virtual void add(std::string const& key, float value); virtual void add(std::string const& key, double value); virtual void add(std::string const& key, long double value); virtual void array_begin() = 0; virtual void array_begin(std::string const& key) = 0; virtual void array_end() = 0; virtual void add(std::string const& value) = 0; void add(char const* value) { add(std::string(value)); } template void lexical_add(Value value) { std::stringstream ss; ss << value; add(ss.str()); } virtual void add(bool value); virtual void add(char value); virtual void add(signed char value); virtual void add(unsigned char value); virtual void add(short value); virtual void add(unsigned short value); virtual void add(int value); virtual void add(unsigned int value); virtual void add(long value); virtual void add(unsigned long value); virtual void add(long long value); virtual void add(unsigned long long value); virtual void add(float value); virtual void add(double value); virtual void add(long double value); private: class Item; class Proxy; }; //------------------------------------------------------------------------------ // // Item // //------------------------------------------------------------------------------ class PropertyStream::Item : public List::Node { public: explicit Item(Source* source); Source& source() const; Source* operator->() const; Source& operator*() const; private: Source* m_source; }; //------------------------------------------------------------------------------ // // Proxy // //------------------------------------------------------------------------------ class PropertyStream::Proxy { private: Map const* m_map; std::string m_key; std::ostringstream mutable m_ostream; public: Proxy(Map const& map, std::string const& key); Proxy(Proxy const& other); ~Proxy(); template Proxy& operator=(Value value); std::ostream& operator<<(std::ostream& manip(std::ostream&)) const; template std::ostream& operator<<(T const& t) const { return m_ostream << t; } }; //------------------------------------------------------------------------------ // // Map // //------------------------------------------------------------------------------ class PropertyStream::Map { private: PropertyStream& m_stream; public: explicit Map(PropertyStream& stream); explicit Map(Set& parent); Map(std::string const& key, Map& parent); Map(std::string const& key, PropertyStream& stream); ~Map(); Map(Map const&) = delete; Map& operator=(Map const&) = delete; PropertyStream& stream(); PropertyStream const& stream() const; template void add(std::string const& key, Value value) const { m_stream.add(key, value); } template void add(Key key, Value value) const { std::stringstream ss; ss << key; add(ss.str(), value); } Proxy operator[](std::string const& key); Proxy operator[](char const* key) { return Proxy(*this, key); } template Proxy operator[](Key key) const { std::stringstream ss; ss << key; return Proxy(*this, ss.str()); } }; //-------------------------------------------------------------------------- template PropertyStream::Proxy& PropertyStream::Proxy::operator=(Value value) { m_map->add(m_key, value); return *this; } //-------------------------------------------------------------------------- // // Set // //------------------------------------------------------------------------------ class PropertyStream::Set { private: PropertyStream& m_stream; public: Set(std::string const& key, Map& map); Set(std::string const& key, PropertyStream& stream); ~Set(); Set(Set const&) = delete; Set& operator=(Set const&) = delete; PropertyStream& stream(); PropertyStream const& stream() const; template void add(Value value) const { m_stream.add(value); } }; //------------------------------------------------------------------------------ // // Source // //------------------------------------------------------------------------------ /** Subclasses can be called to write to a stream and have children. */ class PropertyStream::Source { private: std::string const m_name; std::recursive_mutex lock_; Item item_; Source* parent_; List children_; public: explicit Source(std::string const& name); virtual ~Source(); Source(Source const&) = delete; Source& operator=(Source const&) = delete; /** Returns the name of this source. */ std::string const& name() const; /** Add a child source. */ void add(Source& source); /** Add a child source by pointer. The source pointer is returned so it can be used in ctor-initializers. */ template Derived* add(Derived* child) { add(*static_cast(child)); return child; } /** Remove a child source from this Source. */ void remove(Source& child); /** Remove all child sources from this Source. */ void removeAll(); /** Write only this Source to the stream. */ void write_one(PropertyStream& stream); /** write this source and all its children recursively to the stream. */ void write(PropertyStream& stream); /** Parse the path and write the corresponding Source and optional children. If the source is found, it is written. If the wildcard character '*' exists as the last character in the path, then all the children are written recursively. */ void write(PropertyStream& stream, std::string const& path); /** Parse the dot-delimited Source path and return the result. The first value will be a pointer to the Source object corresponding to the given path. If no Source object exists, then the first value will be nullptr and the second value will be undefined. The second value is a boolean indicating whether or not the path string specifies the wildcard character '*' as the last character. print statement examples "parent.child" prints child and all of its children "parent.child." start at the parent and print down to child "parent.grandchild" prints nothing- grandchild not direct discendent "parent.grandchild." starts at the parent and prints down to grandchild "parent.grandchild.*" starts at parent, print through grandchild children */ std::pair find(std::string path); Source* find_one_deep(std::string const& name); PropertyStream::Source* find_path(std::string path); PropertyStream::Source* find_one(std::string const& name); static bool peel_leading_slash(std::string* path); static bool peel_trailing_slashstar(std::string* path); static std::string peel_name(std::string* path); //-------------------------------------------------------------------------- /** Subclass override. The default version does nothing. */ virtual void onWrite(Map&); }; } // namespace beast #endif