task2/solution10/src/org/apidesign/apifest08/currency/CurrencyConverterProvider.java
changeset 42 2c8c32ad44f7
parent 41 a7e6f84fb078
child 44 6a500cd1e467
     1.1 --- a/task2/solution10/src/org/apidesign/apifest08/currency/CurrencyConverterProvider.java	Tue Oct 07 01:18:23 2008 +0200
     1.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.3 @@ -1,68 +0,0 @@
     1.4 -package org.apidesign.apifest08.currency;
     1.5 -
     1.6 -import java.util.*;
     1.7 -
     1.8 -/**
     1.9 - * CurrencyConversionService provides methods necessary for construction all necessary currency
    1.10 - * conversion-related classes.
    1.11 - */
    1.12 -public interface CurrencyConverterProvider {
    1.13 -
    1.14 -	/**
    1.15 -	 * Convenience method for getConverter(amount1, Currency.getInstance(currency1));
    1.16 -	 *
    1.17 -	 * @param amount1 amount of the money in the currency1
    1.18 -	 * @param currency1 one of the supported currencies
    1.19 -	 * @param amount2 amount of the money in the currency2
    1.20 -	 * @param currency2 one of the supported currencies
    1.21 -	 * @return converter able to convert between the two specified currencies
    1.22 -	 * @throws IllegalArgumentException if any of the amount values is not positive
    1.23 -	 * @throws CurrencyNotAvailableException thrown when one of the currencies is not available
    1.24 -	 */
    1.25 -	CurrencyConverter getConverter(double amount1, /*@NotNull*/ String currency1,
    1.26 -								   double amount2, /*@NotNull*/ String currency2)
    1.27 -			throws IllegalArgumentException, CurrencyNotAvailableException;
    1.28 -
    1.29 -	/**
    1.30 -	 * Retrieves converter that is capable of converting values between currency1 and currency2.
    1.31 -	 * The exchange is specified in easy to understand way. By specifying values in two currencies that
    1.32 -	 * are equal. For example CurrencyConverter.getConverter(25, "CZK", 1, "EUR"); means 25CKZ is equal to 1EUR.
    1.33 -	 * This enables user to use this method without having to calculate anything. In general this can be
    1.34 -	 * expressed by formula amount1[currency1] = amount2[currency2].
    1.35 -	 *
    1.36 -	 * @param amount1 amount of the money in the currency1
    1.37 -	 * @param currency1 one of the supported currencies
    1.38 -	 * @param amount2 amount of the money in the currency2
    1.39 -	 * @param currency2 one of the supported currencies
    1.40 -	 * @return converter able to convert between the two specified currencies
    1.41 -	 * @throws IllegalArgumentException if any of the amount values is not positive
    1.42 -	 * @throws CurrencyNotAvailableException thrown when one of the currencies is not available
    1.43 -	 */
    1.44 -	CurrencyConverter getConverter(double amount1, /*@NotNull*/ Currency currency1,
    1.45 -								   double amount2, /*@NotNull*/ Currency currency2)
    1.46 -			throws IllegalArgumentException, CurrencyNotAvailableException;
    1.47 -
    1.48 -	/**
    1.49 -	 * Creates a new converter that is able to convert between all specified currencies. The converter
    1.50 -	 * may optionally support additional currencies that were not specified.
    1.51 -	 *
    1.52 -	 * @param currencies that the converter should be created for
    1.53 -	 * @return converter able to convert between all specified currencies
    1.54 -	 * @throws CurrencyNotAvailableException thrown when one of the currencies is not available
    1.55 -	 * @throws NullPointerException if any of the specified currencies is null of the array is null
    1.56 -	 */
    1.57 -	CurrencyConverter getConverter(/*@NotNull*/ Currency... currencies)
    1.58 -			throws CurrencyNotAvailableException, NullPointerException;
    1.59 -
    1.60 -	/**
    1.61 -	 * Convenient method for getConverter(Currency...)
    1.62 -	 *
    1.63 -	 * @param currencies that the converter should be created for
    1.64 -	 * @return converter able to convert between all specified currencies
    1.65 -	 * @throws CurrencyNotAvailableException thrown when one of the currencies is not available
    1.66 -	 * @throws NullPointerException if any of the specified currencies is null, or the array is null
    1.67 -	 * @throws IllegalArgumentException if any of the specified currencies is not a valid ISO code
    1.68 -	 */
    1.69 -	CurrencyConverter getConverter(/*@NotNull*/ String... currencies)
    1.70 -			throws CurrencyNotAvailableException, IllegalArgumentException, NullPointerException;
    1.71 -}
    1.72 \ No newline at end of file