Package dev.architectury.loom.accesstransformer

Class AccessTransformerJarProcessor

java.lang.Object

dev.architectury.loom.accesstransformer.AccessTransformerJarProcessor

All Implemented Interfaces:

MinecraftJarProcessor<AccessTransformerJarProcessor.Spec>, org.gradle.api.Named

public class AccessTransformerJarProcessor
extends Object
implements MinecraftJarProcessor<AccessTransformerJarProcessor.Spec>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	AccessTransformerJarProcessor.AccessTransformerConfiguration
static final record	AccessTransformerJarProcessor.Descriptor	用于在执行期重建 AccessTransformerJarProcessor 的描述符.
static final record	AccessTransformerJarProcessor.Spec

Nested classes/interfaces inherited from interface net.fabricmc.loom.api.processor.MinecraftJarProcessor

MinecraftJarProcessor.MappingsProcessor<S>, MinecraftJarProcessor.ProcessorDescriptor<T extends MinecraftJarProcessor<?>>

Nested classes/interfaces inherited from interface org.gradle.api.Named

org.gradle.api.Named.Namer

Constructor Summary

Constructors

Constructor	Description
AccessTransformerJarProcessor(String name, Iterable<File> localAccessTransformers, AccessTransformerService.Tool tool, org.gradle.api.model.ObjectFactory objectFactory)	执行期重建用构造器：不依赖 Project，AT 工具信息与对象工厂都由描述符提供.
AccessTransformerJarProcessor(String name, org.gradle.api.Project project, Iterable<File> localAccessTransformers, org.gradle.api.model.ObjectFactory objectFactory)	配置期构造器：AT 工具推迟到真正需要时（descriptor() 或 processJar(java.nio.file.Path, dev.architectury.loom.accesstransformer.AccessTransformerJarProcessor.Spec, net.fabricmc.loom.api.processor.ProcessorContext)）再解析.

Method Summary

Modifier and Type	Method	Description
@Nullable AccessTransformerJarProcessor.Spec	buildSpec(SpecContext context)
AccessTransformerJarProcessor.Descriptor	descriptor()	返回一个描述符，用于在执行期重建本 processor 的实例.
String	getName()
void	processJar(Path jar, AccessTransformerJarProcessor.Spec spec, ProcessorContext context)

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.fabricmc.loom.api.processor.MinecraftJarProcessor

processMappings

Constructor Details

AccessTransformerJarProcessor

@Inject
public AccessTransformerJarProcessor(String name,
 org.gradle.api.Project project,
 Iterable<File> localAccessTransformers,
 org.gradle.api.model.ObjectFactory objectFactory)

配置期构造器：AT 工具推迟到真正需要时（descriptor() 或 processJar(java.nio.file.Path, dev.architectury.loom.accesstransformer.AccessTransformerJarProcessor.Spec, net.fabricmc.loom.api.processor.ProcessorContext)）再解析.

AccessTransformerJarProcessor

public AccessTransformerJarProcessor(String name,
 Iterable<File> localAccessTransformers,
 AccessTransformerService.Tool tool,
 org.gradle.api.model.ObjectFactory objectFactory)

执行期重建用构造器：不依赖 Project，AT 工具信息与对象工厂都由描述符提供.

本构造器由 AccessTransformerJarProcessor.Descriptor.createProcessor(org.gradle.api.model.ObjectFactory) 直接调用而不经 ObjectFactory.newInstance： 本类唯一的 @Inject 构造器需要一个 Project，执行期无法提供，而 Gradle 在存在 @Inject 构造器时只会用它，传参形态再吻合也不会选到另一个构造器。

Method Details

buildSpec

public @Nullable AccessTransformerJarProcessor.Spec buildSpec(SpecContext context)

Specified by:

buildSpec in interface MinecraftJarProcessor<AccessTransformerJarProcessor.Spec>

processJar

public void processJar(Path jar,
 AccessTransformerJarProcessor.Spec spec,
 ProcessorContext context)
                throws IOException

Specified by:

processJar in interface MinecraftJarProcessor<AccessTransformerJarProcessor.Spec>

Throws:

IOException

getName

public String getName()

Specified by:

getName in interface org.gradle.api.Named

descriptor

public AccessTransformerJarProcessor.Descriptor descriptor()

Description copied from interface: MinecraftJarProcessor

返回一个描述符，用于在执行期重建本 processor 的实例.

配置期构造的 processor 实例常常持有无法放进任务状态的对象（例如 Project、 Gradle 服务对象、任意的第三方实现），直接作为任务输入会破坏配置缓存。因此把重建所需的最小输入 提取成描述符中的纯值，由执行期的任务调用 MinecraftJarProcessor.ProcessorDescriptor.createProcessor(org.gradle.api.model.ObjectFactory) 重建实例。

默认实现直接抛出异常，以保证对既有第三方实现的二进制与源码兼容：未实现本方法的 processor 依然可以正常参与配置期的处理，只是无法参与执行期重建。

Specified by:

descriptor in interface MinecraftJarProcessor<AccessTransformerJarProcessor.Spec>