Class Coin

java.lang.Object

org.episteme.social.economics.money.Coin

All Implemented Interfaces:

Serializable, Commented, ComprehensiveIdentification, Identified<Identification>, Named

public final class Coin
extends Object
implements ComprehensiveIdentification

Represents a physical coin or banknote.

Each coin has a unique identification (serial number), a face value, and an emission date. Common denominations include:

• Euro: 1¢, 2¢, 5¢, 10¢, 20¢, 50¢, €1, €2
• USD: 1¢, 5¢, 10¢, 25¢, 50¢, $1

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
Coin(double value, Identification identification, TimeCoordinate emission, Currency currency)	Creates a new Coin from amount and currency.
Coin(Identification identification, TimeCoordinate emission, Money value)	Creates a new Coin.
Coin(Identification id, TimeCoordinate emission, Money value, String mintMark)	Creates a new Coin with mint mark.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
static Coin	euro(Identification id, TimeCoordinate emission, double value)	Creates a Euro coin.
Currency	getCurrency()	Returns the currency.
TimeCoordinate	getEmission()	Returns the emission date.
Year	getEmissionYear()	Returns the emission year.
Identification	getId()	Returns the unique identifier of this entity.
Identification	getIdentification()	Returns the coin identification.
String	getMintMark()	Returns the mint mark.
Map<String,Object>	getTraits()	Returns the traits map for this entity.
Money	getValue()	Returns the face value.
int	hashCode()
String	toString()
static Coin	usPenny(Identification id, TimeCoordinate emission)	Creates a US penny.
static Coin	usQuarter(Identification id, TimeCoordinate emission)	Creates a US quarter.

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface Commented

getComments, getTrait, setComments

Methods inherited from interface ComprehensiveIdentification

getName, getTrait, setName, setTrait

Constructor Details

Coin

public Coin(Identification identification,
 TimeCoordinate emission,
 Money value)

Creates a new Coin.

Parameters:

identification - unique serial number

emission - the date of minting

value - the face value

Throws:

NullPointerException - if any argument is null

Coin

public Coin(Identification id,
 TimeCoordinate emission,
 Money value,
 String mintMark)

Creates a new Coin with mint mark.

Parameters:

emission - the date of minting

value - the face value

mintMark - the mint mark (e.g., "D" for Denver)

identification - unique serial number

Coin

public Coin(double value,
 Identification identification,
 TimeCoordinate emission,
 Currency currency)

Creates a new Coin from amount and currency.

Parameters:

value - numeric face value

identification - unique serial number

emission - the date of minting

currency - the currency

Method Details

getId

public Identification getId()

Description copied from interface: Identified

Returns the unique identifier of this entity.

Specified by:

getId in interface Identified<Identification>

Returns:

the identifier

getTraits

public Map<String,Object> getTraits()

Description copied from interface: ComprehensiveIdentification

Returns the traits map for this entity.

Specified by:

getTraits in interface Commented

Specified by:

getTraits in interface ComprehensiveIdentification

Returns:

the traits map

getIdentification

public Identification getIdentification()

Returns the coin identification.

Returns:

the identification

getEmission

public TimeCoordinate getEmission()

Returns the emission date.

Returns:

the emission instant

getEmissionYear

public Year getEmissionYear()

Returns the emission year.

Returns:

the year

getValue

public Money getValue()

Returns the face value.

Returns:

the value

getCurrency

public Currency getCurrency()

Returns the currency.

Returns:

the currency

getMintMark

public String getMintMark()

Returns the mint mark.

Returns:

the mint mark, or null if not specified

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

usPenny

public static Coin usPenny(Identification id,
 TimeCoordinate emission)

Creates a US penny.

usQuarter

public static Coin usQuarter(Identification id,
 TimeCoordinate emission)

Creates a US quarter.

euro

public static Coin euro(Identification id,
 TimeCoordinate emission,
 double value)

Creates a Euro coin.