在构建现代 Java 应用程序时，日志是不可或缺的一部分。一个健壮的日志系统不仅能帮助我们监控应用程序的运行状态，还能在问题发生时提供关键的诊断信息。Logback 作为 SLF4J 的一个流行实现，以其高性能和灵活的配置而广受开发者喜爱。

然而，仅仅将日志打印到控制台或文件通常不足以满足复杂应用的需求。我们可能需要根据不同的部署环境调整日志路径、动态地注入一些运行时信息，或者从外部文件加载配置。这时，Logback 提供的 <property> 和 <variable> 标签就成为了配置的强大工具。

本文将深入探讨 Logback 中 <property> 和 <variable> 的功能、配置、典型使用场景以及它们之间的关键区别，帮助您构建更灵活、更易维护的 Logback 配置。

Logback 中的属性：<property>

<property> 标签是 Logback 配置中最基本也是最常用的元素之一，它允许您定义一个可在整个配置文件中重复使用的键值对。

功能与配置：

<property> 可以通过两种主要方式定义其值：

  1. 直接指定值： 使用 value 属性来直接定义属性的值。

    <configuration><property name="log.file.name" value="application.log"/><appender name="FILE" class="ch.qos.logback.core.FileAppender"><file>${log.file.name}</file> <!-- 引用属性 --><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><root level="info"><appender-ref ref="FILE"/></root>
</configuration>

    在这个例子中，log.file.name 被定义为 application.log，并通过 ${log.file.name} 在 <file> 标签中引用。

  2. 从外部文件加载： 使用 file 或 resource 属性来加载一个外部的 .properties 文件。file 用于指定文件系统路径，resource 用于指定类路径中的资源。这种方式非常适合在不修改 Logback XML 文件的情况下，根据不同环境调整配置。

    示例：

    假设您有一个名为 application-logger.properties 的文件，位于您项目的 src/main/resources/config 目录下（或者在部署时位于文件系统的 /etc/app/config/ 目录下）。

    src/main/resources/config/application-logger.properties 文件内容：

    # 日志文件存储路径
log.dir=/var/log/my-app
# 应用程序日志文件的基本名称
app.log.basename=backend-service
# 应用程序日志级别
app.log.level=INFO

    logback.xml 文件内容：

    <configuration><!-- 方式一：从类路径加载 .properties 文件 --><!-- Logback 会在类路径下查找 config/application-logger.properties --><property resource="config/application-logger.properties"/><!-- 方式二：从文件系统路径加载 .properties 文件 --><!-- 如果您知道确切的文件系统路径，例如在Linux服务器上 --><!-- <property file="/etc/app/config/application-logger.properties"/> --><appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"><!-- 使用从 properties 文件加载的 log.dir 和 app.log.basename --><file>${log.dir}/${app.log.basename}.log</file><rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><fileNamePattern>${log.dir}/${app.log.basename}.%d{yyyy-MM-dd}.gz</fileNamePattern><maxHistory>30</maxHistory></rollingPolicy><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><!-- 使用从 properties 文件加载的 app.log.level --><root level="${app.log.level}"><appender-ref ref="ROLLING_FILE"/></root>
</configuration>

    在这个扩充的例子中：

    • 通过 <property resource="config/application-logger.properties"/>，Logback 会读取 application-logger.properties 文件中的所有键值对。
    • 这些键值对（例如 log.dir、app.log.basename、app.log.level）随后就可以像 XML 中定义的属性一样，通过 ${propertyName} 的语法在 logback.xml 的其他地方被引用。
    • 这种方式极大地增强了配置的灵活性，使得您可以根据不同的部署环境或需求，轻松切换不同的属性文件，而无需修改核心的 logback.xml 结构。

