Trtr:注解编程:修订间差异

来自Hyacinth
跳转到导航 跳转到搜索
删除的内容 添加的内容
草awa留言 | 贡献
无编辑摘要
草awa留言 | 贡献
更新注解框架约定
第1行: 第1行:
'''注解编程''',是指在[[Trtr:Trtr]]的代码中,使用注解替代手动编写过多重复代码的设计模式。
'''注解编程''',是指在[[Trtr:Trtr]]的代码中,使用注解替代手动编写过多重复代码的设计模式,本质上是由一个[[IoC]]框架代替完成

= 约束 =
任何需要被自动处理的字段必须被"static"修饰<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/reflection/filed/FieldAccessor.java |title=FieldAccessor.java at main · cao-awa/the-road-to-reality |publisher=草awa |date=2023-03-16 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/b398df4af797d5170c6de9cacecbefbd4015cd18/src/main/java/com/github/cao/awa/trtr/framework/reflection/filed/FieldAccessor.java |archivedate=2023-03-16 |accessdate=2023-03-16 }}</ref>,这也包括已经自行初始化的字段。方法的修饰与正常开发时无异。


= 示例 =
= 示例 =
第24行: 第27行:


== 自动初始化 ==
== 自动初始化 ==
Trtr的[[IoC]]支持自动初始化字段,例如此处有一BlockItem:
Trtr的[[IoC]]框架支持自动初始化字段,例如此处有一BlockItem:
<syntaxhighlight lang="java">
<syntaxhighlight lang="java">
@Auto
@Auto
第48行: 第51行:
@Auto
@Auto
public static TestBlockItem ITEM;
public static TestBlockItem ITEM;
@Auto
public static Class<TestBlockItem> ITEM = TestBlockItem.class;


@Auto
@Auto
第57行: 第62行:


= 约定 =
= 约定 =
在使用注解编程时,我们约定字段的名称和类型。
在使用注解编程时,只有匹配约定字段的名称和类型才会被自动处理


== 字段 ==
== 字段 ==
=== 标识符 ===
标识符(Identifier)约定名称为"IDENTIFIER"、类型为:[[Minecraft:net.minecraft.util.Identifier/zh|net.minecraft.util.Identifier]]。
标识符(Identifier)约定名称为"IDENTIFIER"、类型为:[[Minecraft:net.minecraft.util.Identifier]]<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/identifier/IdentifierAccessor.java |title=IdentifierAccessor.java at main · cao-awa/the-road-to-reality |publisher=草awa |date=2023-03-15 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/d41d51d5316c67424e9391d5fbb1e818cce5818c/src/main/java/com/github/cao/awa/trtr/framework/identifier/IdentifierAccessor.java |archivedate=2023-03-15 |accessdate=2023-03-16 }}</ref>。


=== 设置(方块) ===
方块的设置(Settings)约定名称为"SETTINGS"、候选"SETTING",类型为:[[Minecraft:net.minecraft.block.AbstractBlock.Settings|net.minecraft.block.AbstractBlock.Settings]]及其子类,如[[Minecraft:net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSetting|net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSetting]]。
方块设置(Settings)约定名称为"SETTINGS"、备选"SETTING",类型为:[[Minecraft:net.minecraft.block.AbstractBlock.Settings]]的子类<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/block/setting/BlockSettingAccessor.java |title=BlockSettingAccessor.java at main · cao-awa/the-road-to-reality |publisher=草awa |date=2023-03-16 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/f9934c5c7fd078bf80b7effc50cd346cea6d3027/src/main/java/com/github/cao/awa/trtr/framework/block/setting/BlockSettingAccessor.java |archivedate=2023-03-16 |accessdate=2023-03-16 }}</ref>,如[[Minecraft:net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSetting|net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSetting]]。<ref name="example_block">{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/block/example/ExampleBlock.java |title=ExampleBlock.java at main · cao-awa/the-road-to-reality |publisher=草二号机 |date=2023-03-15 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/40ff64d245df47ca0c8b25db78252ab0cccbc62f/src/main/java/com/github/cao/awa/trtr/block/example/ExampleBlock.java |archivedate=2023-03-15 |accessdate=2023-03-16 }}</ref>


