/** * Copyright (C) 2018-present MongoDB, Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the Server Side Public License, version 1, * as published by MongoDB, Inc. * * This program 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 * Server Side Public License for more details. * * You should have received a copy of the Server Side Public License * along with this program. If not, see * . * * As a special exception, the copyright holders give permission to link the * code of portions of this program with the OpenSSL library under certain * conditions as described in each individual source file and distribute * linked combinations including the program with the OpenSSL library. You * must comply with the Server Side Public License in all respects for * all of the code used other than as permitted herein. If you modify file(s) * with this exception, you may extend this exception to your version of the * file(s), but you are not obligated to do so. If you do not wish to do so, * delete this exception statement from your version. If you delete this * exception statement from all source files in the program, then also delete * it in the license file. */ #pragma once #include #include #include #include "mongo/base/error_codes.h" #include "mongo/bson/bsontypes.h" #include "mongo/logger/labeled_level.h" #include "mongo/logger/log_component.h" #include "mongo/logger/log_severity.h" #include "mongo/logger/message_log_domain.h" #include "mongo/stdx/chrono.h" #include "mongo/util/exit_code.h" namespace mongo { namespace logger { class Tee; /** * Stream-ish object used to build and append log messages. */ class LogstreamBuilder { public: static LogSeverity severityCast(int ll) { return LogSeverity::cast(ll); } static LogSeverity severityCast(LogSeverity ls) { return ls; } static LabeledLevel severityCast(const LabeledLevel& labeled) { return labeled; } /** * Construct a LogstreamBuilder that writes to "domain" on destruction. * * "contextName" is a short name of the thread or other context. * "severity" is the logging severity of the message. */ LogstreamBuilder(MessageLogDomain* domain, StringData contextName, LogSeverity severity); /** * Construct a LogstreamBuilder that writes to "domain" on destruction. * * "contextName" is a short name of the thread or other context. * "severity" is the logging severity of the message. * "component" is the primary log component of the message. * * By default, this class will create one ostream per thread, and it * will cache that object in a threadlocal and reuse it for subsequent * logs messages. Set "shouldCache" to false to create a new ostream * for each instance of this class rather than cacheing. */ LogstreamBuilder(MessageLogDomain* domain, StringData contextName, LogSeverity severity, LogComponent component, bool shouldCache = true); /** * Deprecated. */ LogstreamBuilder(MessageLogDomain* domain, StringData contextName, LabeledLevel labeledLevel); LogstreamBuilder(LogstreamBuilder&& other) = default; LogstreamBuilder& operator=(LogstreamBuilder&& other) = default; /** * Destroys a LogstreamBuilder(). If anything was written to it via stream() or operator<<, * constructs a MessageLogDomain::Event and appends it to the associated domain. */ ~LogstreamBuilder(); /** * Sets an optional prefix for the message. */ LogstreamBuilder& setBaseMessage(const std::string& baseMessage) { _baseMessage = baseMessage; return *this; } LogstreamBuilder& setIsTruncatable(bool isTruncatable) { _isTruncatable = isTruncatable; return *this; } std::ostream& stream() { if (!_os) makeStream(); return *_os; } LogstreamBuilder& operator<<(const char* x) { return appendEscapedString(x); } LogstreamBuilder& operator<<(const std::string& x) { return appendEscapedString(x); } LogstreamBuilder& operator<<(StringData x) { return appendEscapedString(x); } LogstreamBuilder& operator<<(char* x) { return appendEscapedString(x); } LogstreamBuilder& operator<<(char x) { return appendEscapedChar(x); } LogstreamBuilder& operator<<(int x) { stream() << x; return *this; } LogstreamBuilder& operator<<(ExitCode x) { stream() << x; return *this; } LogstreamBuilder& operator<<(long x) { stream() << x; return *this; } LogstreamBuilder& operator<<(unsigned long x) { stream() << x; return *this; } LogstreamBuilder& operator<<(unsigned x) { stream() << x; return *this; } LogstreamBuilder& operator<<(unsigned short x) { stream() << x; return *this; } LogstreamBuilder& operator<<(double x) { stream() << x; return *this; } LogstreamBuilder& operator<<(void* x) { stream() << x; return *this; } LogstreamBuilder& operator<<(const void* x) { stream() << x; return *this; } LogstreamBuilder& operator<<(long long x) { stream() << x; return *this; } LogstreamBuilder& operator<<(unsigned long long x) { stream() << x; return *this; } LogstreamBuilder& operator<<(bool x) { stream() << x; return *this; } template LogstreamBuilder& operator<<(const Duration& d) { stream() << d; return *this; } LogstreamBuilder& operator<<(BSONType t) { stream() << typeName(t); return *this; } LogstreamBuilder& operator<<(ErrorCodes::Error ec) { stream() << ErrorCodes::errorString(ec); return *this; } template LogstreamBuilder& operator<<(const T& x) { return appendEscapedString(x.toString()); } LogstreamBuilder& operator<<(std::ostream& (*manip)(std::ostream&)) { stream() << manip; return *this; } LogstreamBuilder& operator<<(std::ios_base& (*manip)(std::ios_base&)) { stream() << manip; return *this; } /** * In addition to appending the message to _domain, write it to the given tee. May only * be called once per instance of LogstreamBuilder. */ void operator<<(Tee* tee); /** * Enable newilne escaping behavior. */ static void setNewlineEscape() { newlineEscape = true; } private: /** * Global option to escape newlines. */ static bool newlineEscape; void makeStream(); // Append a string explicitly escaping \r and \n only. LogstreamBuilder& appendEscapedString(StringData x) { if (newlineEscape) { auto idx = std::min(x.find('\r'), x.find('\n')); while (idx != std::string::npos) { if (idx > 0) { stream() << x.substr(0, idx); } appendEscapedChar(x[idx]); x = x.substr(idx + 1); idx = std::min(x.find('\r'), x.find('\n')); } } stream() << x; return *this; } LogstreamBuilder& appendEscapedChar(char ch) { if (newlineEscape) { switch (ch) { case '\n': stream() << "\\n"; break; case '\r': stream() << "\\r"; break; default: stream() << ch; } } else { stream() << ch; } return *this; } MessageLogDomain* _domain; std::string _contextName; LogSeverity _severity; LogComponent _component; std::string _baseMessage; std::unique_ptr _os; Tee* _tee; bool _isTruncatable = true; bool _shouldCache; }; } // namespace logger } // namespace mongo