You need to enable JavaScript to run this app. 如何设计通用模块结构,使子模块无需强转即可获取对应API的CommandSender
优惠活动
大模型
产品
解决方案
定价
更多

如何设计通用模块结构,使子模块无需强转即可获取对应API的CommandSender

多模块命令体系结构设计

现有设计的问题根因

AbstractCommandService<S> 虽然提前声明了发送者类型泛型,但没有把泛型传递到ChildCommand接口,所有方法入参硬编码为Object,导致类型信息在执行链路中完全丢失,最终必须靠强制类型转换才能拿到对应平台的发送者对象。

common 模块改造(零外部依赖)

全部使用JDK原生泛型能力完成调整,不引入任何平台相关的类:

  1. 将ChildCommand改造为泛型接口,把发送者类型作为泛型参数开放给上层实现
  2. 打通抽象命令服务的泛型链路,让服务存储的子命令、执行入参都和泛型类型对齐
  3. 修正原代码中用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 18:15:04