bundles/org.eclipse.uomo.business/src/main/java/org/eclipse/uomo/business/money/MoneyCurrency.java - gerrit/uomo/org.eclipse.uomo - Git at Google

 /**
  * Copyright (c) 2006, 2013, Werner Keil and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors:
  *    Werner Keil - initial API and implementation
  */
 package org.eclipse.uomo.business.money;

 import static org.eclipse.uomo.business.money.MonetaryUnits.ISO_NAMESPACE;

 //import java.util.Currency;
 import java.util.Locale;
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.logging.Logger;

 import org.eclipse.uomo.business.internal.CurrencyUnit;
 import org.eclipse.uomo.business.internal.Localizable;

 import com.ibm.icu.util.Currency;
 import com.ibm.icu.util.ULocale;

 /**
  * Adapter that implements the  {@link CurrencyUnit} interface using the
  * ICU4J {@link com.ibm.icu.util.Currency}.
  *
  * @version 0.2.3
  * @author Werner Keil
  * @deprecated merge into MoneyUnit
  */
 public class MoneyCurrency extends com.ibm.icu.util.Currency implements CurrencyUnit, Localizable {

 	/**
 	 * serialVersionUID.
 	 */
 	private static final long serialVersionUID = -2523936311372374236L;

 	/** namespace for this currency. */
 	private final String namespace;
 	/** currency code for this currency. */
 	private final String currencyCode;
 	/** valid from, or {@code null}. */
 	private final Long validFrom;
 	/** valid until, or {@code null}. */
 	private final Long validUntil;
 	/** true, if legal tender. */
 	private final boolean legalTender;
 	/** true, if it is a virtual currency. */
 	private final boolean virtual;

 	private static final Map<String, MoneyCurrency> CACHED = new ConcurrentHashMap<String, MoneyCurrency>();

 	private static final Logger LOGGER = Logger.getLogger(MoneyCurrency.class
 			.getName());

 	/**
 	 * Private constructor.
 	 *
 	 * @param currency
 	 */
 	private MoneyCurrency(String namespace, String code, int numCode,
 			int fractionDigits, Long validFrom, Long validUntil, boolean legal,
 			boolean virtual) {
 		super(code);
 		this.namespace = namespace;
 		this.currencyCode = code;
 		this.validFrom = validFrom;
 		this.validUntil = validUntil;
 		this.legalTender = legal;
 		this.virtual = virtual;
 	}

 	/**
 	 * Private constructor.
 	 *
 	 * @param currency
 	 */
 	private MoneyCurrency(Currency currency) {
 		super(currency != null ? currency.getCurrencyCode() : "");
 		if (currency == null) {
 			throw new IllegalArgumentException("Currency required.");
 		}
 		this.namespace = ISO_NAMESPACE;
 		this.currencyCode = currency.getCurrencyCode();
 		currency.getDefaultFractionDigits();
 		this.validFrom = null;
 		this.validUntil = null; // TODO Adapt for hisotoric one, e.g. AFA
 		this.legalTender = !this.currencyCode.startsWith("X"); // TODO check for
 																// each code in
 																// util.Currency
 																// here;
 		this.virtual = this.currencyCode.equals("XXX"); // TODO check for each
 														// code in util.Currency
 														// here;
 	}

 	/**
 	 * Access a new instance based on {@link Currency}.
 	 *
 	 * @param currency
 	 *            the currency unitm not null.
 	 * @return the new instance, never null.
 	 */
 	public static MoneyCurrency of(Currency currency) {
 		String key = ISO_NAMESPACE + ':' + currency.getCurrencyCode();
 		MoneyCurrency cachedItem = CACHED.get(key);
 		if (cachedItem == null) {
 			cachedItem = new ICUCurrencyAdapter(currency);
 			CACHED.put(key, cachedItem);
 		}
 		return cachedItem;
 	}

 	/**
 	 * Access a new instance based on {@link Currency}.
 	 *
 	 * @param currency
 	 *            the currency unitm not null.
 	 * @return the new instance, never null.
 	 */
 //	public static MoneyCurrency of(com.ibm.icu.util.Currency currency) {
 //		String key = ISO_NAMESPACE + ':' + currency.getCurrencyCode();
 //		MoneyCurrency cachedItem = CACHED.get(key);
 //		if (cachedItem == null) {
 //			cachedItem = new ICUCurrencyAdapter(currency);
 //			CACHED.put(key, cachedItem);
 //		}
 //		return cachedItem;
 //	}
 //
 	/**
 	 * Access a new instance based on the ISO currency code. The code must
 	 * return a {@link Currency} when passed to
 	 * {@link Currency#getInstance(String)}.
 	 *
 	 * @param currencyCode
 	 *            the ISO currency code, not null.
 	 * @return the corresponding {@link MonetaryCurrency} instance.
 	 */
 	public static MoneyCurrency of(String currencyCode) {
 		return of(Currency.getInstance(currencyCode));
 	}

 	/**
 	 * Access a new instance based on the ISO currency code. The code must
 	 * return a {@link Currency} when passed to
 	 * {@link Currency#getInstance(String)}.
 	 *
 	 * @param namespace
 	 *            the target namespace.
 	 * @param currencyCode
 	 *            the ISO currency code, not null.
 	 * @return the corresponding {@link MonetaryCurrency} instance.
 	 */
 	public static MoneyCurrency of(String namespace, String currencyCode) {
 		String key = namespace + ':' + currencyCode;
 		MoneyCurrency cu = CACHED.get(key);
 		if (cu == null && namespace.equals(ISO_NAMESPACE)) {
 			return of(currencyCode);
 		}
 		return cu;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#isVirtual()
 	 */

 	public boolean isVirtual() {
 		return virtual;
 	}

 	/**
 	 * Get the namepsace of this {@link CurrencyUnit}, returns 'ISO-4217'.
 	 */

 	public String getNamespace() {
 		return namespace;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#getValidFrom()
 	 */

 	public Long getValidFrom() {
 		return validFrom;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#getValidUntil()
 	 */

 	public Long getValidUntil() {
 		return validUntil;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#getCurrencyCode()
 	 */

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#getNumericCode()
 	 */

 //	public int getNumericCode() {
 //		return numericCode;
 //	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#getDefaultFractionDigits()
 	 */

 //	public int getDefaultFractionDigits() {
 //		return defaultFractionDigits;
 //	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see javax.money.CurrencyUnit#isLegalTender()
 	 */

 	public boolean isLegalTender() {
 		return legalTender;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see java.lang.Comparable#compareTo(java.lang.Object)
 	 */
 	public int compareTo(CurrencyUnit currency) {
 		int compare = getNamespace().compareTo(currency.getNamespace());
 		if (compare == 0) {
 			compare = getCurrencyCode().compareTo(currency.getCurrencyCode());
 		}
 		if (compare == 0) {
 			if (validFrom == null && currency.getValidFrom() != null) {
 				compare = -1;
 			} else if (validFrom != null && currency.getValidFrom() == null) {
 				compare = 1;
 			} else if (validFrom != null) {
 				compare = validFrom.compareTo(currency.getValidFrom());
 			}
 		}
 		if (compare == 0) {
 			if (validUntil == null && currency.getValidUntil() != null) {
 				compare = -1;
 			} else if (validUntil != null && currency.getValidUntil() == null) {
 				compare = 1;
 			} else if (validUntil != null) {
 				compare = validUntil.compareTo(currency.getValidUntil());
 			}
 		}
 		return compare;
 	}

 	/*
 	 * (non-Javadoc)
 	 *
 	 * @see java.lang.Object#toString()
 	 */

 	public String toString() {
 		if (ISO_NAMESPACE.equals(namespace)) {
 			return currencyCode;
 		}
 		return namespace + ':' + currencyCode;
 	}

 	/**
 	 * Builder class that supports building complex instances of
 	 * {@link MoneyCurrency}.
 	 *
 	 * @author Anatole Tresch
 	 */
 	public static final class Builder {
 		/** namespace for this currency. */
 		private String namespace;
 		/** currency code for this currency. */
 		private String currencyCode;
 		/** numeric code, or -1. */
 		private int numericCode = -1;
 		/** fraction digits, or -1. */
 		private int defaultFractionDigits = -1;
 		/** valid from, or {@code null}. */
 		private Long validFrom;
 		/** valid until, or {@code null}. */
 		private Long validUntil;
 		/** true, if legal tender. */
 		private boolean legalTender = true;
 		/** true for virtual currencies. */
 		private boolean virtual = false;

 		/**
 		 * Creates a new {@link Builder}.
 		 */
 		public Builder() {
 		}

 		/**
 		 * Creates a new {@link Builder}, starting with the according ISO
 		 * currency.
 		 *
 		 * @param currencyCode
 		 *            the ISO currency code.
 		 */
 		public Builder(String currencyCode) {
 			this(ISO_NAMESPACE, currencyCode);
 		}

 		/**
 		 * Creates a new {@link Builder}, starting with the namespace and code
 		 * given.
 		 *
 		 * @param namespace
 		 *            the taregt namespace
 		 * @param currencyCode
 		 *            the currency code
 		 */
 		public Builder(String namespace, String currencyCode) {
 			setNamespace(namespace);
 			setCurrencyCode(currencyCode);
 		}

 		/**
 		 * Set the namespace.
 		 *
 		 * @param namespace
 		 *            the namespace, not null
 		 * @return the builder, for chaining
 		 */
 		public Builder setNamespace(String namespace) {
 			if (namespace == null) {
 				throw new IllegalArgumentException("namespace may not be null.");
 			}
 			this.namespace = namespace;
 			return this;
 		}

 		/**
 		 * Set the currency code.
 		 *
 		 * @param namespace
 		 *            the currency code, not null
 		 * @return the builder, for chaining
 		 */
 		public Builder setCurrencyCode(String currencyCode) {
 			if (currencyCode == null) {
 				throw new IllegalArgumentException(
 						"currencyCode may not be null.");
 			}
 			this.currencyCode = currencyCode;
 			return this;
 		}

 		/**
 		 * Set the default fraction digits.
 		 *
 		 * @param defaultFractionDigits
 		 *            the default fraction digits
 		 * @return the builder, for chaining
 		 */
 		public Builder setDefaultFractionDigits(int defaultFractionDigits) {
 			if (defaultFractionDigits < -1) {
 				throw new IllegalArgumentException(
 						"Invalid value for defaultFractionDigits: "
 								+ defaultFractionDigits);
 			}
 			this.defaultFractionDigits = defaultFractionDigits;
 			return this;
 		}

 		/**
 		 * Set the numeric currency code.
 		 *
 		 * @param numericCode
 		 *            the numeric currency code
 		 * @return the builder, for chaining
 		 */
 		public Builder setNumericCode(int numericCode) {
 			if (numericCode < -1) {
 				throw new IllegalArgumentException(
 						"Invalid value for numericCode: " + numericCode);
 			}
 			this.numericCode = numericCode;
 			return this;
 		}

 		/**
 		 * Sets the start UTC timestamp for the currenciy's validity.
 		 *
 		 * @param validFrom
 		 *            the start UTC timestamp
 		 * @return the builder, for chaining
 		 */
 		public Builder setValidFrom(Long validFrom) {
 			this.validFrom = validFrom;
 			return this;
 		}

 		/**
 		 * Sets the end UTC timestamp for the currenciy's validity.
 		 *
 		 * @param validUntil
 		 *            the ending UTC timestamp
 		 * @return the builder, for chaining
 		 */
 		public Builder setValidUntil(Long validUntil) {
 			this.validUntil = validUntil;
 			return this;
 		}

 		/**
 		 * Sets the legal tender attribute.
 		 *
 		 * @param legalTender
 		 *            true, if the currency is a legal tender
 		 * @return the builder, for chaining
 		 */
 		public Builder setLegalTender(boolean legalTender) {
 			this.legalTender = legalTender;
 			return this;
 		}

 		/**
 		 * Sets the virtual attribute.
 		 *
 		 * @param virtual
 		 *            true, if the currency is a virtual currency.
 		 * @return the builder, for chaining
 		 */
 		public Builder setVirtual(boolean virtual) {
 			this.virtual = virtual;
 			return this;
 		}

 		/**
 		 * Get the current namespace attribute set.
 		 *
 		 * @return the namespace value, or null.
 		 */
 		public String getNamespace() {
 			return this.namespace;
 		}

 		/**
 		 * Get the current currency code attribute set.
 		 *
 		 * @return the currency code value, or null.
 		 */
 		public String getCurrencyCode() {
 			return this.currencyCode;
 		}

 		/**
 		 * Get the current fraction digits attribute set.
 		 *
 		 * @return the currency fraction digits value.
 		 */
 		public int getDefaultFractionDigits() {
 			return this.defaultFractionDigits;
 		}

 		/**
 		 * Get the current numeric code attribute set.
 		 *
 		 * @return the numeric code value.
 		 */
 		public int getNumericCode() {
 			return this.numericCode;
 		}

 		/**
 		 * Get the starting validity period timestamp.
 		 *
 		 * @return the starting validity period tiemstamp, or null..
 		 */
 		public Long getValidFrom() {
 			return this.validFrom;
 		}

 		/**
 		 * Get the ending validity period timestamp.
 		 *
 		 * @return the ending validity period tiemstamp, or null..
 		 */
 		public Long getValidUntil() {
 			return this.validUntil;
 		}

 		/**
 		 * Access the legal tender attribute.
 		 *
 		 * @return the attribute value.
 		 */
 		public boolean isLegalTender() {
 			return this.legalTender;
 		}

 		/**
 		 * Access the virtual attribute.
 		 *
 		 * @return the attribute value.
 		 */
 		public boolean isVirtual() {
 			return this.virtual;
 		}

 		/**
 		 * Checks if this {@link Builder} instance can create a
 		 * {@link MoneyCurrency}.
 		 *
 		 * @see #build()
 		 * @return true, if the builder can build.
 		 */
 		public boolean isBuildable() {
 			return namespace != null && currencyCode != null;
 		}

 		/**
 		 * Builds a new currency instance, the instance build is not cached
 		 * internally.
 		 *
 		 * @see #build(boolean)
 		 * @return a new instance of {@link MoneyCurrency}.
 		 */
 		public MoneyCurrency build() {
 			return build(true);
 		}

 		/**
 		 * Builds a new currency instance, which ia additinoally stored to the
 		 * internal cache for reuse.
 		 *
 		 * @param cache
 		 *            flag to optionally store the instance created into the
 		 *            locale cache.
 		 * @return a new instance of {@link MoneyCurrency}.
 		 */
 		public MoneyCurrency build(boolean cache) {
 			if (!isBuildable()) {
 				throw new IllegalStateException(
 						"Can not build CurrencyUnitImpl.");
 			}
 			if (cache) {
 				if (validUntil != null) {
 					LOGGER.warning("CurrencyUnit build: Can only cache currencies that have no validity constraints.");
 					cache = false;
 				}
 				if (validFrom != null) {
 					if (validFrom.longValue() > System.currentTimeMillis()) {
 						LOGGER.warning("CurrencyUnit build: Can only cache currencies that are already valid.");
 						cache = false;
 					}
 				}
 			}
 			if (cache) {
 				String key = namespace + ':' + currencyCode;
 				MoneyCurrency current = CACHED.get(key);
 				if (current == null) {
 					current = new MoneyCurrency(namespace, currencyCode,
 							numericCode, defaultFractionDigits, validFrom,
 							validUntil, legalTender, virtual);
 					CACHED.put(key, current);
 				}
 				return current;
 			}
 			return new MoneyCurrency(namespace, currencyCode, numericCode,
 					defaultFractionDigits, validFrom, validUntil, legalTender,
 					virtual);
 		}
 	}

 	/**
 	 * Adapter that implements the new {@link CurrencyUnit} interface using the
 	 * JDK's {@link Currency}.
 	 * <p>
 	 * This adapter will be removed in the final platform implementation.
 	 *
 	 * @author Anatole Tresch
 	 * @author Werner Keil
 	 */
 	private final static class JDKCurrencyAdapter extends MoneyCurrency
 			implements Localizable {

 		/**
 		 * serialVersionUID.
 		 */
 		private static final long serialVersionUID = -2523936311372374236L;

 		/**
 		 * ISO 4217 currency code for this currency.
 		 *
 		 * @serial
 		 */
 		private final Currency currency;

 		/**
 		 * Private constructor.
 		 *
 		 * @param currency
 		 */
 		private JDKCurrencyAdapter(Currency currency) {
 			super(currency);
 			this.currency = currency;
 		}

 		/*
 		 * (non-Javadoc)
 		 *
 		 * @see java.lang.Object#toString()
 		 */

 		public String toString() {
 			return ISO_NAMESPACE + ':' + getCurrencyCode();
 		}

 		/*
 		 * (non-Javadoc)
 		 *
 		 * @see Localizable#getDisplayName(java.util.Locale)
 		 */
 		public String getDisplayName(Locale locale) {
 			//return currency.getName(locale, nameStyle, isChoiceFormat) (locale);
 			return currency.getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
 		}

 	}

 	/**
 	 * Adapter that implements the new {@link CurrencyUnit} interface using the
 	 * JDK's {@link Currency}.
 	 * <p>
 	 * This adapter will be removed in the final platform implementation.
 	 *
 	 * @author Werner Keil
 	 */
 	private final static class ICUCurrencyAdapter extends MoneyCurrency
 			implements Localizable {

 		/**
 		 * serialVersionUID.
 		 */
 		private static final long serialVersionUID = -2523936311372374236L;

 		/**
 		 * ISO 4217 currency code for this currency.
 		 *
 		 * @serial
 		 */
 		private final com.ibm.icu.util.Currency currency;

 		/**
 		 * Private constructor.
 		 *
 		 * @param currency
 		 */
 		private ICUCurrencyAdapter(com.ibm.icu.util.Currency currency) {
 			super(ISO_NAMESPACE, currency.getCurrencyCode(), -1, currency.getDefaultFractionDigits(),
 					null, null, true, false);
 			this.currency = currency;
 		}

 		/*
 		 * (non-Javadoc)
 		 *
 		 * @see java.lang.Object#toString()
 		 */

 		public String toString() {
 			return ISO_NAMESPACE + ':' + getCurrencyCode();
 		}

 		/*
 		 * (non-Javadoc)
 		 *
 		 * @see javax.money.Localizable#getDisplayName(java.util.Locale)
 		 */

 		public String getDisplayName(Locale locale) {
 			return currency.getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
 		}

 	}

 //	public String getDisplayName(Locale locale) {
 //		return getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
 //	}
 //
 //	public int getNumericCode() {
 //		return -1;
 //	}

 }
	/**
	* Copyright (c) 2006, 2013, Werner Keil and others.
	* All rights reserved. This program and the accompanying materials
	* are made available under the terms of the Eclipse Public License v1.0
	* which accompanies this distribution, and is available at
	* http://www.eclipse.org/legal/epl-v10.html
	*
	* Contributors:
	* Werner Keil - initial API and implementation
	*/
	package org.eclipse.uomo.business.money;

	import static org.eclipse.uomo.business.money.MonetaryUnits.ISO_NAMESPACE;

	//import java.util.Currency;
	import java.util.Locale;
	import java.util.Map;
	import java.util.concurrent.ConcurrentHashMap;
	import java.util.logging.Logger;

	import org.eclipse.uomo.business.internal.CurrencyUnit;
	import org.eclipse.uomo.business.internal.Localizable;

	import com.ibm.icu.util.Currency;
	import com.ibm.icu.util.ULocale;

	/**
	* Adapter that implements the {@link CurrencyUnit} interface using the
	* ICU4J {@link com.ibm.icu.util.Currency}.
	*
	* @version 0.2.3
	* @author Werner Keil
	* @deprecated merge into MoneyUnit
	*/
	public class MoneyCurrency extends com.ibm.icu.util.Currency implements CurrencyUnit, Localizable {

	/**
	* serialVersionUID.
	*/
	private static final long serialVersionUID = -2523936311372374236L;

	/** namespace for this currency. */
	private final String namespace;
	/** currency code for this currency. */
	private final String currencyCode;
	/** valid from, or {@code null}. */
	private final Long validFrom;
	/** valid until, or {@code null}. */
	private final Long validUntil;
	/** true, if legal tender. */
	private final boolean legalTender;
	/** true, if it is a virtual currency. */
	private final boolean virtual;

	private static final Map<String, MoneyCurrency> CACHED = new ConcurrentHashMap<String, MoneyCurrency>();

	private static final Logger LOGGER = Logger.getLogger(MoneyCurrency.class
	.getName());

	/**
	* Private constructor.
	*
	* @param currency
	*/
	private MoneyCurrency(String namespace, String code, int numCode,
	int fractionDigits, Long validFrom, Long validUntil, boolean legal,
	boolean virtual) {
	super(code);
	this.namespace = namespace;
	this.currencyCode = code;
	this.validFrom = validFrom;
	this.validUntil = validUntil;
	this.legalTender = legal;
	this.virtual = virtual;
	}

	/**
	* Private constructor.
	*
	* @param currency
	*/
	private MoneyCurrency(Currency currency) {
	super(currency != null ? currency.getCurrencyCode() : "");
	if (currency == null) {
	throw new IllegalArgumentException("Currency required.");
	}
	this.namespace = ISO_NAMESPACE;
	this.currencyCode = currency.getCurrencyCode();
	currency.getDefaultFractionDigits();
	this.validFrom = null;
	this.validUntil = null; // TODO Adapt for hisotoric one, e.g. AFA
	this.legalTender = !this.currencyCode.startsWith("X"); // TODO check for
	// each code in
	// util.Currency
	// here;
	this.virtual = this.currencyCode.equals("XXX"); // TODO check for each
	// code in util.Currency
	// here;
	}

	/**
	* Access a new instance based on {@link Currency}.
	*
	* @param currency
	* the currency unitm not null.
	* @return the new instance, never null.
	*/
	public static MoneyCurrency of(Currency currency) {
	String key = ISO_NAMESPACE + ':' + currency.getCurrencyCode();
	MoneyCurrency cachedItem = CACHED.get(key);
	if (cachedItem == null) {
	cachedItem = new ICUCurrencyAdapter(currency);
	CACHED.put(key, cachedItem);
	}
	return cachedItem;
	}

	/**
	* Access a new instance based on {@link Currency}.
	*
	* @param currency
	* the currency unitm not null.
	* @return the new instance, never null.
	*/
	// public static MoneyCurrency of(com.ibm.icu.util.Currency currency) {
	// String key = ISO_NAMESPACE + ':' + currency.getCurrencyCode();
	// MoneyCurrency cachedItem = CACHED.get(key);
	// if (cachedItem == null) {
	// cachedItem = new ICUCurrencyAdapter(currency);
	// CACHED.put(key, cachedItem);
	// }
	// return cachedItem;
	// }
	//
	/**
	* Access a new instance based on the ISO currency code. The code must
	* return a {@link Currency} when passed to
	* {@link Currency#getInstance(String)}.
	*
	* @param currencyCode
	* the ISO currency code, not null.
	* @return the corresponding {@link MonetaryCurrency} instance.
	*/
	public static MoneyCurrency of(String currencyCode) {
	return of(Currency.getInstance(currencyCode));
	}

	/**
	* Access a new instance based on the ISO currency code. The code must
	* return a {@link Currency} when passed to
	* {@link Currency#getInstance(String)}.
	*
	* @param namespace
	* the target namespace.
	* @param currencyCode
	* the ISO currency code, not null.
	* @return the corresponding {@link MonetaryCurrency} instance.
	*/
	public static MoneyCurrency of(String namespace, String currencyCode) {
	String key = namespace + ':' + currencyCode;
	MoneyCurrency cu = CACHED.get(key);
	if (cu == null && namespace.equals(ISO_NAMESPACE)) {
	return of(currencyCode);
	}
	return cu;
	}

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#isVirtual()
	*/

	public boolean isVirtual() {
	return virtual;
	}

	/**
	* Get the namepsace of this {@link CurrencyUnit}, returns 'ISO-4217'.
	*/

	public String getNamespace() {
	return namespace;
	}

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#getValidFrom()
	*/

	public Long getValidFrom() {
	return validFrom;
	}

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#getValidUntil()
	*/

	public Long getValidUntil() {
	return validUntil;
	}

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#getCurrencyCode()
	*/

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#getNumericCode()
	*/

	// public int getNumericCode() {
	// return numericCode;
	// }

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#getDefaultFractionDigits()
	*/

	// public int getDefaultFractionDigits() {
	// return defaultFractionDigits;
	// }

	/*
	* (non-Javadoc)
	*
	* @see javax.money.CurrencyUnit#isLegalTender()
	*/

	public boolean isLegalTender() {
	return legalTender;
	}

	/*
	* (non-Javadoc)
	*
	* @see java.lang.Comparable#compareTo(java.lang.Object)
	*/
	public int compareTo(CurrencyUnit currency) {
	int compare = getNamespace().compareTo(currency.getNamespace());
	if (compare == 0) {
	compare = getCurrencyCode().compareTo(currency.getCurrencyCode());
	}
	if (compare == 0) {
	if (validFrom == null && currency.getValidFrom() != null) {
	compare = -1;
	} else if (validFrom != null && currency.getValidFrom() == null) {
	compare = 1;
	} else if (validFrom != null) {
	compare = validFrom.compareTo(currency.getValidFrom());
	}
	}
	if (compare == 0) {
	if (validUntil == null && currency.getValidUntil() != null) {
	compare = -1;
	} else if (validUntil != null && currency.getValidUntil() == null) {
	compare = 1;
	} else if (validUntil != null) {
	compare = validUntil.compareTo(currency.getValidUntil());
	}
	}
	return compare;
	}

	/*
	* (non-Javadoc)
	*
	* @see java.lang.Object#toString()
	*/

	public String toString() {
	if (ISO_NAMESPACE.equals(namespace)) {
	return currencyCode;
	}
	return namespace + ':' + currencyCode;
	}

	/**
	* Builder class that supports building complex instances of
	* {@link MoneyCurrency}.
	*
	* @author Anatole Tresch
	*/
	public static final class Builder {
	/** namespace for this currency. */
	private String namespace;
	/** currency code for this currency. */
	private String currencyCode;
	/** numeric code, or -1. */
	private int numericCode = -1;
	/** fraction digits, or -1. */
	private int defaultFractionDigits = -1;
	/** valid from, or {@code null}. */
	private Long validFrom;
	/** valid until, or {@code null}. */
	private Long validUntil;
	/** true, if legal tender. */
	private boolean legalTender = true;
	/** true for virtual currencies. */
	private boolean virtual = false;

	/**
	* Creates a new {@link Builder}.
	*/
	public Builder() {
	}

	/**
	* Creates a new {@link Builder}, starting with the according ISO
	* currency.
	*
	* @param currencyCode
	* the ISO currency code.
	*/
	public Builder(String currencyCode) {
	this(ISO_NAMESPACE, currencyCode);
	}

	/**
	* Creates a new {@link Builder}, starting with the namespace and code
	* given.
	*
	* @param namespace
	* the taregt namespace
	* @param currencyCode
	* the currency code
	*/
	public Builder(String namespace, String currencyCode) {
	setNamespace(namespace);
	setCurrencyCode(currencyCode);
	}

	/**
	* Set the namespace.
	*
	* @param namespace
	* the namespace, not null
	* @return the builder, for chaining
	*/
	public Builder setNamespace(String namespace) {
	if (namespace == null) {
	throw new IllegalArgumentException("namespace may not be null.");
	}
	this.namespace = namespace;
	return this;
	}

	/**
	* Set the currency code.
	*
	* @param namespace
	* the currency code, not null
	* @return the builder, for chaining
	*/
	public Builder setCurrencyCode(String currencyCode) {
	if (currencyCode == null) {
	throw new IllegalArgumentException(
	"currencyCode may not be null.");
	}
	this.currencyCode = currencyCode;
	return this;
	}

	/**
	* Set the default fraction digits.
	*
	* @param defaultFractionDigits
	* the default fraction digits
	* @return the builder, for chaining
	*/
	public Builder setDefaultFractionDigits(int defaultFractionDigits) {
	if (defaultFractionDigits < -1) {
	throw new IllegalArgumentException(
	"Invalid value for defaultFractionDigits: "
	+ defaultFractionDigits);
	}
	this.defaultFractionDigits = defaultFractionDigits;
	return this;
	}

	/**
	* Set the numeric currency code.
	*
	* @param numericCode
	* the numeric currency code
	* @return the builder, for chaining
	*/
	public Builder setNumericCode(int numericCode) {
	if (numericCode < -1) {
	throw new IllegalArgumentException(
	"Invalid value for numericCode: " + numericCode);
	}
	this.numericCode = numericCode;
	return this;
	}

	/**
	* Sets the start UTC timestamp for the currenciy's validity.
	*
	* @param validFrom
	* the start UTC timestamp
	* @return the builder, for chaining
	*/
	public Builder setValidFrom(Long validFrom) {
	this.validFrom = validFrom;
	return this;
	}

	/**
	* Sets the end UTC timestamp for the currenciy's validity.
	*
	* @param validUntil
	* the ending UTC timestamp
	* @return the builder, for chaining
	*/
	public Builder setValidUntil(Long validUntil) {
	this.validUntil = validUntil;
	return this;
	}

	/**
	* Sets the legal tender attribute.
	*
	* @param legalTender
	* true, if the currency is a legal tender
	* @return the builder, for chaining
	*/
	public Builder setLegalTender(boolean legalTender) {
	this.legalTender = legalTender;
	return this;
	}

	/**
	* Sets the virtual attribute.
	*
	* @param virtual
	* true, if the currency is a virtual currency.
	* @return the builder, for chaining
	*/
	public Builder setVirtual(boolean virtual) {
	this.virtual = virtual;
	return this;
	}

	/**
	* Get the current namespace attribute set.
	*
	* @return the namespace value, or null.
	*/
	public String getNamespace() {
	return this.namespace;
	}

	/**
	* Get the current currency code attribute set.
	*
	* @return the currency code value, or null.
	*/
	public String getCurrencyCode() {
	return this.currencyCode;
	}

	/**
	* Get the current fraction digits attribute set.
	*
	* @return the currency fraction digits value.
	*/
	public int getDefaultFractionDigits() {
	return this.defaultFractionDigits;
	}

	/**
	* Get the current numeric code attribute set.
	*
	* @return the numeric code value.
	*/
	public int getNumericCode() {
	return this.numericCode;
	}

	/**
	* Get the starting validity period timestamp.
	*
	* @return the starting validity period tiemstamp, or null..
	*/
	public Long getValidFrom() {
	return this.validFrom;
	}

	/**
	* Get the ending validity period timestamp.
	*
	* @return the ending validity period tiemstamp, or null..
	*/
	public Long getValidUntil() {
	return this.validUntil;
	}

	/**
	* Access the legal tender attribute.
	*
	* @return the attribute value.
	*/
	public boolean isLegalTender() {
	return this.legalTender;
	}

	/**
	* Access the virtual attribute.
	*
	* @return the attribute value.
	*/
	public boolean isVirtual() {
	return this.virtual;
	}

	/**
	* Checks if this {@link Builder} instance can create a
	* {@link MoneyCurrency}.
	*
	* @see #build()
	* @return true, if the builder can build.
	*/
	public boolean isBuildable() {
	return namespace != null && currencyCode != null;
	}

	/**
	* Builds a new currency instance, the instance build is not cached
	* internally.
	*
	* @see #build(boolean)
	* @return a new instance of {@link MoneyCurrency}.
	*/
	public MoneyCurrency build() {
	return build(true);
	}

	/**
	* Builds a new currency instance, which ia additinoally stored to the
	* internal cache for reuse.
	*
	* @param cache
	* flag to optionally store the instance created into the
	* locale cache.
	* @return a new instance of {@link MoneyCurrency}.
	*/
	public MoneyCurrency build(boolean cache) {
	if (!isBuildable()) {
	throw new IllegalStateException(
	"Can not build CurrencyUnitImpl.");
	}
	if (cache) {
	if (validUntil != null) {
	LOGGER.warning("CurrencyUnit build: Can only cache currencies that have no validity constraints.");
	cache = false;
	}
	if (validFrom != null) {
	if (validFrom.longValue() > System.currentTimeMillis()) {
	LOGGER.warning("CurrencyUnit build: Can only cache currencies that are already valid.");
	cache = false;
	}
	}
	}
	if (cache) {
	String key = namespace + ':' + currencyCode;
	MoneyCurrency current = CACHED.get(key);
	if (current == null) {
	current = new MoneyCurrency(namespace, currencyCode,
	numericCode, defaultFractionDigits, validFrom,
	validUntil, legalTender, virtual);
	CACHED.put(key, current);
	}
	return current;
	}
	return new MoneyCurrency(namespace, currencyCode, numericCode,
	defaultFractionDigits, validFrom, validUntil, legalTender,
	virtual);
	}
	}

	/**
	* Adapter that implements the new {@link CurrencyUnit} interface using the
	* JDK's {@link Currency}.
	* <p>
	* This adapter will be removed in the final platform implementation.
	*
	* @author Anatole Tresch
	* @author Werner Keil
	*/
	private final static class JDKCurrencyAdapter extends MoneyCurrency
	implements Localizable {

	/**
	* serialVersionUID.
	*/
	private static final long serialVersionUID = -2523936311372374236L;

	/**
	* ISO 4217 currency code for this currency.
	*
	* @serial
	*/
	private final Currency currency;

	/**
	* Private constructor.
	*
	* @param currency
	*/
	private JDKCurrencyAdapter(Currency currency) {
	super(currency);
	this.currency = currency;
	}

	/*
	* (non-Javadoc)
	*
	* @see java.lang.Object#toString()
	*/

	public String toString() {
	return ISO_NAMESPACE + ':' + getCurrencyCode();
	}

	/*
	* (non-Javadoc)
	*
	* @see Localizable#getDisplayName(java.util.Locale)
	*/
	public String getDisplayName(Locale locale) {
	//return currency.getName(locale, nameStyle, isChoiceFormat) (locale);
	return currency.getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
	}

	}

	/**
	* Adapter that implements the new {@link CurrencyUnit} interface using the
	* JDK's {@link Currency}.
	* <p>
	* This adapter will be removed in the final platform implementation.
	*
	* @author Werner Keil
	*/
	private final static class ICUCurrencyAdapter extends MoneyCurrency
	implements Localizable {

	/**
	* serialVersionUID.
	*/
	private static final long serialVersionUID = -2523936311372374236L;

	/**
	* ISO 4217 currency code for this currency.
	*
	* @serial
	*/
	private final com.ibm.icu.util.Currency currency;

	/**
	* Private constructor.
	*
	* @param currency
	*/
	private ICUCurrencyAdapter(com.ibm.icu.util.Currency currency) {
	super(ISO_NAMESPACE, currency.getCurrencyCode(), -1, currency.getDefaultFractionDigits(),
	null, null, true, false);
	this.currency = currency;
	}

	/*
	* (non-Javadoc)
	*
	* @see java.lang.Object#toString()
	*/

	public String toString() {
	return ISO_NAMESPACE + ':' + getCurrencyCode();
	}

	/*
	* (non-Javadoc)
	*
	* @see javax.money.Localizable#getDisplayName(java.util.Locale)
	*/

	public String getDisplayName(Locale locale) {
	return currency.getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
	}

	}

	// public String getDisplayName(Locale locale) {
	// return getName(ULocale.forLocale(locale), LONG_NAME, new boolean[1]);
	// }
	//
	// public int getNumericCode() {
	// return -1;
	// }

	}