Interface Webhook

    • Method Detail

      • getServerId

        Optional<Long> getServerId​()
        Gets the server id of the webhook.
        Returns:
        The server id of the webhook.
      • getServer

        Optional<Server> getServer​()
        Gets the server of the webhook.
        Returns:
        The server of the webhook.
      • getChannelId

        long getChannelId​()
        Gets the channel id of the webhook.
        Returns:
        The channel id of the webhook.
      • getChannel

        Optional<TextChannel> getChannel​()
        Gets the channel of the webhook.
        Returns:
        The channel of the webhook.
      • getCreator

        Optional<User> getCreator​()
        Gets the creator of the webhook.
        Returns:
        The creator of the webhook.
      • getName

        Optional<String> getName​()
        Gets the default name of the webhook.
        Returns:
        The default name of the webhook.
      • getAvatar

        Optional<Icon> getAvatar​()
        Gets the default avatar of the webhook.
        Returns:
        The default avatar of the webhook.
      • getToken

        Optional<String> getToken​()
        Gets the secure token of the webhook.
        Returns:
        The secure token of the webhook.
      • delete

        default CompletableFuture<Void> delete​()
        Deletes the webhook.
        Returns:
        A future to tell us if the deletion was successful.
      • delete

        CompletableFuture<Void> delete​(String reason)
        Deletes the webhook.
        Parameters:
        reason - The audit log reason for the deletion.
        Returns:
        A future to tell us if the deletion was successful.
      • createUpdater

        default WebhookUpdater createUpdater​()
        Gets the updater for this webhook.
        Returns:
        The updater for this webhook.
      • updateName

        default CompletableFuture<Webhook> updateName​(String name)
        Updates the name of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() which provides a better performance!

        Parameters:
        name - The new name of the webhook.
        Returns:
        The updated webhook.
      • updateChannel

        default CompletableFuture<Webhook> updateChannel​(ServerTextChannel channel)
        Updates the channel of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() which provides a better performance!

        Parameters:
        channel - The new channel of the webhook.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(BufferedImage avatar)
        Updates the avatar of the webhook. This method assumes the file type is "png"!

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(BufferedImage avatar,
                                                        String fileType)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        fileType - The type of the avatar, e.g. "png" or "jpg".
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(File avatar)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(Icon avatar)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(URL avatar)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(byte[] avatar)
        Updates the avatar of the webhook. This method assumes the file type is "png"!

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(byte[] avatar,
                                                        String fileType)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        fileType - The type of the avatar, e.g. "png" or "jpg".
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(InputStream avatar)
        Updates the avatar of the webhook. This method assumes the file type is "png"!

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        Returns:
        The updated webhook.
      • updateAvatar

        default CompletableFuture<Webhook> updateAvatar​(InputStream avatar,
                                                        String fileType)
        Updates the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() ()} which provides a better performance!

        Parameters:
        avatar - The new avatar.
        fileType - The type of the avatar, e.g. "png" or "jpg".
        Returns:
        The updated webhook.
      • removeAvatar

        default CompletableFuture<Webhook> removeAvatar​()
        Removes the avatar of the webhook.

        If you want to update several settings at once, it's recommended to use the WebhookUpdater from createUpdater() which provides a better performance!

        Returns:
        The updated webhook.
      • getLatestInstance

        default CompletableFuture<Webhook> getLatestInstance​()
        Description copied from interface: Updatable
        Gets an updated instance of this entity from the cache or from Discord directly. This is for example necessary if an instance got invalid by a reconnect to Discord which invalidates all existing instances which means they do not get any further updates from Discord applied. Due to that, references to instances should usually not be held for an extended period of time. If they are, this method can be used to retrieve the current instance from the cache if present or from Discord directly.

        This method returns the currently cached entity if present, or request the entity from Discord if it is not cached or not permanently cached. If the entity is a fully cached entity and is not in the cache any longer, for example because it was deleted or the message was thrown out of the cache, the CompletableFuture completes exceptionally with a NoSuchElementException. If a request to Discord is made, the according remote call exception will be used to complete the CompletableFuture exceptionally.

        Specified by:
        getLatestInstance in interface Updatable<Webhook>
        Returns:
        The current cached instance.