如何设计通用模块结构,使子模块无需强转即可获取对应API的CommandSender
多模块命令体系结构设计
现有设计的问题根因
AbstractCommandService<S> 虽然提前声明了发送者类型泛型,但没有把泛型传递到ChildCommand接口,所有方法入参硬编码为Object,导致类型信息在执行链路中完全丢失,最终必须靠强制类型转换才能拿到对应平台的发送者对象。
common 模块改造(零外部依赖)
全部使用JDK原生泛型能力完成调整,不引入任何平台相关的类:
- 将
ChildCommand改造为泛型接口,把发送者类型作为泛型参数开放给上层实现 - 打通抽象命令服务的泛型链路,让服务存储的子命令、执行入参都和泛型类型对齐
- 修正原代码中用
HashMap初始化Set的笔误
改造后的common模块代码:
// ChildCommand 接口:泛型代表发送者类型 public interface ChildCommand<S> { void run(S sender, String[] args); String getName(); } // 抽象命令服务:绑定发送者泛型 public abstract class AbstractCommandService<S> { // 存储同类型的子命令集合 protected final Set<ChildCommand<S>> childCommands = new HashSet<>(); // 执行入参直接使用泛型类型,不再用Object public boolean execute(S sender, String commandName, String[] args) { for (ChildCommand<S> childCommand : childCommands) { if (childCommand.getName().equalsIgnoreCase(commandName)) { childCommand.run(sender, args); return true; } } return false; } public void addCommand(ChildCommand<S> command) { childCommands.add(command); } }
业务子模块适配
两个子模块不需要修改公共模块代码,只需要在实现接口、继承抽象服务时,把泛型参数替换为对应平台的CommandSender类型,即可在子命令的run方法中直接拿到强类型对象,完全消除强制类型转换。
bungee 模块改造
// 子命令实现:绑定泛型为Bungee平台的CommandSender public class BungeeReload implements ChildCommand<net.md_5.bungee.api.CommandSender> { private static final String NAME = "reload"; @Override public String getName() { return NAME; } // sender参数已是强类型,无需任何强转 @Override public void run(net.md_5.bungee.api.CommandSender sender, String[] args) { sender.sendMessage("Reload command has been ran on bungee."); } } // 命令服务:绑定泛型为Bungee平台的CommandSender public class BungeeCommandService extends AbstractCommandService<net.md_5.bungee.api.CommandSender> {} // 平台原生命令入口不需要修改,直接传入强类型sender即可 public class MainBungeeCommand extends Command { private final BungeeCommandService commandService; public MainBungeeCommand() { super("cmd-name", "cmd-permission", "cmd-alias"); commandService = new BungeeCommandService(); commandService.addCommand(new BungeeReload()); } @Override public void execute(net.md_5.bungee.api.CommandSender sender, String[] args) { if (args.length > 0) { String commandName = args[0]; boolean successfullyExecuted = commandService.execute(sender, commandName, args); if (!successfullyExecuted) { sender.sendMessage("Unknown command!"); } } } }
bukkit 模块改造
// 子命令实现:绑定泛型为Bukkit平台的CommandSender public class BukkitReload implements ChildCommand<org.bukkit.command.CommandSender> { private static final String NAME = "reload"; @Override public String getName() { return NAME; } // 同样无需强转,直接获取强类型sender @Override public void run(org.bukkit.command.CommandSender sender, String[] args) { sender.sendMessage("Reload command has been ran on bukkit."); } } // 命令服务:绑定泛型为Bukkit平台的CommandSender public class BukkitCommandService extends AbstractCommandService<org.bukkit.command.CommandSender> {} // 平台原生命令入口不需要修改 public class MainBukkitCommand implements CommandExecutor { private final BukkitCommandService commandService; public MainBukkitCommand() { commandService = new BukkitCommandService(); commandService.addCommand(new BukkitReload()); } @Override public boolean onCommand(org.bukkit.command.CommandSender sender, Command cmd, String label, String[] args) { if (args.length > 0) { String commandName = args[0]; boolean successfullyExecuted = commandService.execute(sender, commandName, args); if (!successfullyExecuted) { sender.sendMessage("Unknown command!"); } return true; } return false; } }
约束匹配验证
- common模块无外部依赖:所有逻辑仅用到JDK内置的泛型、集合能力,没有引入任何平台相关的第三方类
- 模块依赖关系符合要求:bungee模块仅依赖BungeeCord API和common模块,bukkit模块仅依赖Bukkit API和common模块
- 平台类型不冲突:两个模块各自绑定独立的
CommandSender类型,编译期泛型不跨模块传递,不存在类型兼容问题 - 不修改第三方API:所有交互完全遵循Bukkit、Bungee原生的命令接口规范,没有改动第三方提供的类
内容的提问来源于stack exchange,提问作者Lynx
相关产品推荐
相关产品推荐

