Package net.dv8tion.jda.api.events

Class StatusChangeEvent

java.lang.Object

net.dv8tion.jda.api.events.Event

net.dv8tion.jda.api.events.StatusChangeEvent

All Implemented Interfaces:

GenericEvent, UpdateEvent<JDA,JDA.Status>

public class StatusChangeEvent
extends Event
implements UpdateEvent<JDA,JDA.Status>

Indicates that our Status changed. (Example: SHUTTING_DOWN -> SHUTDOWN)
Can be used to detect internal status changes. Possibly to log or forward on user's end.

Identifier: status

Field Summary

Fields

Modifier and Type	Field	Description
static String	IDENTIFIER

Constructor Summary

Constructors

Constructor	Description
StatusChangeEvent(JDA api, JDA.Status newStatus, JDA.Status oldStatus)

Method Summary

Modifier and Type	Method	Description
JDA	getEntity()	The affected entity
JDA.Status	getNewStatus()	The status that we changed to
JDA.Status	getNewValue()	The new value
JDA.Status	getOldStatus()	The previous status
JDA.Status	getOldValue()	The old value
String	getPropertyIdentifier()	The field name for the updated property
String	toString()

Methods inherited from class net.dv8tion.jda.api.events.Event

getJDA, getResponseNumber

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.dv8tion.jda.api.events.GenericEvent

getJDA, getResponseNumber

Methods inherited from interface net.dv8tion.jda.api.events.UpdateEvent

getEntityType

Field Detail

IDENTIFIER

public static final String IDENTIFIER

See Also:

Constant Field Values

Constructor Detail

StatusChangeEvent

public StatusChangeEvent(@Nonnull
                         JDA api,
                         @Nonnull
                         JDA.Status newStatus,
                         @Nonnull
                         JDA.Status oldStatus)

Method Detail

getNewStatus

@Nonnull
public JDA.Status getNewStatus()

The status that we changed to

Returns:

The new status

getOldStatus

@Nonnull
public JDA.Status getOldStatus()

The previous status

Returns:

The previous status

getPropertyIdentifier

@Nonnull
public String getPropertyIdentifier()

Description copied from interface: UpdateEvent

The field name for the updated property

Example

 @Override
 public void onGenericRoleUpdate(GenericRoleUpdateEvent event)
 {
     switch (event.getPropertyIdentifier())
     {
     case RoleUpdateColorEvent.IDENTIFIER:
         System.out.printf("Updated color for role: %s%n", event);
         break;
     case RoleUpdatePositionEvent.IDENTIFIER:
         RoleUpdatePositionEvent update = (RoleUpdatePositionEvent) event;
         System.out.printf("Updated position for role: %s raw(%s->%s)%n", event, update.getOldPositionRaw(), update.getNewPositionRaw());
         break;
     default: return;
     }
 }
 

Specified by:

getPropertyIdentifier in interface UpdateEvent<JDA,JDA.Status>

Returns:

The name of the updated property

getEntity

@Nonnull
public JDA getEntity()

Description copied from interface: UpdateEvent

The affected entity

Specified by:

getEntity in interface UpdateEvent<JDA,JDA.Status>

Returns:

The affected entity

getOldValue

@Nonnull
public JDA.Status getOldValue()

Description copied from interface: UpdateEvent

The old value

Specified by:

getOldValue in interface UpdateEvent<JDA,JDA.Status>

Returns:

The old value

getNewValue

@Nonnull
public JDA.Status getNewValue()

Description copied from interface: UpdateEvent

The new value

Specified by:

getNewValue in interface UpdateEvent<JDA,JDA.Status>

Returns:

The new value

toString

public String toString()

Overrides:

toString in class Object