[]
服务端命令的核心处理函数为execute,默认的返回值为 ExecuteResult 类型。
约定规定,返回 execute.errCode 值为 0 表示成功,非 0 为失败。如果 errCode 为非 0 时,如果存在多种错误情况,插件开发者可以自行定义 errCode,以方便调试。
public class MyPluginServerCommand extends Command implements ICommandExecutableInServerSide {
@Override
public ExecuteResult execute(IServerCommandExecuteContext dataContext) {
int errorType = checkSomeThing();
if(errorType == 1){
return new ExecuteResult(1,"异常情况1发生了");
}
if(errorType == 2){
return new ExecuteResult(2,"异常情况2发生了");
}
return new ExecuteResult();
}
private int checkSomeThing() {
return 0;
}
@Override
public String toString() {
return "我的服务端命令插件";
}
}
如果execute抛出未处理的异常,活字格会自动把 errCode 设置为 500, message 设置为异常信息并生成日志。