### 设计单例模式的日志记录类 #### 路径选择的理由 日志文件的存储路径应当易于管理和查找，同时避免与其他文件发生冲突。常见的做法是将日志文件存放在专门的目录下（如 `/var/log/` 或项目的子目录 `./logs/`）。这种结构不仅便于维护，还能提高系统的可移植性和可读性[^1]。此外，通过允许用户自定义日志路径，可以满足不同环境下的部署需求。 --- ### 类图设计 以下是基于单例模式的日志记录类的设计类图： ```plaintext +-----------------------------+ | SingletonLogger | +-----------------------------+ | - _logFilePath: str | <-- 存储日志文件路径 | - _logger: logging.Logger | <-- 内部使用的Logger对象 | | | + __new__(cls): object | <-- 构造函数重载实现单例 | + configure_logger(path: str)| <-- 配置日志记录器 | + log(message: str, level: str) | <-- 记录日志的方法 +-----------------------------+ ``` --- ### 实现代码 以下是一个完整的 Python 实现示例，展示了如何利用单例模式设计一个日志记录类 `SingletonLogger` 并支持设置日志文件路径的功能。 ```python import os import logging from datetime import datetime class SingletonLogger: _instance = None # 用于保存唯一的实例 def __new__(cls, *args, **kwargs): """重写__new__方法以实现单例""" if cls._instance is None: cls._instance = super(SingletonLogger, cls).__new__(cls) cls._instance.configure_logger(*args, **kwargs) return cls._instance def configure_logger(self, log_path=None, log_level=logging.INFO): """ 配置日志记录器 参数: - log_path: 日志文件路径，默认为当前工作目录下的'logs/'子目录 - log_level: 日志等级，默认为INFO """ self._logFilePath = log_path or f"./logs/{datetime.now().strftime('%Y%m%d')}.log" # 创建日志目录如果不存在 os.makedirs(os.path.dirname(self._logFilePath), exist_ok=True) # 配置日志格式和处理器 formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s") handler = logging.FileHandler(self._logFilePath, mode='a', encoding="utf-8") handler.setFormatter(formatter) # 初始化内部Logger对象 self._logger = logging.getLogger("SingletonLogger") self._logger.setLevel(log_level) self._logger.addHandler(handler) def log(self, message, level="info"): """ 记录日志 参数: - message: 日志消息 - level: 日志等级 (debug/info/warning/error/critical)，默认为info """ method_name = getattr(logging, level.lower(), None) if not callable(method_name): raise ValueError(f"Invalid log level: {level}") method_name(self._logger)(message) if __name__ == "__main__": # 测试单例模式 logger1 = SingletonLogger(log_path="./custom_logs/app.log", log_level=logging.DEBUG) logger2 = SingletonLogger() print(logger1 is logger2) # 输出True，证明是同一个实例 # 记录日志测试 logger1.log("This is an info message.", "info") # 正常信息 logger1.log("This is a warning message.", "warning") # 警告信息 logger1.log("An error occurred!", "error") # 错误信息 ``` --- ### 功能说明 1. **单例模式实现** 使用 `__new__` 方法覆盖默认的实例化过程，确保每次调用 `SingletonLogger` 时返回的是同一个实例[^4]。 2. **日志文件路径配置** 默认情况下，日志文件会存储在当前工作目录下的 `./logs/` 子目录中，并按日期命名（如 `20231007.log`）。如果用户提供自定义路径，则优先使用指定路径[^1]。 3. **日志等级控制** 支持多种日志等级（DEBUG、INFO、WARNING、ERROR 和 CRITICAL），并通过参数动态调整日志输出的行为[^2]。 4. **灵活性与扩展性** 用户可以通过传递不同的参数来自定义日志路径和日志等级，从而适应不同的应用场景。 --- ###