使用场景：

  • 集中管理常量： 将日志文件名、路径、模式字符串等常量定义为属性，方便统一修改和管理。
  • 外部化配置： 将部分配置（尤其是环境相关的）从 XML 文件中分离出来，存储在 .properties 文件中，实现配置的外部化和灵活部署。
  • 提高可读性： 将复杂的模式字符串定义为属性，使 <encoder> 部分更简洁。
应对更复杂的场景：<variable>

<variable> 标签与 <property> 类似，也用于定义可以在配置文件中引用的键值对。但它的核心区别在于其 scope 属性，这使得它能够从更广泛的来源获取值，以应对更动态的配置需求。

功能与配置：

<variable> 最大的特点是其 scope 属性，它决定了变量值的查找范围：

  1. scope="context"： 变量的值直接在 value 属性中定义，并存储在 Logback 的 LoggerContext 中。这与 <property value="..." /> 的行为非常相似。

    <variable name="application.id" value="my-service-alpha" scope="context"/>
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d [%thread] ${application.id} %-5level %logger{36} - %msg%n</pattern></encoder>
</appender>

    这里的 ${application.id} 会被解析为 my-service-alpha。

  2. scope="system"： 变量的值将从 Java **系统属性（System Properties）**中获取。这意味着您可以通过 JVM 启动参数来动态地设置这些值。

    <variable name="server.port" scope="system"/>
<appender name="FILE" class="ch.qos.logback.core.FileAppender"><file>logs/app-${server.port}.log</file><!-- ... -->
</appender>

    如果您通过 java -Dserver.port=8080 -jar your-app.jar 启动应用程序，那么日志文件名将是 app-8080.log。

  3. scope="env"： 变量的值将从**操作系统环境变量（Environment Variables）**中获取。

    <variable name="LOG_LEVEL_OVERRIDE" scope="env"/>
<root level="${LOG_LEVEL_OVERRIDE:-INFO}"> <!-- 默认值为INFO --><appender-ref ref="CONSOLE"/>
</root>

    如果您的操作系统设置了环境变量 LOG_LEVEL_OVERRIDE=DEBUG，那么应用程序的根日志级别将是 DEBUG。这里还展示了 ${VAR_NAME:-defaultValue} 的用法，当环境变量不存在时提供默认值。

使用场景：

  • 动态环境参数： 获取应用程序启动时的 JVM 参数或操作系统环境变量，实现根据部署环境动态调整日志行为。
  • 云原生部署： 在 Docker、Kubernetes 等容器化环境中，环境变量是传递配置的常用方式，<variable scope="env"/> 提供了无缝集成。
  • 运行时标识符： 将服务器 ID、容器 ID 等动态生成的标识符注入到日志中，以便在分布式日志系统中进行关联和追踪。
<property> 与 <variable> 的核心区别与选择

尽管两者都用于定义和引用键值对，但它们在功能侧重和值获取优先级上存在显著差异。

主要区别总结：

特性<property><variable>
主要功能定义通用键值对，可从 XML 或外部 .properties 文件加载。定义变量，尤其擅长从 Java 系统属性或操作系统环境变量获取值。
值来源直接在 value 中指定；从 file 或 resource 指定的 .properties 文件加载。直接在 value 中指定（scope="context"）；从 Java 系统属性（scope="system"）；从操作系统环境变量（scope="env"）。
scope属性无此属性。核心属性，用于指定变量值的查找范围。
典型用途应用程序内部的静态配置值；从外部配置文件加载。动态获取外部环境参数（如机器名、环境变量）；在 Logback 上下文中定义变量。

优先级查找顺序：

当 Logback 解析配置文件中 ${...} 形式的占位符时，它会按照以下优先级顺序查找对应的值：

  1. 本地作用域 / 上下文作用域： 在 logback.xml 配置文件中直接使用 <property> 或 <variable scope="context"/> 定义的属性和变量。这是最高优先级。
  2. Java 系统属性（System Properties）： 通过 JVM 启动参数 -Dkey=value 设置的属性。
  3. 操作系统环境变量（Operating System Environment）： 操作系统中设置的环境变量。这是最低优先级。

