com.germ.germplugin.api

Interface GermSlotAPI.SlotDAOHandler

Enclosing class:

GermSlotAPI

public static interface GermSlotAPI.SlotDAOHandler

槽位数据访问对象处理器接口

定义了槽位数据的增删改查操作

Method Summary

Modifier and Type	Method and Description
java.util.Collection<java.lang.String>	getAllIdentitys() 获取所有槽位标识符
@NotNull org.bukkit.inventory.ItemStack	getFromIdentity(java.lang.String playerName, java.lang.String identity) 从指定槽位获取物品
java.util.Map<java.lang.String,org.bukkit.inventory.ItemStack>	getFromIdentitys(java.lang.String playerName, java.util.Collection<java.lang.String> identitys) 批量从多个槽位获取物品
default @NotNull java.lang.Object	getLock(@NotNull java.lang.String playerName) 获取槽位物品的读写锁 SimpleSlotHandler和SaferSlotHandler将返回GermSlotAPI.class， SaferSlotHandlerV2将根据玩家名返回不同的锁 当你尝试编辑萌芽槽位物品时，为了防止编辑过程中其他插件修改此物品， 你应该通过synchronized (GermSlotAPI.getSlotDAOHandler().getLock(playerName))上锁
default boolean	saveItemStackToDatabase(java.lang.String playerName, java.lang.String identity, org.bukkit.inventory.ItemStack itemStack) 保存物品到数据库的完整流程 执行顺序：触发GermGuiSlotSaveEvent → 执行saveToIdentity → 触发GermGuiSlotSavedEvent
void	saveToIdentity(java.lang.String playerName, java.lang.String identity, org.bukkit.inventory.ItemStack itemStack) 保存物品到指定槽位

Method Detail

getAllIdentitys

java.util.Collection<java.lang.String> getAllIdentitys()

获取所有槽位标识符

Returns:

所有槽位ID的集合

saveToIdentity

void saveToIdentity(java.lang.String playerName,
                    java.lang.String identity,
                    org.bukkit.inventory.ItemStack itemStack)

保存物品到指定槽位

Parameters:

playerName - 玩家名称

identity - 槽位标识符

itemStack - 要存储的物品

saveItemStackToDatabase

default boolean saveItemStackToDatabase(java.lang.String playerName,
                                        java.lang.String identity,
                                        org.bukkit.inventory.ItemStack itemStack)

保存物品到数据库的完整流程

执行顺序：触发GermGuiSlotSaveEvent → 执行saveToIdentity → 触发GermGuiSlotSavedEvent

Parameters:

playerName - 玩家名称

identity - 槽位标识符

itemStack - 要存储的物品

Returns:

是否保存成功

getFromIdentity

@NotNull
@NotNull org.bukkit.inventory.ItemStack getFromIdentity(java.lang.String playerName,
                                                                  java.lang.String identity)

从指定槽位获取物品

Parameters:

playerName - 玩家名称

identity - 槽位标识符

Returns:

槽位中的物品，不应该返回null，空槽位应该返回 Material.AIR

getFromIdentitys

java.util.Map<java.lang.String,org.bukkit.inventory.ItemStack> getFromIdentitys(java.lang.String playerName,
                                                                                java.util.Collection<java.lang.String> identitys)

批量从多个槽位获取物品

Parameters:

playerName - 玩家名称

identitys - 槽位标识符集合

Returns:

槽位ID到物品的映射表

getLock

@NotNull
default @NotNull java.lang.Object getLock(@NotNull
                                                    @NotNull java.lang.String playerName)

获取槽位物品的读写锁

SimpleSlotHandler和SaferSlotHandler将返回GermSlotAPI.class， SaferSlotHandlerV2将根据玩家名返回不同的锁

当你尝试编辑萌芽槽位物品时，为了防止编辑过程中其他插件修改此物品， 你应该通过synchronized (GermSlotAPI.getSlotDAOHandler().getLock(playerName))上锁

Parameters:

playerName - 玩家名称

Returns:

用于同步的锁对象