=== 方块物品 ===
方块的物品(BlockItem)约定名称为"ITEM"、候选"BLOCK_ITEM",类型为:任意[[Minecraft:net.minecraft.item.BlockItem|net.minecraft.item.BlockItem]]的子类。
方块物品(BlockItem)约定名称为"ITEM"、备选"BLOCK_ITEM",类型为:任意[[Minecraft:net.minecraft.item.BlockItem|net.minecraft.item.BlockItem]]的子类<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/block/item/BlockItemAccessor.java |title=BlockItemAccessor.java at main · cao-awa/the-road-to-reality |publisher=草awa |date=2023-03-16 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/f9934c5c7fd078bf80b7effc50cd346cea6d3027/src/main/java/com/github/cao/awa/trtr/framework/block/item/BlockItemAccessor.java |archivedate=2023-03-16 |accessdate=2023-03-16 }}</ref>。

或者以形如Class<? extends BlockItem>的方式声明类型。<ref name="example_block"></ref>

=== 方块战利品(数据生成) ===
方块战利品(Loot)约定名称为"LOOT"、备选"LOOT_PROVIDER",类型为[[Minecraft:net.fabricmc.fabric.api.datagen.v1.provider.SimpleFabricLootTableProvider]]的子类或[[Trtr:com.github.cao.awa.trtr.framework.data.gen.loot.LootFactory]]的实现<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/data/gen/loot/LootDataGeneratorAccessor.java |title=LootDataGeneratorAccessor.java |publisher=草awa |date=2023-03-16 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/b398df4af797d5170c6de9cacecbefbd4015cd18/src/main/java/com/github/cao/awa/trtr/framework/data/gen/loot/LootDataGeneratorAccessor.java |archivedate=2023-03-16 |accessdate=2023-03-16 }}</ref>,如[[Trtr:com.github.cao.awa.trtr.data.gen.loot.GenericBlockLootProvider]]。

或者以形如Class<? extends SimpleFabricLootTableProvider>或LootFactory<? extends SimpleFabricLootTableProvider>的方式声明类型。<ref name="example_block"></ref>