这个优先级顺序意味着：本地定义的值会覆盖系统属性，系统属性会覆盖环境变量。理解这一点对于解决 Logback 配置中的变量冲突和确保您期望的值被正确使用至关重要。

如何选择：

  • 使用 <property>：

    • 当您需要定义一个静态的、在配置文件内部或从特定 .properties 文件加载的通用值时。
    • 当您主要关注配置的模块化和重用，并且值不会随运行时环境而频繁变化时。

  • 使用 <variable>：

    • 当您需要从 JVM 启动参数或操作系统环境变量中动态获取值时。
    • 当应用程序需要适应不同的部署环境，而这些环境的配置通过外部机制（如容器编排系统）注入时。
    • 当您需要在日志中包含一些运行时动态生成的标识符时。
结语

<property> 和 <variable> 是 Logback 灵活配置的关键组成部分。通过合理地利用它们，您可以创建高度可配置、易于管理和适应性强的日志系统。理解它们的区别和优先级查找规则，将帮助您更好地驾驭 Logback，确保您的应用程序在任何环境下都能高效、准确地记录信息。希望这篇博客能帮助您在 Logback 配置的道路上更进一步！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若转载，请注明出处：http://www.pswp.cn/web/89466.shtml
繁体地址，请注明出处：http://hk.pswp.cn/web/89466.shtml
英文地址，请注明出处：http://en.pswp.cn/web/89466.shtml

如若内容造成侵权/违法违规/事实不符，请联系英文站点网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

Java中excel字典转换

Java中excel字典转换

✅ 背景说明EasyExcel 原生的 ExcelProperty 注解不支持 dictType&#xff08;不像那样有 Excel(dictType"xxx")&#xff09;&#xff0c;所以如果你想实现字典翻译功能&#xff0c;就需要自己实现 Converter 接口&#xff0c;比如 DictConvert。✅ 什么是 DictConve…
阅读更多...
数据结构-3(双向链表、循环链表、栈、队列)

数据结构-3(双向链表、循环链表、栈、队列)

一、思维导图二、双向循环链表的判空、尾插、遍历(反向)、尾删class Node:def __init__(self, data):self.data dataself.next Noneself.prior Noneclass circularDoublyLinkedList():def __init__(self):self.head Noneself.tail Noneself.size 0def isEmpty(self):retu…
阅读更多...
IDEA运行Tomcat一直提示端口被占用（也查不到该端口）

IDEA运行Tomcat一直提示端口被占用（也查不到该端口）

首先查看是否是因为Java程序异常终止&#xff0c;进程没有完全释放导致。打开资源管理器&#xff0c;找到所有的java.exe&#xff0c;强制结束任务。如果仍然不行&#xff0c;那就极可能还是开启了hyper-V虚拟化&#xff0c;查看排除的tcp端口范围端口号没被占用却提示占用&…
阅读更多...
AWS Lambda 最佳实践：构建高效无服务器应用的完整指南

AWS Lambda 最佳实践：构建高效无服务器应用的完整指南

引言 AWS Lambda 作为无服务器计算的核心服务，让开发者能够专注于业务逻辑而无需管理服务器。本文将通过实际案例和代码示例，分享 Lambda 开发中的关键最佳实践。 1. 函数设计原则 单一职责原则 每个 Lambda 函数应该只做一件事，这样更容易测试、维护和扩展。 # ❌ 不推…
阅读更多...
29、鸿蒙Harmony Next开发：深浅色适配和应用主题换肤

29、鸿蒙Harmony Next开发：深浅色适配和应用主题换肤

目录 应用深浅色适配 应用跟随系统的深浅色模式 应用主动设置深浅色模式 系统默认判断规则 使用建议与限制 设置应用内主题换肤 概述 自定义主题色 设置应用内组件自定义主题色 设置应用局部页面自定义主题风格 设置应用页面局部深浅色 系统缺省token色值 应用深浅…
阅读更多...
源鉴SCA4.9︱多模态SCA引擎重磅升级，开源风险深度治理能力再次进阶

