Examples Install Guide

Repository for all classic demonstrators of the OpenCCM Platform. Amongst basic demos can be found the OMG's Dining Philosophers scenario demonstration.

This module does not require any modules to work properly, but it uses an OpenCCM Platform previously installed with its environment sourced. Note that the examples module is included in the checkout of the openccm-distrib.

Contents Structure

The Examples module contains the following example applications :

Demonstration	Description
`chat`	This illustrates a chat demonstration showing how client components use a facet provided by a server component to display text and how the server component could push events (all entered texts) to all clients.
`common`	This is not a demonstration ; This is a repository for common files used by all demos.
`demo1`	This illustrates a simple clients / server application showing how client components could be connected by a receptacle to a facet provided by a server component.
`demo2`	This illustrates a simple producer / consumers application showing how a producer component could push events by an event source to a set of event consumer sinks.
`demo3`	This illustrates a simple clients / server-producer / consumers application showing how a component can simultaneously be a server providing a facet and a producer with an event source.
`dinner`	This illustrates the philosopher's dinner with Philosopher, Fork and Observer components. Philosophers try to acquire both forks to eat and publish events with their state to observer components. This demo was used at 2002 Yokohama (Japan) and Orlando (USA) OMG Meetings to show interoperability between CCM implementations.
`filetransfer`	This illustrates a file transfer application based on three component types. Program components manage and send images to Channel components. Channel components receive images from Programs and send these images to TV components. The TV components are deployed on user's device and images are displayed and/or stored.
`hello`	This illustrates the classical Hello World application showing how component-unaware clients could create a server component and use a facet provided by this one.
`web`	This is not a demonstration ; This is the documentation directory.

Each demonstration (except for the filetransfer demonstration) contains both monolithic based (deprecated) and CIDL based component implementations.

Build Instructions

To compile a demonstration, do the following :

Go to the associated directory.
Execute your pre-installed ANT:
```
$ ant
```

This compiles both the monolithic based (deprecated) and CIDL based component implementations of each demonstration.

Results of Compilation

After compilation, demo directory contains new directories and files:

Directory	File	Description
class/		All compiled Java classes.
generated/		Java files generated from DTDs or IDL files.
archives/		Contains both JAR, CAR and AAR files.

See the user's guide for usage instructions.