Interface InviteAction

    • Method Detail

      • timeout

        @Nonnull
        InviteAction timeout​(long timeout,
                             @Nonnull
                             TimeUnit unit)
        Description copied from interface: AuditableRestAction
        Timeout for this RestAction instance.
        If the request doesn't get executed within the timeout it will fail.

        When a RestAction times out, it will fail with a TimeoutException. This is the same as deadline(System.currentTimeMillis() + unit.toMillis(timeout)).

        Example

        
         action.timeout(10, TimeUnit.SECONDS) // 10 seconds from now
               .queueAfter(20, SECONDS); // request will not be executed within deadline and timeout immediately after 20 seconds
         
        Specified by:
        timeout in interface AuditableRestAction<Invite>
        Specified by:
        timeout in interface RestAction<Invite>
        Parameters:
        timeout - The timeout to use
        unit - Unit for the timeout value
        Returns:
        The same RestAction instance with the applied timeout
        See Also:
        RestAction.setDefaultTimeout(long, TimeUnit)
      • setMaxAge

        @Nonnull
        @CheckReturnValue
        InviteAction setMaxAge​(@Nullable
                               Integer maxAge)
        Sets the max age in seconds for the invite. Set this to 0 if the invite should never expire. Default is 86400 (24 hours). null will reset this to the default value.
        Parameters:
        maxAge - The max age for this invite or null to use the default value.
        Returns:
        The current InviteAction for chaining.
        Throws:
        IllegalArgumentException - If maxAge is negative.
      • setMaxAge

        @Nonnull
        @CheckReturnValue
        InviteAction setMaxAge​(@Nullable
                               Long maxAge,
                               @Nonnull
                               TimeUnit timeUnit)
        Sets the max age for the invite. Set this to 0 if the invite should never expire. Default is 86400 (24 hours). null will reset this to the default value.
        Parameters:
        maxAge - The max age for this invite or null to use the default value.
        timeUnit - The TimeUnit type of maxAge.
        Returns:
        The current InviteAction for chaining.
        Throws:
        IllegalArgumentException - If maxAge is negative or maxAge is positive and timeUnit is null.
      • setMaxUses

        @Nonnull
        @CheckReturnValue
        InviteAction setMaxUses​(@Nullable
                                Integer maxUses)
        Sets the max uses for the invite. Set this to 0 if the invite should have unlimited uses. Default is 0. null will reset this to the default value.
        Parameters:
        maxUses - The max uses for this invite or null to use the default value.
        Returns:
        The current InviteAction for chaining.
        Throws:
        IllegalArgumentException - If maxUses is negative.
      • setTemporary

        @Nonnull
        @CheckReturnValue
        InviteAction setTemporary​(@Nullable
                                  Boolean temporary)
        Sets whether the invite should only grant temporary membership. Default is false.
        Parameters:
        temporary - Whether the invite should only grant temporary membership or null to use the default value.
        Returns:
        The current InviteAction for chaining.
      • setUnique

        @Nonnull
        @CheckReturnValue
        InviteAction setUnique​(@Nullable
                               Boolean unique)
        Sets whether discord should reuse a similar invite. Default is false.
        Parameters:
        unique - Whether discord should reuse a similar invite or null to use the default value.
        Returns:
        The current InviteAction for chaining.