Package net.fabricmc.loom.pipeline

Class ExecutionProcessorContext

java.lang.Object

net.fabricmc.loom.pipeline.ExecutionProcessorContext

All Implemented Interfaces:

ProcessorContext

public final class ExecutionProcessorContext
extends Object
implements ProcessorContext

执行期可用的 ProcessorContext 实现.

ProcessorContextImpl 只能在配置期使用：它持有 ConfigContext，并通过 LoomGradleExtension 读项目模型。本类把这些依赖整体换成两类输入——**可被配置缓存 序列化的值**与**执行期由 ServiceFactory 取得的服务**，从而让 jar 处理器能在 Gradle 任务 里运行。

各项输入的来源

输入与来源

接口方法	本类输入	配置期对应物
isSplit()	ExecutionProcessorContext.JarConfigurationKind	是否 MinecraftJarConfiguration.SPLIT
isMerged() / includesClient() / includesServer()	MinecraftJar.Type	MinecraftJar 实例上的同名方法
getMappings()	TinyMappingsService.Options	MappingConfiguration.getMappingsService(...)
createRemapper(MappingsNamespace, MappingsNamespace)	TinyRemapperService.Options	TinyRemapperHelper.getTinyRemapper(project, ...)
disableObfuscation() / getProductionNamespace() / getIntermediaryNamespace()	布尔值 / 两个枚举	LoomGradleExtension 上的同名取值

与原实现的语义差异

1. ProcessorContextImpl.createRemapper 返回的 LazyCloseable 在 close() 时 调用 TinyRemapper.finish()；本类返回的 remapper 归 TinyRemapperService 所有， 由该服务在自身 close() 时 finish，故本类的 close() 不再重复 finish。 这与 MinecraftJarRemap 对「外部装配的 remapper」的处理一致。
2. createRemapper 只能提供任务已经装配好的那一对命名空间（见该方法说明）。

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ExecutionProcessorContext.JarConfigurationKind	MinecraftJarConfiguration 的可序列化身份.

Constructor Summary

Constructors

Constructor	Description
ExecutionProcessorContext(ServiceFactory serviceFactory, ExecutionProcessorContext.JarConfigurationKind jarConfiguration, MinecraftJar.Type jarType, boolean disableObfuscation, MappingsNamespace productionNamespace, MappingsNamespace intermediaryNamespace, TinyMappingsService.Options mappingsOptions, TinyRemapperService.Options remapperOptions)

Method Summary

Modifier and Type	Method	Description
LazyCloseable<net.fabricmc.tinyremapper.TinyRemapper>	createRemapper(MappingsNamespace from, MappingsNamespace to)
boolean	disableObfuscation()
MappingsNamespace	getIntermediaryNamespace()	本平台在工具链中自带数据文件所用的命名空间：fabric/quilt 为 intermediary、 forge 为 srg、neoforge 为 mojang.
net.fabricmc.mappingio.tree.MemoryMappingTree	getMappings()
MappingsNamespace	getProductionNamespace()
boolean	includesClient()
boolean	includesServer()
boolean	isMerged()
boolean	isSplit()	本上下文服务的 jar 是否来自 split（客户端与服务端分开产出）配置.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ExecutionProcessorContext

public ExecutionProcessorContext(ServiceFactory serviceFactory,
 ExecutionProcessorContext.JarConfigurationKind jarConfiguration,
 MinecraftJar.Type jarType,
 boolean disableObfuscation,
 MappingsNamespace productionNamespace,
 MappingsNamespace intermediaryNamespace,
 TinyMappingsService.Options mappingsOptions,
 TinyRemapperService.Options remapperOptions)

Parameters:

serviceFactory - 执行期的作用域服务工厂，通常在一次任务动作内创建并随任务结束关闭

jarConfiguration - 本次构建的 jar 配置身份

jarType - 本上下文服务的那个 jar 的类型

disableObfuscation - 是否禁用混淆

productionNamespace - 生产命名空间

intermediaryNamespace - 平台默认命名空间，例如 Forge 的 srg

mappingsOptions - 取映射树所需的映射服务配置

remapperOptions - 取重映射器所需的重映射服务配置

Method Details

isSplit

public boolean isSplit()

Description copied from interface: ProcessorContext

本上下文服务的 jar 是否来自 split（客户端与服务端分开产出）配置.

split 配置会产出两个 jar，它们与 client only / server only 配置产出的 jar 在 ProcessorContext.isMerged()、ProcessorContext.includesClient()、ProcessorContext.includesServer() 上完全一致： 单看一个 jar 无法区分「这是 split 的一半」还是「本来就是单边配置」。 只有本方法能给出这一信息，需要在 split 下改变行为的 processor 必须用它判断。

Specified by:

isSplit in interface ProcessorContext

Returns:

本 jar 是否属于 split 配置

isMerged

public boolean isMerged()

Specified by:

isMerged in interface ProcessorContext

includesClient

public boolean includesClient()

Specified by:

includesClient in interface ProcessorContext

includesServer

public boolean includesServer()

Specified by:

includesServer in interface ProcessorContext

getMappings

public net.fabricmc.mappingio.tree.MemoryMappingTree getMappings()

Specified by:

getMappings in interface ProcessorContext

disableObfuscation

public boolean disableObfuscation()

Specified by:

disableObfuscation in interface ProcessorContext

getProductionNamespace

public MappingsNamespace getProductionNamespace()

Specified by:

getProductionNamespace in interface ProcessorContext

getIntermediaryNamespace

public MappingsNamespace getIntermediaryNamespace()

Description copied from interface: ProcessorContext

本平台在工具链中自带数据文件所用的命名空间：fabric/quilt 为 intermediary、 forge 为 srg、neoforge 为 mojang.

它与 ProcessorContext.getProductionNamespace() 不是一回事：后者可以被用户配置成 official 之类的取值，而平台自带的文件（例如 Forge 的 accesstransformer.cfg） 始终写在平台自己的命名空间里。

Specified by:

getIntermediaryNamespace in interface ProcessorContext

Returns:

平台默认命名空间

createRemapper

public LazyCloseable<net.fabricmc.tinyremapper.TinyRemapper> createRemapper(MappingsNamespace from,
 MappingsNamespace to)

执行期的重映射器由 TinyRemapperService 统一装配，而它的 from/to 是任务输入的一部分， 不能被调用方任意改写。因此只有当请求的命名空间对与 TinyRemapperService.Options 声明的 那一对一致时才返回 remapper，否则抛出异常——现有处理器请求的都是 productionNamespace -> named，任务按这一对装配即可。

Specified by:

createRemapper in interface ProcessorContext