=== 方块模型(数据生成) ===
方块模型(models)约定名称为"MODEL"、备选"MODEL_PROVIDER",类型为[[Minecraft:net.fabricmc.fabric.api.datagen.v1.provider.FabricModelProvider]]的子类<ref>{{cite web |url=https://github.com/cao-awa/the-road-to-reality/blob/main/src/main/java/com/github/cao/awa/trtr/framework/data/gen/model/ModelDataGeneratorAccessor.java |title=ModelDataGeneratorAccessor.java at main · cao-awa/the-road-to-reality |publisher=草awa |date=2023-03-15 |archiveurl=https://github.com/cao-awa/the-road-to-reality/blob/b398df4af797d5170c6de9cacecbefbd4015cd18/src/main/java/com/github/cao/awa/trtr/framework/data/gen/model/ModelDataGeneratorAccessor.java |archivedate=2023-03-15 |accessdate=2023-03-16 }}</ref>,如[[Trtr:com.github.cao.awa.trtr.data.gen.model.GenericBlockModelProvider]]。

或者以形如Class<? extends BlockItem>的方式声明类型。<ref name="example_block"></ref>


== 方法 ==
== 方法 ==
第70行: 第90行:
= 样式 =
= 样式 =
在代码中,[[Trtr:com.github.cao.awa.apricot.annotations.Auto|@Auto]]注解最好在每一个会被自动处理的字段、方法和类上出现,以统一标准样式。但这一要求不是强制性的,只需要至少在类上添加注解即可使用注解编程,其他位置只是建议添加而非强制。
在代码中,[[Trtr:com.github.cao.awa.apricot.annotations.Auto|@Auto]]注解最好在每一个会被自动处理的字段、方法和类上出现,以统一标准样式。但这一要求不是强制性的,只需要至少在类上添加注解即可使用注解编程,其他位置只是建议添加而非强制。

= 参考 =
{{reflist}}

2023年3月17日 (五) 06:21的版本

註解編程,是指在Trtr:Trtr的代碼中,使用註解替代手動編寫過多重複代碼的設計模式,本質上是由一個IoC框架代替完成。

約束

任何需要被自動處理的字段必須被"static"修飾[1],這也包括已經自行初始化的字段。方法的修飾與正常開發時無異。

示例

在任意位置(合理的軟件包下)編寫如下代碼,而後直接運行Minecraft,此時不需要自行去註冊這個方塊,Trtr:方塊反射框架會處理好這一切。

以下字段"IDENTIFIER"和"SETTINGS"必須存在,必須大寫。

@Auto
public class TestBlock extends TrtrBlock {
    @Auto
    public static final Identifier IDENTIFIER = Identifier.of("trtr", "test");
    @Auto
    public static final Settings SETTINGS = FabricBlockSettings.of(Material.STONE, MapColor.GRAY);

    @Auto
    public TestBlock(Settings settings) {
        super(settings);
    }
}

任何被支持的字段都可以以類似以上的方式被自動處理,而開發者只需要寫更少量的重複代碼。

自動初始化

Trtr的IoC框架支持自動初始化字段,例如此處有一BlockItem:

@Auto
public class TestBlockItem extends TrtrBlockItem {
    @Auto
    public static final FabricItemSettings SETTINGS = new FabricItemSettings();

    @Auto
    public AluniteOreItem(Block block, Settings settings) {
        super(block, settings);
    }
}

這時候可以直接在TestBlock中加入字段"ITEM"或"BLOCK_ITEM",而不需要任何的賦值。如下所示:

@Auto
public class TestBlock extends TrtrBlock {
    @Auto
    public static final Identifier IDENTIFIER = Identifier.of("trtr", "test");
    @Auto
    public static final Settings SETTINGS = FabricBlockSettings.of(Material.STONE, MapColor.GRAY);
    @Auto
    public static TestBlockItem ITEM;
    @Auto
    public static Class<TestBlockItem> ITEM = TestBlockItem.class;

    @Auto
    public TestBlock(Settings settings) {
        super(settings);
    }
}

約定

在使用註解編程時,只有匹配約定字段的名稱和類型才會被自動處理。

字段

標識符

標識符(Identifier)約定名稱為"IDENTIFIER"、類型為:Minecraft:net.minecraft.util.Identifier[2]

設置(方塊)

方塊設置(Settings)約定名稱為"SETTINGS"、備選"SETTING",類型為:Minecraft:net.minecraft.block.AbstractBlock.Settings的子類[3],如net.fabricmc.fabric.api.object.builder.v1.block.FabricBlockSetting[4]

方塊物品

方塊物品(BlockItem)約定名稱為"ITEM"、備選"BLOCK_ITEM",類型為:任意net.minecraft.item.BlockItem的子類[5]

或者以形如Class<? extends BlockItem>的方式聲明類型。[4]

方塊戰利品(數據生成)

方塊戰利品(Loot)約定名稱為"LOOT"、備選"LOOT_PROVIDER",類型為Minecraft:net.fabricmc.fabric.api.datagen.v1.provider.SimpleFabricLootTableProvider的子類或Trtr:com.github.cao.awa.trtr.framework.data.gen.loot.LootFactory的實現[6],如Trtr:com.github.cao.awa.trtr.data.gen.loot.GenericBlockLootProvider

或者以形如Class<? extends SimpleFabricLootTableProvider>或LootFactory<? extends SimpleFabricLootTableProvider>的方式聲明類型。[4]

方塊模型(數據生成)

方塊模型(models)約定名稱為"MODEL"、備選"MODEL_PROVIDER",類型為Minecraft:net.fabricmc.fabric.api.datagen.v1.provider.FabricModelProvider的子類[7],如Trtr:com.github.cao.awa.trtr.data.gen.model.GenericBlockModelProvider

或者以形如Class<? extends BlockItem>的方式聲明類型。[4]

方法

樣式

在代碼中,@Auto註解最好在每一個會被自動處理的字段、方法和類上出現,以統一標準樣式。但這一要求不是強制性的,只需要至少在類上添加註解即可使用註解編程,其他位置只是建議添加而非強制。

參考

  1. "FieldAccessor.java at main · cao-awa/the-road-to-reality". 草awa. 2023-03-16. Archived from the original on 2023-03-16. Retrieved 2023-03-16.
  2. "IdentifierAccessor.java at main · cao-awa/the-road-to-reality". 草awa. 2023-03-15. Archived from the original on 2023-03-15. Retrieved 2023-03-16.
  3. "BlockSettingAccessor.java at main · cao-awa/the-road-to-reality". 草awa. 2023-03-16. Archived from the original on 2023-03-16. Retrieved 2023-03-16.
  4. 4.0 4.1 4.2 4.3 "ExampleBlock.java at main · cao-awa/the-road-to-reality". 草二號機. 2023-03-15. Archived from the original on 2023-03-15. Retrieved 2023-03-16.
  5. "BlockItemAccessor.java at main · cao-awa/the-road-to-reality". 草awa. 2023-03-16. Archived from the original on 2023-03-16. Retrieved 2023-03-16.
  6. "LootDataGeneratorAccessor.java". 草awa. 2023-03-16. Archived from the original on 2023-03-16. Retrieved 2023-03-16.
  7. "ModelDataGeneratorAccessor.java at main · cao-awa/the-road-to-reality". 草awa. 2023-03-15. Archived from the original on 2023-03-15. Retrieved 2023-03-16.