/* * Phusion Passenger - https://www.phusionpassenger.com/ * Copyright (c) 2017-2025 Asynchronous B.V. * * "Passenger", "Phusion Passenger" and "Union Station" are registered * trademarks of Asynchronous B.V. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ #ifndef _PASSENGER_CONFIG_KIT_TRANSLATOR_H_ #define _PASSENGER_CONFIG_KIT_TRANSLATOR_H_ #include #include #include #include #include #include namespace Passenger { namespace ConfigKit { using namespace std; /** * An abstract base class for all translators. * * You can learn more about translators in the ConfigKit README, section * "The special problem of overlapping configuration names and translation". */ class Translator { private: string translateErrorKey(const StaticString &key) const { return "{{" + translateOne(key) + "}}"; } string reverseTranslateErrorKey(const StaticString &key) const { return "{{" + reverseTranslateOne(key) + "}}"; } public: virtual ~Translator() { } virtual Json::Value translate(const Json::Value &doc) const { Json::Value result(Json::objectValue); Json::Value::const_iterator it, end = doc.end(); for (it = doc.begin(); it != end; it++) { const char *keyEnd; const char *key = it.memberName(&keyEnd); result[translateOne(StaticString(key, keyEnd - key))] = *it; } return result; } virtual Json::Value reverseTranslate(const Json::Value &doc) const { Json::Value result(Json::objectValue); Json::Value::const_iterator it, end = doc.end(); for (it = doc.begin(); it != end; it++) { const char *keyEnd; const char *key = it.memberName(&keyEnd); result[reverseTranslateOne(StaticString(key, keyEnd - key))] = *it; } return result; } virtual vector translate(const vector &errors) const { vector result; vector::const_iterator it, end = errors.end(); Error::KeyProcessor keyProcessor = boost::bind(&Translator::translateErrorKey, this, boost::placeholders::_1); for (it = errors.begin(); it != end; it++) { const Error &error = *it; result.push_back(Error(error.getMessage(keyProcessor))); } return result; } virtual vector reverseTranslate(const vector &errors) const { vector result; vector::const_iterator it, end = errors.end(); Error::KeyProcessor keyProcessor = boost::bind(&Translator::reverseTranslateErrorKey, this, boost::placeholders::_1); for (it = errors.begin(); it != end; it++) { const Error &error = *it; result.push_back(Error(error.getMessage(keyProcessor))); } return result; } virtual string translateOne(const StaticString &key) const = 0; virtual string reverseTranslateOne(const StaticString &key) const = 0; }; } // namespace ConfigKit } // namespace Passenger #endif /* _PASSENGER_CONFIG_KIT_TRANSLATOR_H_ */