org.bukkit

Interface BanEntry

public interface BanEntry

A single entry from the ban list. This may represent either a player ban or an IP ban.
Ban entries include the following properties:

• Target Name/IP Address - The target name or IP address
• Creation Date - The creation date of the ban
• Source - The source of the ban, such as a player, console, plugin, etc
• Expiration Date - The expiration date of the ban
• Reason - The reason for the ban

Unsaved information is not automatically written to the implementation's ban list, instead, the save() method must be called to write the changes to the ban list. If this ban entry has expired (such as from an unban) and is no longer found in the list, the save() call will re-add it to the list, therefore banning the victim specified.

Method Summary

Methods

Modifier and Type	Method and Description
Date	getCreated() Gets the date this ban entry was created.
Date	getExpiration() Gets the date this ban expires on, or null for no defined end date.
String	getReason() Gets the reason for this ban.
String	getSource() Gets the source of this ban. A source is considered any String, although this is generally a player name.
String	getTarget() Gets the target involved.
void	save() Saves the ban entry, overwriting any previous data in the ban list. Saving the ban entry of an unbanned player will cause the player to be banned once again.
void	setCreated(Date created) Sets the date this ban entry was created. Use save() to save the changes.
void	setExpiration(Date expiration) Sets the date this ban expires on.
void	setReason(String reason) Sets the reason for this ban.
void	setSource(String source) Sets the source of this ban. A source is considered any String, although this is generally a player name. Use save() to save the changes.

Method Detail

getTarget

String getTarget()

Gets the target involved. This may be in the form of an IP or a player name.

Returns:

The target name or IP address

getCreated

Date getCreated()

Gets the date this ban entry was created.

Returns:

The creation date

setCreated

void setCreated(Date created)

Sets the date this ban entry was created.
Use save() to save the changes.

Parameters:

created - The new created date, cannot be null

getSource

String getSource()

Gets the source of this ban.
A source is considered any String, although this is generally a player name.

Returns:

The source of the ban

setSource

void setSource(String source)

Sets the source of this ban.
A source is considered any String, although this is generally a player name.
Use save() to save the changes.

Parameters:

source - The new source where null values become empty strings

getExpiration

Date getExpiration()

Gets the date this ban expires on, or null for no defined end date.

Returns:

The expiration date

setExpiration

void setExpiration(Date expiration)

Sets the date this ban expires on. Null values are considered "infinite" bans.
Use save() to save the changes.

Parameters:

expiry - The new expiration date, or null to indicate an eternity

getReason

String getReason()

Gets the reason for this ban.

Returns:

The ban reason or null if not set

setReason

void setReason(String reason)

Sets the reason for this ban. Reasons must not be null.
Use save() to save the changes.

Parameters:

reason - The new reason, null values assume the implementation default

save

void save()

Saves the ban entry, overwriting any previous data in the ban list.
Saving the ban entry of an unbanned player will cause the player to be banned once again.