I've developed classes to convert amount into it's phrase representation

Question

Hi everybody!
Example:
Number 25 can be converted into the phrase "twenty five"
or even into "twenty five Canadian Dollars" for english language, Canadian currency
This functionality can be supplied for major languages like Russian, German,
Spanish. French, Chinese, Hindi etc. All of these languages might have their
own specifics.
In future end-users will to be able to use this functionality via Web-services.
I also look forward to find reliable web site where We can host this web service and front-end servlet which will show this phrase based on { amount, language, currency } selected. That everybody can recieve it electronically via xml request or just copy result phrase from web page . Please send me a list of companies who potentially interested to host it including detailed info of Company/Persons name and his/her e-mail if possible.
I'm going to post them at apache.org but for now I've attached source code below
for your feedbacks and if somebody wants to join to me to implement some languages like french, spanish etc. Currency feature will be ready when I have more languages supporrt.
Author Igor Artimenko my e-mail is <[email protected]>
package org.apache.bussinessapi.test;
import org.apache.bussinessapi.AmountByWord;
* Test case prototype
* @author Igor Artimenko <[email protected]>
* @version 1.0 Initial draft for review
* Created on Jun 5, 2003
public class TestAmountByWord
     public TestAmountByWord()
          double array[] = { 123456789777L, -627845, 300.84, 670, 30, -100, -56879, 1008, 37, 205100, 0, 3000.67 };
          AmountByWord amountByWord = new AmountByWord();
          amountByWord.setLanguage( "en" );
          amountByWord.setCurrency( "en" );
          for (int i = 0; i < array.length; i++)
               System.out.println( array[ i ] );
               try {
                    System.out.println( amountByWord.getAmountByWord( array[ i ] ) );
               } catch (Exception e) {
                    e.printStackTrace();
               System.out.println( "---------------------------------" );               
     public static void main(String[] args)
          TestAmountByWord test = new TestAmountByWord();
package org.apache.bussinessapi;
* Usially used class to get string representation of the number
* in the human-readable format
* @author Igor Artimenko <[email protected]>
* @version 1.0 Initial draft for review
* Created on Jun 5, 2003
public class AmountByWord implements IAmountByWord
     private String language;
     private String currency;
     private String amountByWord;
     * Constructor AmountByWord
     public AmountByWord()
          super();
     * Method getAmountByWord is the most important method
     * @param amount to be represented in the human-readable format
     * @return String the phrase representation of number
     public String getAmountByWord( double amount ) throws Exception
          StringBuffer resultAmount = new StringBuffer();
          IAmountByWord amountByWord = null;
          //     First, create an appropriate instance
          try
               if ( language == null )
                    throw new Exception( "Language has not been assigned yet" );                    
               else if ( currency == null )
                    throw new Exception( "Currency has not been assigned yet" );                    
               Class cl = Class.forName( "org.apache.bussinessapi.AmountByWord".concat( language ) );
               try
                    amountByWord = (IAmountByWord) cl.newInstance();
               catch ( InstantiationException e )
                    throw new Exception( "can not be instantiated" );
               } // catch
               catch ( IllegalAccessException e )
                    throw new Exception(
                         "IllegalAccessException arrised during instantiating of " );
               }     // catch
          } // try
          catch ( ClassNotFoundException e )
               throw new Exception( "Class could not be found " );
          } // catch
          // for now the number only
          return amountByWord.getAmountByWord( amount );
     * Method getMoneyAmountByWord is the most important method
     * @param amount to be represented in the human-readable format
     * @return String the phrase representation of number
     public String getMoneyAmountByWord( double amount ) throws Exception
          StringBuffer resultAmount = new StringBuffer();
          IAmountByWord amountByWord = null;
          //     First, create an appropriate instance
          try
               if ( language == null )
                    throw new Exception( "Language has not been assigned yet" );                    
               else if ( currency == null )
                    throw new Exception( "Currency has not been assigned yet" );                    
               Class cl = Class.forName( "org.apache.bussinessapi.AmountByWord".concat( language ) );
               try
                    amountByWord = (IAmountByWord) cl.newInstance();
               catch ( InstantiationException e )
                    throw new Exception( "can not be instantiated" );
               } // catch
               catch ( IllegalAccessException e )
                    throw new Exception(
                         "IllegalAccessException arrised during instantiating of " );
               }     // catch
          } // try
          catch ( ClassNotFoundException e )
               throw new Exception( "Class could not be found " );
          } // catch
          // for now the number only
          return amountByWord.getMoneyAmountByWord( amount );
     * getCurrency Method
     * @return To retrieve currency code currently used
     public String getCurrency()
          return currency;
     * getLanguage
     * @return To retrieve Language locale code currently used
     public String getLanguage()
          return language;
     * setCurrency
     * @return To setup Currency locale code to be used
     public void setCurrency( String currency )
          this.currency = currency;
     * setLanguage
     * @return To setup Language locale code to be used
     public void setLanguage( String language )
          this.language = language;
