package org.apidesign.apifest08.currency;

 import java.util.Currency;

 /** 

  * Converts currencies. To create an instance call {@link ConvertorFactory#createConvertor(Money, Money)}.

  */

 public interface Convertor {

 	/**

 	 * Converts amount to its equivalent in the destination currency. 

 	 * @param amount 

 	 * @param destinationCurrency

 	 * @return

 	 * @throws IllegalArgumentException if currency of the amount is not supported or if it is not possible to convert it to the destination currency.

 	 */

 	public Money convert(Money amount, Currency destinationCurrency) throws IllegalArgumentException;

 }