During 2006, the Docs & Tools team ran a survey asking developers what they would like to see. A popular request was for full-blown example applications that showed how theory could be applied to make exciting, real-world applications that worked on Sony Ericsson mobile phones. In recognition of this, Sony Ericsson Developer World is pleased to introduce Blueprints: themed packages of example applications with source code that are designed to highlight the functionality available through our Java ME Platform offering. You can use them as reference points for our own innovative applications and ideas or simply use them for your personal use.

Web Services Blueprints

The first blueprint release is focused on Web Services and makes use of AXP 1.2 (Java API for XML Processing) which is subset available in JSR 172, found in Sony Ericsson Java Platform 6 or later.  The second generation of web-based communities and hosted services has enjoyed a lot of media coverage and increasingly new, user driven sites are appearing. Web services are usually associated with SOAP, however accessing many popular sites offer a variety of other types of web service such as XML-RPC, REST, Atom or RSS.
 
We have created four example applications for your personal and non-commercial use that highlight how you can use these different styles of service in your own applications. In order to use the applications you must first compile them.

Please refer the accompanying doc folders to learn more about implementation details and the flow of operation. Before using any of the services, please read and adhere to the service providers respective terms of service to ensure acceptable usage.

 Download Sony Ericsson Blueprints for Java ME (CLDC) 1.0: Web Services>> 

1. BBC Listings (REST, TV-Anytime)

The BBC has created a beta web API allowing you to browse their program listings. The API offers two response types, simple format or "TV-Anytime" format. TV Anytime is an open specification created by the TV Anytime forum, which consists of a number of broadcasters. The sample application uses TV-Anytime to illustrate how you might query and parse the TV-Anytime format. It relies upon the JAXP 1.2 (Java API for XML Processing) subset available in JSR 172. Programs can be stored in your calendar (JSR 75) for reminder.

Useful links:

• BBC Web API (Beta)>>
• TV-Anytime>>
• Terms of use>>

2. Blogger Client (Atom)

Blogger is a popular blogging service that allows you to browse and publish blogs using the ATOM. ATOM consists of two standards, Atom Syndication Format which is used for consuming web feeds and the Atom Publishing Protocol which is used to create and edit feed content.  The example uses the JAXP 1.2 (Java API for XML Processing) subset available in JSR 172.

Useful links:

• Blogger>>
• Google Blogger Data API>>
• AtomEnabled>>
• Wikipedia web feed information>>
• Terms of use>>

3. GMail Stand-by MIDlet (Atom)

GMail a web mail service which allows you to check your unread mail using ATOM. It highlights stand-by MIDlet functionality, which is a feature of Sony Ericsson Java Platform 7 and allows you to use a MIDlet as a wallpaper by applying a JAD attribute. GMail requires some login credentials to enable querying your account which need encoding. The package relies upon part of the Bouncy Castle Crypto APIs to perform encoding of credentials.

Please note that the MIDlet polls the GMail Atom server every 60 minutes and there may be a networking cost associated with using it.

Useful links:

• GMail>>
• Atom information>>
• Bouncy Castle Crypto APIs>>
• Terms of use>>

4. Flickr (XML-RPC)

Flickr is a site for sharing and swapping photos and they provide a variety of API, either through REST or RPC-style.  The application uses XML-RPC and includes functionality for viewing the most recent uploaded photos, viewing photos from a specific user, take a photo with the camera and upload it to your Flickr account as well as browsing the file system of the device and upload stored photos. The package relies upon part of the Bouncy Castle Crypto APIs to perform encoding of credentials.

Flickr requires keys to be generated for programmatic access to Flickr which allow them to track API usage. Please refer to http://www.flickr.com/services/api/keys/ for further information and to obtain an application key, secret key and unique URL. The information should be manually entered into the com/sonyericsson/flickrclient/config/Config class before usage.

Useful link:

• Flickr services API documentation>>
• Terms of use>>

More information:

• Download Sony Ericsson Blueprints for Java ME (CLDC) 1.0: Web Services>> 
• Introducing XML Parsing with JSR 172>>
• Getting Started with Web Services, JSR 172 for the Java Platform, Micro Edition Tutorial>>