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).

But this is just one of the many samples that have been written that will help you get started. The other can be found in the Enunciate distribution bundle and you can also check them out of SVN. Enunciate also has example applications with tests that are built with every release. You may also want to check out the tutorials for integrating Enunciate with your favorite application platform and you may find interesting this two-part tutorial for developing a RIA using Enunciate.

Step 1: Write the Code >>