import com.xdatasystem.contactsimporter.*;

// automatically guess the correct implementaion based on the email address
ContactListImporter importer=ContactListImporterFactory.guess("someuser@hotmail.com", "password");
List<Contact> contacts=importer.getContactList();
for(Contact c : contacts) {
  System.out.println("name: "+c.getName()+", email: "+c.getEmail());
}

Other ways to instantiate a ContactListImporter using the factory can be done as follows:

// creates an hotmail contact importer
importer=ContactListImporterFactory.hotmail("someuser@hotmail.com", "password");
// creates an gmail contact importer
importer=ContactListImporterFactory.gmail("someuser@gmail.com", "password");

Dependencies

This library has the following depenencies:

The apache HttpComponents HttpClient 4.0 library: http://hc.apache.org/

Log4j

JSON library (needed for gmail importer) http://json.org/java
a CVS library for parsing comma-separated-formats

This library can be used to support a -invite-your-friends- function for your site.

This library builds upon the knowledge gathered by the creator of the following ruby contactsimporter library:

http://rufy.com/contacts/doc/

Author

This program was created by Tjerk Wolterink and donated to the open source community. Cristian Ventura added the Yahoo importer implementation. You are free to add more importers, or to fix bugs.. just give me a mail: tjerkw AT gmail.com (replace AT by the symbol, you know which symbol ;-)

Thanks to Thomas Bernard for the port to the new Hotmail Version. Thanks to any other contributers & bug reports!