cloudsponge-lib-java

Java Wrapper for the CloudSponge.com Rest API

CloudSponge is the tool that you need to go viral. Create an account at http://www.cloudsponge.com and integrate with this library. In a few lines of code you'll have access to your users' contact lists.

How to Use it

First add it to your pom.xml

<dependency>
  <groupId>com.cloudsponge</groupId>
  <artifactId>cloudsponge</artifactId>
  <version>1.0-RC2</version>
</dependency>

Or, if you're not using Maven, download the single jar or the jar with all included dependencies and add it your project.

Then use it!

CloudSpongeApiFactory factory = new CloudSpongeApiFactoryImpl("DOMAIN_KEY", "DOMAIN_PASSWORD");

CloudSpongeApi<UserConsent> cloudSponge = factory.create(ContactsService.GMAIL);
// For AOL use:
// final CloudSpongeApi<ImportResponse> cloudSponge = factory.create(ContactsService.AOL);
// cloudSponge.userName("me").userPassword("test").beginImport();

try {
	UserConsent consent = cloudSponge.beginImport();
	// Manually open the consent page in a browser window to continue with the import
	System.out.println("Copy and paste the following URL into your favorite browser to continue with the import:");
	System.out.println(consent.getUrl());

	// Waiting for consent...
	ProgressEvents progress = cloudSponge.getImportProgress();
	while (!progress.isDone()) {
		progress = cloudSponge.getImportProgress();
		Thread.sleep(1000);
	}

	Event completeEvent = progress.getEvent(EventType.COMPLETE);
	if (completeEvent.getStatus() == EventStatus.ERROR) {
		System.out.println("Error: " + completeEvent.getValue());
	} else {
		UserContacts userContacts = cloudSponge.fetchContacts();
		Contact owner = userContacts.getOwner();
		System.out.println(owner);
		for (Contact contact : userContacts.getContacts()) {
			System.out.println(contact);
		}
	}
} finally {
	cloudSponge.close();
}

CloudSponge Proxy URL

The CloudSponge API Java Wrapper also includes an implementation of a Proxy URL for branding the user authentication process. For more the details, click here.

For using the Proxy URL Servlet, just add it to your web.xml file

<servlet>
	<servlet-name>CloudSponge URL Proxy</servlet-name>
	<servlet-class>com.cloudsponge.CloudSpongeProxyServlet</servlet-class>
</servlet>
<servlet-mapping>
	<servlet-name>CloudSponge URL Proxy</servlet-name>
	<url-pattern>URL_PATTERN</url-pattern>
</servlet-mapping>