TDLightTelegramBots/telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/methods/groupadministration/SetChatTitle.java

74 lines
2.3 KiB
Java
Raw Normal View History

2018-07-08 01:41:21 +02:00
package org.telegram.telegrambots.meta.api.methods.groupadministration;
2017-06-30 14:15:48 +02:00
import com.fasterxml.jackson.annotation.JsonProperty;
2020-11-01 23:46:36 +01:00
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.NonNull;
import lombok.Setter;
import lombok.ToString;
2022-06-14 22:20:22 +02:00
import lombok.experimental.Tolerate;
2022-06-16 19:57:41 +02:00
import org.telegram.telegrambots.meta.api.methods.botapimethods.BotApiMethodBoolean;
2018-07-08 01:41:21 +02:00
import org.telegram.telegrambots.meta.exceptions.TelegramApiValidationException;
2017-06-30 14:15:48 +02:00
/**
* @author Ruben Bermudez
* @version 3.1
* Use this method to change the title of a chat. Titles can't be changed for private chats.
* The bot must be an administrator in the chat for this to work and must have the appropriate admin rights.
* Returns True on success.
*
* @apiNote In regular groups (non-supergroups), this method will only work if the All Members Are Admins setting is off in the target group.
*/
2020-11-01 23:46:36 +01:00
@EqualsAndHashCode(callSuper = false)
@Getter
@Setter
@ToString
@NoArgsConstructor
@AllArgsConstructor
@Builder
2022-06-16 19:36:20 +02:00
public class SetChatTitle extends BotApiMethodBoolean {
2017-06-30 14:15:48 +02:00
public static final String PATH = "setChatTitle";
private static final String CHATID_FIELD = "chat_id";
private static final String TITLE_FIELD = "title";
@JsonProperty(CHATID_FIELD)
2020-11-01 23:46:36 +01:00
@NonNull
2017-06-30 14:15:48 +02:00
private String chatId; ///< Required. Unique identifier for the target chat or username of the target channel (in the format @channelusername)
@JsonProperty(TITLE_FIELD)
2020-11-01 23:46:36 +01:00
@NonNull
2022-11-08 19:33:50 +01:00
private String title; ///< Required. New chat title, 1-128 characters
2017-06-30 14:15:48 +02:00
2022-06-14 22:20:22 +02:00
@Tolerate
public void setChatId(@NonNull Long chatId) {
this.chatId = chatId.toString();
}
2017-06-30 14:15:48 +02:00
@Override
public String getMethod() {
return PATH;
}
@Override
public void validate() throws TelegramApiValidationException {
2022-06-14 22:20:22 +02:00
if (chatId.isEmpty()) {
2017-06-30 14:15:48 +02:00
throw new TelegramApiValidationException("ChatId can't be empty", this);
}
2022-06-14 22:20:22 +02:00
if (title.isEmpty()) {
2017-06-30 14:15:48 +02:00
throw new TelegramApiValidationException("Title can't be empty", this);
}
}
2022-06-14 22:20:22 +02:00
public static class SetChatTitleBuilder {
@Tolerate
public SetChatTitleBuilder chatId(@NonNull Long chatId) {
this.chatId = chatId.toString();
return this;
}
}
2017-06-30 14:15:48 +02:00
}