源鉴SCA4.9︱多模态SCA引擎重磅升级，开源风险深度治理能力再次进阶

SCA技术已成为数字供应链开源治理的关键入口。源鉴SCA深度融合悬镜原创专利级AI智能代码疫苗技术&#xff0c;是国内首款集源码组件成分分析、代码成分溯源分析、制品成分二进制分析、容器镜像成分扫描、运行时成分动态追踪及开源供应链安全情报预警分析等六大核心引擎为一体的…
阅读更多...
Git语义化提交规范及提交模板设置

Git语义化提交规范及提交模板设置

Git语义化提交规范&#xff08;Conventional Commits&#xff09; &#x1f4da; 常见的语义化提交类型包括&#xff1a;类型含义说明feat✨ 新增功能&#xff08;feature&#xff09;fix&#x1f41b; 修复 bugdocs&#x1f4da; 修改文档&#xff08;如 README&#xff09;st…
阅读更多...
用TensorFlow进行逻辑回归(五)

用TensorFlow进行逻辑回归(五)

Softmax分类#List3-50%matplotlib inlineimport numpy as npimport tensorflow as tfimport matplotlib.pyplot as pltx1_label0 np.random.normal(1, 1, (100, 1))x2_label0 np.random.normal(1, 1, (100, 1))x1_label1 np.random.normal(5, 1, (100, 1))x2_label1 np.ran…
阅读更多...
基于 Django + 协同过滤算法的电影推荐系统设计与实现

基于 Django + 协同过滤算法的电影推荐系统设计与实现

&#x1f3ac; 基于 Django 协同过滤算法的电影推荐系统设计与实现✍️ 本项目由成都理工大学宜宾校区的三位同学曾铭杨、杨皓麟、陈禧锦共同完成。项目以豆瓣电影数据为基础&#xff0c;通过协同过滤算法为用户构建个性化电影推荐服务&#xff0c;是一款集数据爬取、推荐算法…
阅读更多...
小白全栈项目部署指南

小白全栈项目部署指南

小白全栈项目部署指南&#xff1a;前端后端数据库完整攻略 &#x1f4d6; 写在前面 当你学会了基础的静态网站部署后&#xff0c;是不是想挑战更有趣的项目&#xff1f;比如一个能够注册登录、保存数据的完整应用&#xff1f; 这就需要学习全栈项目部署了&#xff01; 别被&quo…
阅读更多...
C# Linq 左关联查询详解与实践

C# Linq 左关联查询详解与实践

在 C# 开发中&#xff0c;Linq&#xff08;Language Integrated Query&#xff09;提供了强大的数据查询能力&#xff0c;尤其是在处理集合间的关联操作时。本文将详细解析 C# Linq 中的左关联查询&#xff0c;并通过实际案例说明其用法。左关联查询基础左关联&#xff08;Left…
阅读更多...
【机器学习深度学习】LoRA 微调详解：大模型时代的高效适配利器

【机器学习深度学习】LoRA 微调详解：大模型时代的高效适配利器

目录 前言 一、LoRA 的核心思想 二、LoRA 为什么高效&#xff1f; ✅ 1. 参数效率 ✅ 2. 内存友好 ✅ 3. 即插即用 三、LoRA 适用场景 四、LoRA 实践建议 五、LoRA 和全参数微调对比 六、 LoRA的具体定位 &#x1f4cc; 总结 &#x1f517; 延伸阅读 前言 在大模型…
阅读更多...
vue页面不销毁的情况下再返回，总是执行created，而不触发 activated

vue页面不销毁的情况下再返回，总是执行created，而不触发 activated

