Fabric Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======= Внедрение интерфейса =======

Это новый метод, представленный Loom 0.11 для добавления методов в определенный существующий класс. Более конкретно, вы можете создать интерфейс, а затем внедрить этот интерфейс в класс. В результате целевой класс получит все методы интерфейса, как если бы они у него всегда были. Внедрение интерфейса - это функция только во время компиляции, это означает, что для реализации интерфейса в целевом классе также следует использовать Миксин.

Это особенно полезно для библиотек, с помощью этого вы можете добавлять новые методы в существующие классы и использовать их без необходимости каждый раз приводить или переопределять интерфейс.

Давайте лучше объясним на примере:

Область применения этого примера состоит в том, чтобы добавить следующий метод в ''<yarn net.minecraft.class_3609>'', чтобы получить звук ведра при опустошении.
Обычно это невозможно, потому что ''<yarn net.minecraft.class_3609>'' не имеет аналогичного метода.

<yarncode java [enable_line_numbers="false"]>
Optional<class_3414> getBucketEmptySound()
</yarncode>

Чтобы добавить метод в класс, прежде всего вам нужно создать с ним интерфейс:

<yarncode java [enable_line_numbers="false"]>
package net.fabricmc.example;

public interface BucketEmptySoundGetter {
	// Методы во внедренном интерфейсе ДОЛЖНЫ быть по умолчанию,
	// в противном случае код, ссылающийся на них, не будет компилироваться!
	default Optional<class_3414> getBucketEmptySound() {
		return Optional.empty();
	}
}
</yarncode>

Теперь вам нужно реализовать этот интерфейс в ''<yarn net.minecraft.class_3609>'' с помощью миксина, реализующего интерфейс:

<yarncode java [enable_line_numbers="false"]>
@Mixin(class_3609.class)
public class MixinFlowableFluid implements BucketEmptySoundGetter {
	@Override
	public Optional<class_3414> getBucketEmptySound() {
		//Вот как получить звук по умолчанию, скопированный из класса BucketItem.
		return Optional.of(((FlowableFluid) (Object) this).isIn(FluidTags.LAVA) ? SoundEvents.ITEM_BUCKET_EMPTY_LAVA : SoundEvents.ITEM_BUCKET_EMPTY);
	}
}
</yarncode>

Наконец, вам нужно ввести интерфейс в ''<yarn net.minecraft.class_3609>''.
Следующий фрагмент можно добавить в ваш файл fabric.mod.json, чтобы добавить один или несколько интерфейсов к классу ''<yarn net.minecraft.class_3609>''.
Обратите внимание, что все имена классов здесь должны использовать "внутренние имена", которые используют косые черты вместо точек (''example/path/to/Class'').

<code json [enable_line_numbers="false"]>
{
	"custom": {
		"loom:injected_interfaces": {
			"net/minecraft/class_3609": ["net/fabricmc/example/BucketEmptySoundGetter"]
		}
	}
}
</code>

Теперь вы можете использовать новый метод:

<yarncode java [enable_line_numbers="false"]>
Optional<class_3414> sound = mytestfluid.getBucketEmptySound();
</yarncode>

Вы также можете переопределить этот метод в классах, расширяющих FlowableFluid, для реализации пользовательского поведения.