[v1.3.0] [A] 添加Java注释，修改debug消息位置。

pom.xml

@@ -15,7 +15,7 @@
     <groupId>cc.carm.plugin</groupId>
     <artifactId>ultradepository</artifactId>
     <packaging>jar</packaging>
-    <version>1.2.6</version>
+    <version>1.3.0</version>
 
     <name>UltraDepository</name>
     <description>超级仓库插件，支持设定不同物品的存储仓库。</description>

src/main/java/cc/carm/plugin/ultradepository/configuration/PluginMessages.java

@@ -95,4 +95,8 @@ public class PluginMessages extends MessagesRoot {
 			"&f数目输入错误，请输入正确的数字！"
 	);
 
+	public static final EasyMessage LOAD_FAILED = new EasyMessage(
+			"&c您的背包数据未被正确加载，请重新进入！"
+	);
+
 }

src/main/java/cc/carm/plugin/ultradepository/listener/UserListener.java

@@ -1,6 +1,7 @@
 package cc.carm.plugin.ultradepository.listener;
 
 import cc.carm.plugin.ultradepository.UltraDepository;
+import cc.carm.plugin.ultradepository.configuration.PluginMessages;
 import cc.carm.plugin.ultradepository.data.UserData;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
@@ -20,8 +21,8 @@ public class UserListener implements Listener {
 			return;
 		}
 		UUID uuid = event.getUniqueId();
-		UltraDepository.getInstance().debug("尝试加载玩家 " + event.getName() + " 的数据...");
+		UltraDepository.getUserManager().getDataCache()
-		UltraDepository.getUserManager().getDataCache().put(uuid, UltraDepository.getUserManager().loadData(uuid));
+				.put(uuid, UltraDepository.getUserManager().loadData(uuid));
 	}
 
 	@EventHandler(priority = EventPriority.MONITOR)
@@ -36,7 +37,7 @@ public class UserListener implements Listener {
 		UserData data = UltraDepository.getUserManager().getData(e.getPlayer().getUniqueId());
 		if (data == null) {
 			e.setResult(PlayerLoginEvent.Result.KICK_OTHER);
-			e.setKickMessage(UltraDepository.getInstance().getName() + " 数据未被正确加载，请重新进入。");
+			e.setKickMessage(PluginMessages.LOAD_FAILED.get(e.getPlayer()));
 		}
 	}
 
@@ -44,7 +45,8 @@ public class UserListener implements Listener {
 	public void onQuit(PlayerQuitEvent event) {
 		Player player = event.getPlayer();
 		UUID playerUUID = player.getUniqueId();
-		UltraDepository.getInstance().getScheduler().runAsync(() -> UltraDepository.getUserManager().unloadData(playerUUID, true));
+		UltraDepository.getInstance().getScheduler()
+				.runAsync(() -> UltraDepository.getUserManager().unloadData(playerUUID, true));
 	}
 
 }

src/main/java/cc/carm/plugin/ultradepository/manager/UserManager.java

@@ -32,7 +32,7 @@ public class UserManager {
 		try {
 			long start = System.currentTimeMillis();
 			DataStorage storage = UltraDepository.getStorage();
-			UltraDepository.getInstance().debug("正通过 " + storage.getClass().getSimpleName() + " 加载 " + userUUID + " 的用户数据...");
+			UltraDepository.getInstance().debug("正通过 " + storage.getClass().getSimpleName() + " 加载 " + userUUID + " 的用户数据...(" + System.currentTimeMillis() + ")");
 			UserData data = UltraDepository.getStorage().loadData(userUUID);
 
 			if (data == null) {
@@ -64,7 +64,7 @@ public class UserManager {
 			long start = System.currentTimeMillis();
 			DataStorage storage = UltraDepository.getStorage();
 
-			UltraDepository.getInstance().debug("正通过 " + storage.getClass().getSimpleName() + " 保存 " + data.getUserUUID() + " 的用户数据...");
+			UltraDepository.getInstance().debug("正通过 " + storage.getClass().getSimpleName() + " 保存 " + data.getUserUUID() + " 的用户数据...(" + System.currentTimeMillis() + ")");
 			storage.saveUserData(data);
 
 			UltraDepository.getInstance().debug("通过 " + storage.getClass().getSimpleName() + " 保存 " + data.getUserUUID() + " 的用户数据完成，" +

src/main/java/cc/carm/plugin/ultradepository/storage/DataStorage.java

@@ -1,6 +1,7 @@
 package cc.carm.plugin.ultradepository.storage;
 
 import cc.carm.plugin.ultradepository.data.UserData;
+import cc.carm.plugin.ultradepository.manager.UserManager;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -8,14 +9,38 @@ import java.util.UUID;
 
 public interface DataStorage {
 
-
+	/**
+	 * 在插件加载存储源时执行。
+	 *
+	 * @return 是否初始化成功
+	 */
 	boolean initialize();
 
+	/**
+	 * 在插件被卸载时执行。
+	 */
 	void shutdown();
 
+	/**
+	 * 用于加载用户数据的方法。<bold>该方法将会被异步运行！</bold>
+	 * <br>该方法一般无需自行执行，见 {@link UserManager#loadData(UUID)}
+	 * <br>
+	 * <br>若不存在该用户的数据，请返回 null 。
+	 * <br>若加载出现任何错误，请抛出异常。
+	 *
+	 * @param uuid 用户UUID
+	 * @throws Exception 当出现任何错误时抛出
+	 */
 	@Nullable
 	UserData loadData(@NotNull UUID uuid) throws Exception;
 
+	/**
+	 * 用于保存用户数据的方法。 <bold>该方法将会被异步运行！</bold>
+	 * <br>该方法一般无需自行执行，见 {@link UserManager#saveData(UserData)}
+	 *
+	 * @param data 用户数据
+	 * @throws Exception 当出现任何错误时抛出
+	 */
 	void saveUserData(@NotNull UserData data) throws Exception;
 
 	/**