vue页面不销毁的情况下再返回&#xff0c;总是执行created&#xff0c;而不触发 activated 原因&#xff1a; 没有进行页面缓存地址和页面组件的name没对上 解决方案: 组件只有在被 包裹时才会触发 activated 和 deactivated 生命周期 如果没有被缓存&#xff0c;每次进入路由…
阅读更多...
从 C# 到 Python：6 天极速入门（第二天）

从 C# 到 Python：6 天极速入门（第二天）

作为一名资深 C# 开发者&#xff0c;我们在第一天已经掌握了 Python 的基础语法框架。今天我们将深入 Python 的特色语法与高级特性&#xff0c;通过实际项目开发场景的代码对比&#xff0c;理解这些特性在真实业务中的应用价值。一、简洁语法糖&#xff1a;项目开发中的实战应…
阅读更多...
MyBatis 动态 SQL：让 SQL 语句随条件灵活变化

MyBatis 动态 SQL：让 SQL 语句随条件灵活变化

目录 1. 动态SQL 1.1. if 1.1.1. 持久层接口添加方法 1.1.2. 映射文件添加标签 1.1.3. 编写测试方法 1.2. where 1.3. set 1.4. choose、when、otherwise 1.5. foreach 1.5.1. 遍历数组 1.5.2. 遍历Collection 1.5.3. 遍历Map 2. 总结 前言 本文来讲解MyBatis的动…
阅读更多...
AI 驱动的仪表板：从愿景到 Kibana

AI 驱动的仪表板：从愿景到 Kibana

作者&#xff1a;来自 Elastic Jeffrey Rengifo 及 Toms Mura 使用 LLM 处理图像并将其转换为 Kibana 仪表板。 想获得 Elastic 认证&#xff1f;了解下一次 Elasticsearch Engineer 培训的举办时间&#xff01; Elasticsearch 拥有众多新功能&#xff0c;帮助你为你的使用场景…
阅读更多...
AI产品经理面试宝典第17天：AI时代敏捷开发与MVP构建面试题与答法

AI产品经理面试宝典第17天：AI时代敏捷开发与MVP构建面试题与答法

机器学习MVP构建问题怎么答？ 面试官：请举例说明如何将业务问题转化为机器学习可解的问题？ 你的回答：以电商供应商评价为例，传统方法用人工设定的低维度指标评分，而机器学习能利用大数据构建高维模型。比如通过供应商历史交易数据、物流时效、售后投诉率等数百个特征，训…
阅读更多...
HBase2.5.4单机模式与伪分布式的安装与配置（Ubuntu系统）

HBase2.5.4单机模式与伪分布式的安装与配置（Ubuntu系统）

HBase的安装也分为三种&#xff0c;单机模式、伪分布式模式、完全分布式模式&#xff1b;我们先来安装单机版。 一、环境准备 1. 系统要求 Ubuntu 20.04/22.04 LTS Java 8&#xff08;必须&#xff0c;HBase不兼容更高版本&#xff09; Hadoop&#xff08;单机模式不需要&a…
阅读更多...
Honeywell霍尼韦尔DV-10 变速器放大器 输入 15-28 VDC,输出 +/- 10VDC 060-6881-02

Honeywell霍尼韦尔DV-10 变速器放大器 输入 15-28 VDC,输出 +/- 10VDC 060-6881-02

Honeywell霍尼韦尔DV-10 变速器放大器 输入 15-28 VDC,输出 /- 10VDC 060-6881-02
阅读更多...
腾讯位置商业授权鸿蒙地图SDK工程配置

腾讯位置商业授权鸿蒙地图SDK工程配置

工程配置 安装 DevEco Studio 开发环境 手机HarmonyOS系统&#xff1a;OpenHarmony-5.0.0.71及以上DevEco Studio版本&#xff1a;DevEco Studio NEXT Release(Build Version: 5.0.3.900)及以上 获取key与生成秘钥 获取key 登录腾讯位置服务控制台&#xff0c;未注册过账号可…
阅读更多...
最新文章

Copyright @ 2022~2023