discord4j.rest.entity.RestChannel Maven / Gradle / Ivy
/*
* This file is part of Discord4J.
*
* Discord4J is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Discord4J is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Discord4J. If not, see getData() {
return restClient.getChannelService().getChannel(id);
}
public RestMessage message(long messageId) {
return RestMessage.create(restClient, id, messageId);
}
/**
* Request to edit this text channel using a given {@link ChannelModifyRequest} as body and optionally, a reason.
*
* @param request request body used to create a new message
* @param reason a reason for this action, can be {@code null}
* @return a {@link Mono} where, upon successful completion, emits the edited {@link ChannelData}. If an error is
* received, it is emitted through the {@code Mono}.
* @see Modify Channel
*/
public Mono modify(ChannelModifyRequest request, @Nullable String reason) {
return restClient.getChannelService().modifyChannel(id, request, reason);
}
/**
* Request to delete this channel while optionally specifying a reason.
*
* @param reason a reason for this action, can be {@code null}
* @return A {@link Mono} where, upon successful completion, emits nothing; indicating the channel has been deleted.
* If an error is received, it is emitted through the {@code Mono}.
* @see
* Delete/Close Channel
*/
public Mono delete(@Nullable String reason) {
return restClient.getChannelService().deleteChannel(id, reason).then();
}
/**
* Request to retrieve all messages before the specified ID.
*
* The returned {@code Flux} will emit items in reverse-chronological order (newest to oldest). It is
* recommended to limit the emitted items by invoking either {@link Flux#takeWhile(Predicate)} (to retrieve IDs
* within a specified range) or {@link Flux#take(long)} (to retrieve a specific amount of IDs).
*
* The following example will get all messages from {@code messageId} to {@code myOtherMessageId}:
* {@code getMessagesBefore(messageId).takeWhile(message -> message.getId().compareTo(myOtherMessageId) >= 0)}
*
* @param messageId The ID of the newest message to retrieve.
* @return A {@link Flux} that continually emits all {@link MessageData messages} before the
* specified ID. If an error is received, it is emitted through the {@code Flux}.
* @see
* Get Channel Messages
*/
public Flux getMessagesBefore(long messageId) {
Function, Flux> doRequest =
params -> restClient.getChannelService().getMessages(id, params);
return PaginationUtil.paginateBefore(doRequest, data -> Snowflake.asLong(data.id()), messageId, 100);
}
/**
* Request to retrieve all messages after the specified ID.
*
* The returned {@code Flux} will emit items in chronological order (oldest to newest). It is recommended to limit
* the emitted items by invoking either {@link Flux#takeWhile(Predicate)} (to retrieve IDs within a specified range)
* or {@link Flux#take(long)} (to retrieve a specific amount of IDs).
*
* The following example will get all messages from {@code messageId} to {@code myOtherMessageId}:
* {@code getMessagesAfter(messageId).takeWhile(message -> message.getId().compareTo(myOtherMessageId) <= 0)}
*
* @param messageId the ID of the oldest message to retrieve.
* @return a {@link Flux} that continually emits all {@link MessageData messages} after the
* specified ID. If an error is received, it is emitted through the {@code Flux}.
* @see
* Get Channel Messages
*/
public Flux getMessagesAfter(long messageId) {
Function, Flux> doRequest = params ->
restClient.getChannelService().getMessages(id, params);
return PaginationUtil.paginateAfter(doRequest, data -> Snowflake.asLong(data.id()), messageId, 100);
}
/**
* Create a {@link RestMessage} entity for a given ID under this channel. This method does not perform any
* network request.
*
* @param messageId the message's ID
* @return a {@link RestMessage} facade for the given message under this channel to perform actions on it
*/
public RestMessage getRestMessage(long messageId) {
return RestMessage.create(restClient, id, messageId);
}
/**
* Request to create a message using a given {@link MessageCreateRequest} as body. If you want to include
* attachments to your message, see {@link #createMessage(MultipartRequest)}.
*
* @param request request body used to create a new message
* @return a {@link Mono} where, upon successful completion, emits the created {@link MessageData}. If an
* error is received, it is emitted through the {@code Mono}.
* @see Create Message
*/
public Mono createMessage(MessageCreateRequest request) {
return restClient.getChannelService().createMessage(id, new MultipartRequest(request));
}
/**
* Request to create a message using a given {@link MultipartRequest} as body. A {@link MultipartRequest} is a
* custom object allowing you to add attachments to a message.
*
* @param request request body used to create a new message
* @return a {@link Mono} where, upon successful completion, emits the created {@link MessageData}. If an
* error is received, it is emitted through the {@code Mono}.
* @see Create Message
*/
public Mono createMessage(MultipartRequest request) {
// TODO: improve API to create MultipartRequest objects
return restClient.getChannelService().createMessage(id, request);
}
/**
* Request to bulk delete the supplied message IDs.
*
* @param messageIds a {@link Publisher} to supply the message IDs to bulk delete.
* @return a {@link Flux} that continually emits {@link Long message IDs} that were not bulk deleted
* (typically if the ID was older than 2 weeks). If an error is received, it is emitted through the {@code Flux}.
* @see
* Bulk Delete Messages
*/
public Flux bulkDelete(Publisher messageIds) {
Instant timeLimit = Instant.now().minus(Duration.ofDays(14L));
Collection ignoredMessageIds = new ArrayList<>(0);
Function asTimestamp = id -> Instant.ofEpochMilli(1420070400000L + (id >>> 22));
Predicate filterMessageId = messageId -> {
if (timeLimit.isAfter(asTimestamp.apply(messageId))) { // REST accepts 2 week old IDs
ignoredMessageIds.add(messageId);
return false;
}
return true;
};
Function, Mono> filterMessageIdChunk = messageIdChunk ->
Mono.just(messageIdChunk.get(0)) // REST accepts 2 or more items
.filter(ignore -> messageIdChunk.size() == 1)
.flatMap(id -> restClient.getChannelService()
.deleteMessage(this.id, Long.parseLong(id), null)
.thenReturn(id))
.hasElement()
.map(identity -> !identity);
return Flux.defer(() -> messageIds)
.distinct()
.filter(filterMessageId)
.map(String::valueOf)
.buffer(100) // REST accepts 100 IDs
.filterWhen(filterMessageIdChunk)
.flatMap(messageIdChunk -> restClient.getChannelService()
.bulkDeleteMessages(id, ImmutableBulkDeleteRequest.of(messageIdChunk)))
.thenMany(Flux.fromIterable(ignoredMessageIds));
}
/**
* Request to edit channel permission overwrites for the given member or role while optionally specifying a reason.
*
* @param targetId the ID of the member or role to add the overwrite for
* @param request the overwrite request to edit
* @param reason the reason, if present
* @return a {@link Mono} where, upon successful completion, emits nothing; If an error is received, it is emitted
* through the {@code Mono}
* @see
* Edit Channel Permissions
*/
public Mono editChannelPermissions(long targetId, PermissionsEditRequest request, @Nullable String reason) {
return restClient.getChannelService().editChannelPermissions(id, targetId, request, reason);
}
/**
* Request to retrieve this channel's invites.
*
* @return a {@link Flux} that continually emits this channel's {@link InviteData invites}. If an error is
* received, it is emitted through the {@code Flux}.
* @see
* Get Channel Invites
*/
public Flux getInvites() {
return restClient.getChannelService().getChannelInvites(id);
}
/**
* Request to create an invite.
*
* @param request request body used to create a new invite
* @param reason the reason, if present
* @return a {@link Mono} where, upon successful completion, emits the created {@link InviteData}. If an error
* is received, it is emitted through the {@code Mono}.
* @see
* Create Channel Invite
*/
public Mono createInvite(InviteCreateRequest request, @Nullable String reason) {
return restClient.getChannelService().createChannelInvite(id, request, reason);
}
/**
* Request to delete this permission overwrite while optionally specifying a reason.
*
* @param reason the reason, if present.
* @return a {@link Mono} where, upon successful completion, emits nothing; indicating the permission overwrite has
* been deleted. If an error is received, it is emitted through the {@code Mono}.
* @see
* Delete Channel Permission
*/
public Mono deleteChannelPermission(long targetId, @Nullable final String reason) {
return restClient.getChannelService().deleteChannelPermission(id, targetId, reason);
}
/**
* Request to trigger the typing indicator in this channel. A single invocation of this method will trigger the
* indicator for 10 seconds or until the bot sends a message in this channel.
*
* @return a {@link Mono} which completes upon successful triggering of the typing indicator in this channel. If
* an error is received, it is emitted through the {@code Mono}.
* @see
* Trigger Typing Indicator
*/
public Mono type() {
return restClient.getChannelService().triggerTypingIndicator(id);
}
/**
* Request to retrieve all the pinned messages for this channel.
*
* @return a {@link Flux} that continually emits all the pinned messages for this channel. If an error is received,
* it is emitted through the {@code Flux}.
* @see
* Get Pinned Messages
*/
public Flux getPinnedMessages() {
return restClient.getChannelService().getPinnedMessages(id);
}
/**
* Request to pin a message in this channel.
*
* @return A {@link Mono} where, upon successful completion, emits nothing; indicating the messaged was pinned. If
* an error is received, it is emitted through the {@code Mono}.
*/
public Mono addPinnedMessage(long messageId) {
return restClient.getChannelService().addPinnedMessage(id, messageId);
}
/**
* Request to unpin a message in this channel.
*
* @return A {@link Mono} where, upon successful completion, emits nothing; indicating the message was unpinned. If
* an error is received, it is emitted through the {@code Mono}.
*/
public Mono deletePinnedMessage(long messageId) {
return restClient.getChannelService().deletePinnedMessage(id, messageId);
}
public Mono addGroupDMRecipient(long userId, GroupAddRecipientRequest request) {
return restClient.getChannelService().addGroupDMRecipient(id, userId, request);
}
public Mono deleteGroupDMRecipient(long userId) {
return restClient.getChannelService().deleteGroupDMRecipient(id, userId);
}
public Flux getWebhooks() {
return restClient.getWebhookService().getChannelWebhooks(id);
}
}