package org.apache.bussinessapi;
import java.util.Properties;
* The purpose is to return string representation on the number
* in the human-readable format based on English grammar
* Generally you can use this class as a base for your own language
* like Russian, German, Spanish, French etc.
* They must implement IAmountByWord interface
* @author Igor Artimenko <[email protected]>
* @version 1.0 Initial draft for review
* Created on Jun 5, 2003
public class AmountByWorden implements IAmountByWord
     final private Properties langTokens = new Properties();
     AmountByWorden()
          langTokens.put( "0", "zero" );          
          langTokens.put( "1", "one" );
          langTokens.put( "2", "two" );
          langTokens.put( "3", "three" );
          langTokens.put( "4", "four" );
          langTokens.put( "5", "five" );
          langTokens.put( "6", "six" );
          langTokens.put( "7", "seven" );
          langTokens.put( "8", "eight" );
          langTokens.put( "9", "nine" );
          langTokens.put( "10", "ten" );
          langTokens.put( "11", "eleven" );
          langTokens.put( "12", "twelve" );
          langTokens.put( "13", "thirteen" );
          langTokens.put( "14", "fourteen" );
          langTokens.put( "15", "fifteen" );
          langTokens.put( "16", "sixteen" );
          langTokens.put( "17", "seventeen" );
          langTokens.put( "18", "eighteen" );          
          langTokens.put( "19", "nineteen" );
          langTokens.put( "20", "twenty" );
          langTokens.put( "30", "thirty" );
          langTokens.put( "40", "fourty" );
          langTokens.put( "50", "fifty" );
          langTokens.put( "60", "sixty" );
          langTokens.put( "70", "seventy" );
          langTokens.put( "80", "eighty" );
          langTokens.put( "90", "ninety" );
          langTokens.put( "100", "hundred" );          
          langTokens.put( "1000", "thousand" );
          langTokens.put( "1000000", "million" );
          langTokens.put( "1000000000", "billion" );
          langTokens.put( "1000000000000L", "trillion" );
          langTokens.put( "minus", "minus" );
          langTokens.put( "and", "and" );
          langTokens.put( "point", "point" );
     /* (non-Javadoc)      
     * It does not yet working. Proper implementation coming soon.
     * @see org.apache.bussinessapi.IAmountByWord#getAmountByWord(double)
     public String getAmountByWord( double amount ) throws Exception
          NumberByWord numberByWord = new NumberByWord();
          StringBuffer fullNumber = new StringBuffer();
          numberByWord.setLanguageTokens( langTokens );
          // also should be replaced by full phrase
          fullNumber = fullNumber.append(
                    numberByWord.getNumberByWord( (long) amount ).trim() );
          // for now 2 numbers after .
          int theRest = (int) ( ( amount - (long) amount ) * 100 );
          if ( theRest != 0 )
               fullNumber.append( " " ). append( langTokens.get( "point" ) ).
                         append( " " ).append(     
                         numberByWord.getNumberByWord( (long) theRest ).trim() );
          return fullNumber.toString();           
     /* (non-Javadoc)      
     * It does not yet working. Proper implementation coming soon.
     * @see org.apache.bussinessapi.IAmountByWord#getMoneyAmountByWord(double)
     public String getMoneyAmountByWord( double amount ) throws Exception
          NumberByWord numberByWord = new NumberByWord();
          StringBuffer fullNumber = new StringBuffer();
          numberByWord.setLanguageTokens( langTokens );
          // also should be replaced by full phrase
          fullNumber = fullNumber.append(
                    numberByWord.getNumberByWord( (long) amount ).trim() );
          // for now 2 numbers after .
          int theRest = (int) ( ( amount - (long) amount ) * 100 );
          if ( theRest != 0 )
               fullNumber.append( " " ). append( langTokens.get( "point" ) ).
                         append( " " ).append(     
                         numberByWord.getNumberByWord( (long) theRest ).trim() );
          return fullNumber.toString();           
package org.apache.bussinessapi;
* Each class created for the purpose of giving back
* a string representation of the number MUST implement this interface
* @author Igor Artimenko <[email protected]>
* @version 1.0 Initial draft for review
* Created on Jun 5, 2003
public interface IAmountByWord {
     * getMoneyAmountByWord The purpose of this method is to return
     * string representation on the number in the human-readable format
     * in a regular format ( like 25.78
     * "twenty five point seventy eight" )
     * @param anAmount to be converted into it's string representation
     * @return A string representation of the number
     * @throws Exception if something went wrong
     public String getAmountByWord( double anAmount ) throws Exception;
     * getMoneyAmountByWord The purpose of this method is to return
     * string representation on the number in the human-readable format
     * in a money format like ( 25.78 Can
     * "twenty five Canadian Dollars and seventy eight Cents" )
     * @param anAmount to be converted into it's string representation
     * @return A string representation of the number
     * @throws Exception if something went wrong
     public String getMoneyAmountByWord( double anAmount )
               throws Exception;
package org.apache.bussinessapi;
import java.util.*;
* This class implements generic algoritm of converting a number into
* human-readable format.
* @author Igor Artimenko <[email protected]>
* @version 1.0 Initial draft for review
* Created on Jun 5, 2003
* You can use getNumberByWord method
* if your language fits into this algorithm or
* extend from this class and make some transformations in the child
* method.
* Don't forget to setup language Tokens
* via setLanguageTokens method call first
public class NumberByWord
     private Properties langTokens = new Properties();
     * Constructor for NumberByWord.
     public NumberByWord()
          super();
     * Method getNumberByWord. The most important method.
     * Standard actions are here
     * @param amount Accepts only mathematical integer
     * @return String representation of this phrase
     public String getNumberByWord( long amount )
          StringBuffer strNumberByWord = new StringBuffer( "" );
          SortedMap smallAmounts = new TreeMap();
          String str = new Long( Math.abs( amount ) ).toString();
          int currentPosition = str.length();
          long currentThousand = 1;
          // break by thousands
          while ( currentPosition > 0 )
               smallAmounts.put( new Long( currentThousand ), new Integer(
                         str.substring( Math.max( 0, currentPosition - 3 ),
                         currentPosition ) ) );               
               strNumberByWord.insert( 0,
                    getSmallest( (Integer) smallAmounts.get( new Long( currentThousand ) ) ) +
                    ( currentThousand == 1 ? "" : " " +
               langTokens.getProperty( new Long( currentThousand ).toString() ) ) );
               currentPosition -= 3;     
               currentThousand *= 1000;
          if ( amount == 0 ) {
               strNumberByWord.append( langTokens.getProperty( "0" ) );
          else if ( amount < 0 )
               strNumberByWord.insert( 0, langTokens.getProperty( "minus" ) );
          return strNumberByWord.toString().trim();
     * @param smallNumber this number must in the range from 0 to 999
     *      inclusive
     * @return String representation of this number
     public StringBuffer getSmallest( Integer smallNumber )
          StringBuffer smallestNumberByWord = new StringBuffer( "" );
          int hundreds = (int) ( smallNumber.intValue() / 100 );
          int dozens = (int)( ( smallNumber.intValue() - hundreds * 100 ) / 10 );
          int rest = smallNumber.intValue() - hundreds * 100 - dozens * 10;
          // using smallNumber create small phrase
          // Let's compund the phrase itself
          if ( hundreds > 0 ) {
               smallestNumberByWord.append( " " ).append(
                         langTokens.getProperty( new Long( hundreds ).toString() ) ).append( " " ).append(
                         langTokens.getProperty( new Long( 100 ).toString() ) );
          Object obj = langTokens.getProperty( new Long( dozens * 10 + rest ).toString() );
          // is atomic like 15 juust substitute
          if ( dozens * 10 + rest != 0 )
               if ( obj != null )
                    smallestNumberByWord.append( " " ).append( obj );
               else
                    smallestNumberByWord.append( " " ).append(
                              langTokens.getProperty( new Long( dozens * 10 ).toString() ) ).
                              append( " " ).append(     langTokens.getProperty( new Long( rest ).
                              toString() ) );
          return smallestNumberByWord;
     * setLanguageTokens Use before making call to getNumberByWord
     * @param langTokens Properties of language token used by
     * particular language
     public void setLanguageTokens( Properties langTokens )
          this.langTokens = langTokens;
----------------------------------------------------------------------------------

Answer 1

Hi Hoos!
I found a host for that project. It's called valia at sourceforge.net.
We have already about 7 developers ( English, Russian, French, German, Italian, Arabic, Hindi, Traditional Chinese ). We are looking for guys with Spanish and Japanese.
Also if you want we can expand our support for Persian you are very welcome to join. It's usially small job, just replace one, two etc by your spoken language plus coding of grammar exceptions.
Withregard of applicability we are making first version to be working for even small j2me. So you can integrate it to everywhere including cell phones. But major goal is for bussiness apps & web services, possibly entertainements.
Would you reply to me if you wanted to join at [email protected]
Have a great day
Igor Artimenko
valia, Project Manager