com.codelanx.codelanxlib.econ

Class CEconomy

java.lang.Object

java.util.Observable

com.codelanx.codelanxlib.econ.CEconomy

public class CEconomy
extends Observable

Represents an observable façade class for Vault's Economy object

Since:

0.0.1

Version:

0.1.0

Author:

1Rogue

Field Summary

Fields

Modifier and Type	Field and Description
protected Lang	format The LangFile format to use for output

Constructor Summary

Constructors

Constructor and Description
CEconomy(Plugin plugin) Sets the format string for this object to use for output

Method Summary

Modifier and Type	Method and Description
void	addObserver(EconomyObserver o) Adds an EconomyObserver to this CEconomy
void	addObserver(Observer o)
double	bonusRate() Represents a rate that is multiplied to money given through the pay(OfflinePlayer, double) method.
ChargeStatus	canCharge(OfflinePlayer p, com.codelanx.commons.config.ConfigFile value) Returns whether or not a specific OfflinePlayer can be charged an amount
ChargeStatus	canCharge(OfflinePlayer p, double cost) Returns whether or not a specific OfflinePlayer can be charged an amount
boolean	charge(OfflinePlayer p, com.codelanx.commons.config.ConfigFile value) Takes money away from the OfflinePlayer
boolean	charge(OfflinePlayer p, double cost) Takes money away from the OfflinePlayer
double	getBalance(OfflinePlayer p) Returns the relevant balance for the OfflinePlayer
protected net.milkbowl.vault.economy.Economy	getEconomy() Returns the underlying Economy object that is backed by a VaultProxy InvocationHandler
boolean	isEnabled() Returns whether or not the Economy object could be retrieved from Vault
void	notifyObservers(Object arg) Modified to send a Bukkit event and force notification of the change
boolean	pay(OfflinePlayer p, com.codelanx.commons.config.ConfigFile value) Gives money to the OfflinePlayer
boolean	pay(OfflinePlayer p, double amount) Gives money to the OfflinePlayer
protected void	setChanged() Allows the protected Observable.setChanged() method to be called by VaultProxy
double	taxRate() Represents a rate that is multiplied to money taken through the charge(OfflinePlayer, double) method.

Methods inherited from class java.util.Observable

clearChanged, countObservers, deleteObserver, deleteObservers, hasChanged, notifyObservers

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

format

protected final Lang format

The LangFile format to use for output

Constructor Detail

CEconomy

public CEconomy(Plugin plugin)

Sets the format string for this object to use for output

Parameters:

plugin - The Plugin that instantiated this class

Since:

0.0.1

Method Detail

canCharge

public ChargeStatus canCharge(OfflinePlayer p,
                              com.codelanx.commons.config.ConfigFile value)

Returns whether or not a specific OfflinePlayer can be charged an amount

Parameters:

p - The OfflinePlayer to check if they can be charged

value - A ConfigFile double value representing how much to take

Returns:

A ChargeStatus representing the total cost and the status of whether or not the OfflinePlayer can be charged. If isEnabled() returns false, this will be a ChargeStatus of true with a returned cost of 0

Since:

0.0.1

canCharge

public ChargeStatus canCharge(OfflinePlayer p,
                              double cost)

Returns whether or not a specific OfflinePlayer can be charged an amount

Parameters:

p - The OfflinePlayer to check if they can be charged

cost - The amount to charge

Returns:

A ChargeStatus representing the total cost and the status of whether or not the OfflinePlayer can be charged. If isEnabled() returns false, this will be a ChargeStatus of true with a returned cost of 0

Since:

0.0.1

charge

public boolean charge(OfflinePlayer p,
                      com.codelanx.commons.config.ConfigFile value)

Takes money away from the OfflinePlayer

Parameters:

p - The OfflinePlayer to take money from

value - A ConfigFile double value representing how much to take

Returns:

true if the money was successfully taken, or if isEnabled() returns false

Since:

0.0.1

charge

public boolean charge(OfflinePlayer p,
                      double cost)

Takes money away from the OfflinePlayer

Parameters:

p - The OfflinePlayer to take money from

cost - The amount of money to take

Returns:

true if the money was successfully taken, or if isEnabled() returns false

Since:

0.0.1

pay

public boolean pay(OfflinePlayer p,
                   com.codelanx.commons.config.ConfigFile value)

Gives money to the OfflinePlayer

Parameters:

p - The OfflinePlayer to give money to

value - A ConfigFile double value representing how much to give

Returns:

true if the money was deposited successfully, or if isEnabled() returns false

Since:

0.1.0

pay

public boolean pay(OfflinePlayer p,
                   double amount)

Gives money to the OfflinePlayer

Parameters:

p - The OfflinePlayer to give money to

amount - The amount of money to give

Returns:

true if the money was deposited successfully, or if isEnabled() returns false

Since:

0.0.1

notifyObservers

public void notifyObservers(Object arg)

Modified to send a Bukkit event and force notification of the change

Overrides:

notifyObservers in class Observable

Parameters:

arg - An EconomyChangePacket

Since:

0.0.1

setChanged

protected void setChanged()

Allows the protected Observable.setChanged() method to be called by VaultProxy

Overrides:

setChanged in class Observable

Since:

0.0.1

getBalance

public double getBalance(OfflinePlayer p)

Returns the relevant balance for the OfflinePlayer

Parameters:

p - The OfflinePlayer for which the balanced is checked

Returns:

The OfflinePlayer's balance, or -1 if isEnabled() returns false

Since:

0.0.1

isEnabled

public final boolean isEnabled()

Returns whether or not the Economy object could be retrieved from Vault

Returns:

false if the Economy object is null

Since:

0.0.1

getEconomy

protected final net.milkbowl.vault.economy.Economy getEconomy()

Returns the underlying Economy object that is backed by a VaultProxy InvocationHandler

Returns:

The underlying Economy object

Since:

0.0.1

addObserver

public void addObserver(EconomyObserver o)

Adds an EconomyObserver to this CEconomy

Parameters:

o - The EconomyObserver to be notified when the economy state changes

Since:

0.2.0

addObserver

public void addObserver(Observer o)

Overrides:

addObserver in class Observable

Parameters:

o -

Since:

0.2.0

taxRate

public double taxRate()

Represents a rate that is multiplied to money taken through the charge(OfflinePlayer, double) method. This method is purposely overridable to allow for people to specify their own rates. Values that are negative or zero will be automatically converted to 1.

Returns:

The rate at which given money is multiplied

Since:

0.1.0

bonusRate

public double bonusRate()

Represents a rate that is multiplied to money given through the pay(OfflinePlayer, double) method. This method is purposely overridable to allow for people to specify their own rates. Values that are negative or zero will be automatically converted to 1.

Returns:

The rate at which given money is multiplied

Since:

0.1.0