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

73 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.RequiredArgsConstructor;
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 description of a supergroup or channels.
* The bot must be an administrator in the chat for this to work and must have the appropriate admin rights.
* Returns True on success.
*/
2020-11-01 23:46:36 +01:00
@EqualsAndHashCode(callSuper = false)
@Getter
@Setter
@ToString
2023-05-30 03:33:18 +02:00
@NoArgsConstructor(force = true)
2020-11-01 23:46:36 +01:00
@RequiredArgsConstructor
@AllArgsConstructor
@Builder
2022-06-16 19:36:20 +02:00
public class SetChatDescription extends BotApiMethodBoolean {
2017-06-30 14:15:48 +02:00
public static final String PATH = "setChatDescription";
private static final String CHATID_FIELD = "chat_id";
private static final String DESCRIPTION_FIELD = "description";
@JsonProperty(CHATID_FIELD)
2020-11-01 23:46:36 +01:00
@NonNull
2017-06-30 14:15:48 +02:00
private String chatId; ///< Unique identifier for the target chat or username of the target channel (in the format @channelusername)
@JsonProperty(DESCRIPTION_FIELD)
2020-11-01 23:46:36 +01:00
private String description; ///< Optional. New chat description, 0-255 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);
}
if (description == null) {
throw new TelegramApiValidationException("Description can't be null", this);
}
}
2022-06-14 22:20:22 +02:00
public static class SetChatDescriptionBuilder {
@Tolerate
public SetChatDescriptionBuilder chatId(@NonNull Long chatId) {
this.chatId = chatId.toString();
return this;
}
}
2017-06-30 14:15:48 +02:00
}