Package org.javacord.api.entity.channel

Interface ServerThreadChannel

    • Method Detail

      • getParent

        RegularServerChannel getParent()
        The parent regular server channel of this thread.
        Returns:
        The parent of this thread.

      • getMessageCount

        int getMessageCount()
        Gets an approximate count of messages in this thread that stops counting at 50.
        Returns:
        The count of messages in this thread.

      • getMemberCount

        int getMemberCount()
        Gets an approximate count of users in this thread that stops counting at 50.
        Returns:
        The count of users in this thread.

      • getAutoArchiveDuration

        int getAutoArchiveDuration()
        Gets the duration for newly created threads, in minutes, to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080.
        Returns:
        The duration for newly created threads.

      • isArchived

        boolean isArchived()
        Whether this thread is archived.
        Returns:
        Whether this thread is archived.

      • isLocked

        boolean isLocked()
        Whether this thread is locked. When a thread is locked, only users with MANAGE_THREADS can unarchive it.
        Returns:
        Whether this thread is locked.

      • isPrivate

        default boolean isPrivate()
        Whether this thread is private. When a thread is private, it is only viewable by those invited and those with the MANAGE_THREADS permission.
        Returns:
        Whether this thread is private.

      • isPublic

        default boolean isPublic()
        Whether this thread is private. When a thread is private, it is only viewable by those invited and those with the MANAGE_THREADS permission.
        Returns:
        Whether this thread is private.

      • getOwnerId

        long getOwnerId()
        Gets the id of the creator of the tread.
        Returns:
        The id of the owner.

      • requestOwner

        default java.util.concurrent.CompletableFuture<User> requestOwner()
        Gets the creator of the thread.

        If the creator is in the cache, the creator is served from the cache.

        Returns:
        The creator of the thread.

      • getArchiveTimestamp

        java.time.Instant getArchiveTimestamp()
        Gets the timestamp when the thread's archive status was last changed, used for calculating recent activity.
        Returns:
        The timestamp when the thread's archive status was last changed.

      • getMembers

        java.util.List<ThreadMember> getMembers()
        List of the members of the thread.
        Returns:
        The members of the current thread.

      • getCurrentCachedInstance

        default java.util.Optional<ServerThreadChannel> getCurrentCachedInstance()
        Description copied from interface: UpdatableFromCache
        Gets an updated instance of this entity from the cache. 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, that gets updates from Discord, in case this one was invalidated.

        This method returns the currently cached entity, or an empty Optional if the entity is not cached any longer, for example because it was deleted or the message was thrown out of the cache.

        Specified by:
        getCurrentCachedInstance in interface Channel
        Specified by:
        getCurrentCachedInstance in interface ServerChannel
        Specified by:
        getCurrentCachedInstance in interface TextChannel
        Specified by:
        getCurrentCachedInstance in interface UpdatableFromCache
        Returns:
        The current cached instance.

      • getLatestInstance

        default java.util.concurrent.CompletableFuture<ServerThreadChannel> 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 Channel
        Specified by:
        getLatestInstance in interface ServerChannel
        Specified by:
        getLatestInstance in interface TextChannel
        Specified by:
        getLatestInstance in interface Updatable
        Specified by:
        getLatestInstance in interface UpdatableFromCache
        Returns:
        The current cached instance.

      • addThreadMember

        default java.util.concurrent.CompletableFuture<java.lang.Void> addThreadMember​(User user)
        Adds a member to this thread.
        Parameters:
        user - The user which should be added.
        Returns:
        A future to check if the update was successful.

      • addThreadMember

        java.util.concurrent.CompletableFuture<java.lang.Void> addThreadMember​(long userId)
        Adds a member to this thread.
        Parameters:
        userId - The user ID which should be added.
        Returns:
        A future to check if the update was successful.

      • removeThreadMember

        default java.util.concurrent.CompletableFuture<java.lang.Void> removeThreadMember​(User user)
        Removes a member to this thread.
        Parameters:
        user - The user which should be removed.
        Returns:
        A future to check if the update was successful.

      • removeThreadMember

        java.util.concurrent.CompletableFuture<java.lang.Void> removeThreadMember​(long userId)
        Removes a member to this thread.
        Parameters:
        userId - The user ID which should be removed.
        Returns:
        A future to check if the update was successful.

      • joinThread

        default java.util.concurrent.CompletableFuture<java.lang.Void> joinThread()
        Joins this ServerThreadChannel.
        Returns:
        A future to check if the update was successful.

      • leaveThread

        default java.util.concurrent.CompletableFuture<java.lang.Void> leaveThread()
        Leaves this ServerThreadChannel.
        Returns:
        A future to check if the update was successful.

      • getThreadMembers

        java.util.concurrent.CompletableFuture<java.util.List<ThreadMember>> getThreadMembers()
        Gets a list of all members in this thread. Requires the Intent.GUILD_MEMBERS intent.
        Returns:
        a list of all members in this thread.