Он барои коркарди паёми қабулшуда масъул аст. Ба мо танҳо аз синфи MessageReceivedEvent лозим аст, ки сатри паёми қабулшуда аст (масалан, "Салом" ё "Бот, салом"). Инро ба назар гирифтан лозим аст: дар китобхонаҳои гуногун ин синфҳоро ба таври гуногун меноманд. Ман китобхонаро барои Discord истифода кардам. Ва аз ин рӯ, мо мехоҳем, ки бот ба баъзе фармонҳое, ки аз "Bot" оғоз мешаванд, вокуниш нишон диҳад (бо вергул ё бе вергул - худатон қарор кунед: ба хотири ин дарс, мо фикр мекунем, ки дар он ҷо вергул набояд бошад). Яъне, функсияи мо бо чизе ба монанди:
publicvoidonMessageReceived(MessageReceivedEvent event){//Убираем чувствительность к регистру (БоТ, бОт и т.д.)String message = event.getMessage().toLowerCase();if(message.startsWith("бот")){}}
Ва холо мо барои ичрои ин ё он фармон вариантхои зиёде дорем. Бешубҳа, аввал шумо бояд фармонро аз далелҳои он ҷудо кунед, яъне онро ба массив тақсим кунед.
publicvoidonMessageReceived(MessageReceivedEvent event){//Убираем чувствительность к регистру (БоТ, бОт и т.д.)String message = event.getMessage().toLowerCase();if(message.startsWith("бот")){try{//получим массив {"Бот", "(команду)", "аргумент1", "аргумент2",... "аргументN"};String[] args = message.split(" ");//Для удобства уберем "бот" и отделим команду от аргументовString command = args[1];String[] nArgs =Arrays.copyOfRange(args,2, args.length);//Получor command = "(команда)"; nArgs = {"аргумент1", "аргумент2",..."аргументN"};//Данный массив может быть пустым}catch(ArrayIndexOutOfBoundsException e){//Вывод списка команд or Howого-либо messages//В случае если просто написать "Бот"}}}
Ҳеҷ гуна роҳе нест, ки мо аз ин порчаи code канорагирӣ кунем, зеро ҷудо кардани фармон аз аргументҳо ҳамеша зарур аст. Аммо пас мо интихоби худро дорем:
Оё агар(command.equalsIngnoreCase("..."))
Гузариш кунед (фармон)
Як роҳи дигари коркардро иҷро кунед ...
Ё ба ёрии Аннотацияҳо муроҷиат кунед.
Ва ҳоло мо ниҳоят ба қисми амалии истифодаи Аннотацияҳо расидем. Биёед codeи эзоҳро барои вазифаи мо бубинем (албатта он метавонад фарқ кунад).
importjava.lang.annotation.ElementType;importjava.lang.annotation.Retention;importjava.lang.annotation.RetentionPolicy;importjava.lang.annotation.Target;//Указывает, что наша Аннотация может быть использована//Во время выполнения через Reflection (нам How раз это нужно).@Retention(RetentionPolicy.RUNTIME)//Указывает, что целью нашей Аннотации является метод//Не класс, не переменная, не поле, а именно метод.@Target(ElementType.METHOD)public@interfaceCommand//Описание. Заметим, что перед interface стоит @;{//Команда за которую будет отвечать функция (например "привет");Stringname();//Аргументы команды, использоваться будут для вывода списка командStringargs();//Минимальное количество аргументов, сразу присвоor 0 (логично)intminArgs()default0;//Описание, тоже для спискаStringdesc();//Максимальное число аргументов. В целом не обязательно, но тоже можно использоватьintmaxArgs()defaultInteger.MAX_VALUE;//Показывать ли команду в списке (вовсе необязательная строка, но мало ли, пригодится!)booleanshowInHelp()defaulttrue;//Какие команды будут считаться эквивалентными нашей//(Например для "привет", это может быть "Здаров", "Прив" и т.д.)//Под каждый случай заводить функцию - не рациональноString[]aliases();}
publicclassCommandListener{@Command(name ="привет",
args ="",
desc ="Будь культурным, поздоровайся",
showInHelp =false,
aliases ={"здаров"})publicvoidhello(String[] args){//Какой-то функционал, на Ваше усмотрение.}@Command(name ="пока",
args ="",
desc ="",
aliases ={"удачи"})publicvoidbye(String[] args){// Функционал}@Command(name ="помощь",
args ="",
desc ="Выводит список команд",
aliases ={"help","команды"})publicvoidhelp(String[] args){StringBuilder sb =newStringBuilder("Список команд: \n");for(Method m :this.getClass().getDeclaredMethods()){if(m.isAnnotationPresent(Command.class)){Command com = m.getAnnotation(Command.class);if(com.showInHelp())//Если нужно показывать команду в списке.{
sb.append("Бот, ").append(com.name()).append(" ").append(com.args()).append(" - ").append(com.desc()).append("\n");}}}//Отправка sb.toString();}}
Як нороҳатии хурдро қайд кардан бамаврид аст: т. Мо ҳоло барои универсалӣ мубориза мебарем, ҳамаи функсияҳо бояд як рӯйхати параметрҳои расмӣ дошта бошанд, аз ин рӯ ҳатто агар фармон ягон далел надошта бошад, функсия бояд параметри String[] args дошта бошад . Мо ҳоло 3 фармонро тавсиф кардем: салом, хайр, кӯмак. Акнун биёед MessageListener-и худро тағир диҳем , то бо ин коре кунем. Барои роҳат ва суръати кор, мо фавран фармонҳои худро дар HashMap нигоҳ медорем :
publicclassMessageListner{//Map который хранит How ключ команду//А How meaning функцию которая будет обрабатывать командуprivatestaticfinalMap<String,Method> COMMANDS =newHashMap<>();//Объект класса с командами (по сути нужен нам для рефлексии)privatestaticfinalCommandListener LISTENER =newCommandListener();static{//Берем список всех методов в классе CommandListenerfor(Method m : LISTENER.getClass().getDeclaredMethods()){//Смотрим, есть ли у метода нужная нам Аннотация @Commandif(m.isAnnotationPresent(Command.class)){//Берем an object нашей АннотацииCommand cmd = m.getAnnotation(Command.class);//Кладем в качестве ключа нашей карты параметр name()//Определенный у нашей аннотации,//m — переменная, хранящая наш метод
COMMANDS.put(cmd.name(), m);//Также заносим каждый элемент aliases//Как ключ указывающий на тот же самый метод.for(String s : cmd.aliases()){
COMMANDS.put(s, m);}}}}publicvoidonMessageReceived(MessageReceivedEvent event){String message = event.getMessage().toLowerCase();if(message.startsWith("бот")){try{String[] args = message.split(" ");String command = args[1];String[] nArgs =Arrays.copyOfRange(args,2, args.length);Method m = COMMANDS.get(command);if(m ==null){//(вывод помощи)return;}Command com = m.getAnnotation(Command.class);if(nArgs.length < com.minArgs()){//что-то если аргументов меньше чем нужно}elseif(nArgs.length > com.maxArgs()){//что-то если аргументов больше чем нужно}//Через рефлексию вызываем нашу функцию-обработчик//Именно потому что мы всегда передаем nArgs у функции должен быть параметр//String[] args — иначе она просто не будет найдена;
m.invoke(LISTENER, nArgs);}catch(ArrayIndexOutOfBoundsException e){//Вывод списка команд or Howого-либо messages//В случае если просто написать "Бот"}}}}
Барои кори коллективхои мо хамаи он чиз лозим аст. Ҳоло илова кардани фармони нав чизи нав нест, агар на парвандаи нав, ки дар он шумораи аргументҳо бояд дубора ҳисоб карда шаванд ва кӯмак низ бояд аз нав навишта шавад ва ба он сатрҳои нав илова карда шавад. Ҳоло, барои илова кардани фармон, мо бояд танҳо як функсияи навро бо шарҳи @Command дар синфи CommandListener илова кунем ва ин аст - фармон илова карда мешавад, ҳолатҳо ба назар гирифта мешаванд, кӯмак ба таври худкор илова карда мешавад. Комилан бахснопазир аст, ки ин проблемаро бо роххои дигар хал кардан мумкин аст. Бале, ҳама чизеро, ки бо ёрии эзоҳҳо/рефлексияҳо анҷом додан мумкин аст, бе онҳо анҷом додан мумкин аст, саволи ягона ин роҳатӣ, оптималӣ ва андозаи code аст, албатта, дар ҳама ҷое, ки каме ишорае вуҷуд дорад, ки онро истифода бурдан мумкин аст. он инчунин варианти оқилонатарин нест, дар ҳама чиз ба шумо лозим аст, ки донед, ки кай қатъ кардан лозим аст =). Аммо ҳангоми навиштани API-ҳо, Китобхонаҳо ё барномаҳое, ки дар онҳо codeи як навъ (вале на маҳз якхела) такрор кардан мумкин аст, эзоҳҳо бешубҳа ҳалли беҳтарин мебошанд.
GO TO FULL VERSION