# HG changeset patch
# User Jaroslav Tulach <jaroslav.tulach@apidesign.org>
# Date 1222852991 -7200
# Node ID 2198184978d5ccfd88dea5e90bf8cc8b6f43594a
# Parent  b94b999b7254df23a07d8445a5c91aa0314228fb
Task2

diff -r b94b999b7254 -r 2198184978d5 build.xml
--- a/build.xml	Wed Oct 01 11:03:45 2008 +0200
+++ b/build.xml	Wed Oct 01 11:23:11 2008 +0200
@@ -3,7 +3,6 @@
     <property name="apifest.dir" location="${ant.file.samples}/.."/>
     <dirset id="examples" dir="${apifest.dir}">
         <include name="**/nbproject"/>
-        <exclude name="currency/nbproject"/>
         <exclude name="taskx/jtulach/against-solutionXY/nbproject"/>
         <exclude name=".hg/**"/>
     </dirset>
diff -r b94b999b7254 -r 2198184978d5 currency/test/org/apidesign/apifest08/test/Task2Test.java
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/currency/test/org/apidesign/apifest08/test/Task2Test.java	Wed Oct 01 11:23:11 2008 +0200
@@ -0,0 +1,107 @@
+package org.apidesign.apifest08.test;
+
+import junit.framework.TestCase;
+import org.apidesign.apifest08.currency.Convertor;
+
+/** There are many currencies around the world and many banks manipulate
+ * with more than one or two at the same time. As banks are usually the
+ * best paying clients, which is true even in case of your Convertor API,
+ * it is reasonable to listen to their requests.
+ * <p>
+ * The quest for today is to enhance your existing convertor API to hold
+ * information about many currencies and allow conversions between any of them.
+ * Also, as conversion rates for diferent currencies usually arise from various
+ * bank departments, there is another important need. There is a need to
+ * compose two convertors into one by merging all the information about
+ * currencies they know about.
+ */
+public class Task2Test extends TestCase {
+    public Task2Test(String testName) {
+        super(testName);
+    }
+
+    @Override
+    protected void setUp() throws Exception {
+    }
+
+    @Override
+    protected void tearDown() throws Exception {
+    }
+
+    // As in Task1Test, keep in mind, that there are three parts
+    // of the whole system:
+    // 1. there is someone who knows the current exchange rate
+    // 2. there is someone who wants to do the conversion
+    // 3. there is the API between 1. and 2. which allows them to communicate
+    // 
+    // Please backward compatibly enhance your existing API to support following
+    // usecases:
+    //
+    
+    /** Create convertor that understands two currencies, CZK and
+     *  SKK. Make 100 SKK == 75 CZK. This is method for the group of users that
+     *  knows the exchange rate, and needs to use the API to create objects
+     *  with the exchange rate. Anyone shall be ready to call this method without
+     *  any other method being called previously. The API itself shall know
+     *  nothing about any rates, before this method is called.
+     */
+    public static Convertor createTripleConvertor() {
+        // Rates: 1USD = 15CZK
+        // Rates: 1USD = 20SKK
+        // Rates: 75CZK = 100SKK
+        return null;
+    }
+
+    /** Define convertor that understands three currencies. Use it.
+     */
+    public void testConvertorForUSDandCZKandSKK() throws Exception {
+        Convertor c = createTripleConvertor();
+
+        // convert $5 to CZK using c:
+        // assertEquals("Result is 75 CZK");
+
+        // convert $5 to SKK using c:
+        // assertEquals("Result is 100 SKK");
+
+        // convert 200SKK to CZK using c:
+        // assertEquals("Result is 150 CZK");
+
+        // convert 200SKK to USK using c:
+        // assertEquals("Result is 10 USD");
+    }
+
+    /** Merge all currency rates of convertor 1 with convertor 2.
+     * Implement this using your API, preferably this method just delegates
+     * into some API method which does the actual work, without requiring
+     * API clients to code anything complex.
+     */
+    public static Convertor merge(Convertor one, Convertor two) {
+        return null;
+    }
+
+    /** Join the convertors from previous task, Task1Test and show that it
+     * can be used to do reasonable conversions.
+     */
+    public void testConvertorComposition() throws Exception {
+        Convertor c = merge(
+            Task1Test.createCZKtoUSD(),
+            Task1Test.createSKKtoCZK()
+        );
+
+        // convert $5 to CZK using c:
+        // assertEquals("Result is 85 CZK");
+
+        // convert $8 to CZK using c:
+        // assertEquals("Result is 136 CZK");
+
+        // convert 1003CZK to USD using c:
+        // assertEquals("Result is 59 USD");
+
+        // convert 16CZK using c:
+        // assertEquals("Result is 20 SKK");
+
+        // convert 500SKK to CZK using c:
+        // assertEquals("Result is 400 CZK");
+
+    }
+}