微服务框架MicroProfile上下文传播(MicroProfile Context Propagation)安装与使用指南

微服务框架MicroProfile上下文传播(MicroProfile Context Propagation)安装与使用指南

microprofile-context-propagation项目地址:https://gitcode.com/gh_mirrors/mi/microprofile-context-propagation

目录结构及介绍

在MicroProfile Context Propagation项目中，主要的目录及其作用如下：

• src/main/java: 存放了实现MicroProfile Context Propagation规范的所有Java源代码。

  • org.eclipse.microprofile.context.spi: 包含了与上下文传播相关的SPI接口定义。
  • org.eclipse.microprofile.context: 提供了一系列用于管理线程上下文的类，如ManagedExecutor, ThreadContextBuilder等。

• src/test/java: 包含单元测试代码，用于验证项目的功能正确性。

• src/main/resources: 内置资源文件和配置文件的位置，例如microprofile-config.properties可以在这里找到或自定义添加。

• pom.xml: Maven构建脚本，定义了项目依赖，插件以及构建目标。

项目的启动文件介绍

MicroProfile应用程序通常是作为JAR包部署到容器中的（如Tomcat, Wildfly）。对于MicroProfile Context Propagation项目而言，其本身并不提供一个可独立运行的应用实例，而是一套可用于开发微服务应用的APIs。

开发者可以通过以下方式来启动集成有MicroProfile Context Propagation的服务：

1. 在你的微服务项目中引入MicroProfile Context Propagation的依赖，然后通过Maven或Gradle进行打包并发布至服务器；
2. 或者，在已有的Java EE应用服务器上启用MicroProfile特性。

对于直接启动，通常涉及到将应用程序打包成Fat JAR或WAR文件，具体取决于你的开发环境和部署需求。例如，你可以使用下面命令进行打包（假设你在项目的根目录下）：

mvn clean install

这将自动执行单元测试、编译代码、创建JAR文件等操作。

项目的配置文件介绍

MicroProfile Context Propagation配置主要通过microprofile-config.properties文件进行设置，此文件通常位于src/main/resources/META-INF/目录下。以下是一种可能的配置示例:

mp.context.ThreadContext.propagated=SECURITY,APPLICATION
mp.context.ThreadContext.cleared=TRANSACTION
mp.context.ThreadContext.unchanged=REMAINING

以上配置指定了哪些类型上下文应该在新线程中传递下去，哪些应清除，哪些保持不变。例如，“SECURITY”和“APPLICATION”上下文被标记为propagated，即它们将会被复制到新的线程上下文中；“TRANSACTION”上下文则会被清除，不会出现在新线程中。

此外，ManagedExecutor 和 ThreadContext 的属性也可以通过microprofile-config.properties来设定默认值，比如：

my-executor.maxAsync=4
my-executor.maxQueued=16

这些配置允许在不修改代码的情况下，动态调整运行时行为。当配置与代码中的属性冲突时，程序中显式指定的属性优先级更高。

---

注：实际开发环境中，你可以根据自己的业务需求进一步扩展配置项的内容和范围，以适应更复杂的应用场景。

microprofile-context-propagation项目地址:https://gitcode.com/gh_mirrors/mi/microprofile-context-propagation