enunciate

articulate your web api.

Introduction

One of the most irritating things about Web service development demos is that they attempt to wow you with the simplicity and interoperability of their development tool by exposing one of three things: a "Hello, World!" app, an echo example, or a stock quote service. The data structures are no more complex than flat strings, the method signatures are single-arg, single return value with no faults, and they leave out the huge mess of deployment descriptors, dependencies, configuration, packaging, and deployment that makes up a significant part of Web service development.

This getting started guide will attempt to walk through a real-world (okay, mock-real-world) example of Web service development, without trying to hide the man behind the curtain. Of course, some attempt to be concise needs to be made, but at least you'll get the idea of the full development effort. And you'll see more than just "Hello, World".

We'll be writing a social networking app. For this tutorial, the name of our social networking app is IfYouWannaBeCool.com.

Note that the source code for this getting started guide is included in the distribution bundle along with a sample Ant build file, a sample Maven 2 POM, and an example of how to invoke Enunciate via the command line (see the README).

Step 1: Write the Code >>