LibreSource

1 SCOrWare FraSCAti Runtime 0.4 Standalone Distribution

FraSCAti is an implementation of the Service Component Architecture (SCA) specifications provided by the Open SOA consortium (OSOA). The FraSCAti Runtime platform is supported by the SCOrWare consortium funded by the french national research agency (ANR).

1.1 Table of content
1. Introduction
1. Requirements
1. Installation
1. Building component libraries
1. Running SCA composites
1. Client and Server components implementation
1. Links


1.1 Introduction

FraSCAti is a component framework providing runtime support for SCA components. The FraSCAti runtime supports SCA composite definitions which are conform to the SCA Assembly Model 1.0 specifications, Java component implementation (SCA Java Component Implementation V1.00), remote component bindings using Web Services and Java RMI protocols.

1.1 Requirements

Java SE 1.5 (or later) is required to compile SCA components and run FraSCAti.


1.1 Installation

Unzip FraSCAti distribution archive and you get the following directory structure:

- /bin      -  Launch scripts allowing to compile and run SCA components
- /lib      -  FraSCAti libraries
- /examples -  SCA component implementation and composite examples
- /conf     -  FraSCAti configuration files
  
To compile and start SCA composites with FraSCAti, you also have to set the FRASCATI_HOME variable in your system environment, where FRASCATI_HOME is the directory where the FraSCAti runtime distribution was extracted.

1.1 Building component libraries

This distribution provides a build script in order to ease compilation of SCA Java component libraries. In a command shell, from the FRASCATI_HOME directory, type: 

{code}bin/compileSCA.bat <appDirectory> <jarName>{code}
under Windows systems or
{code}bin/compileSCA.sh <appDirectory> <jarName>{code}
under Linux systems
 
Where <appDirectory> is the directory containing your Java implementation and <jarName> is the desired name for the resulting JAR file.
 
For instance, to compile the 'helloworld' Java implementation provided in the example directory, type the following command :

{code}bin/compileSCA.bat example/helloworld helloworld{code}
under Windows systems or
{code}bin/compileSCA.sh example/helloworld helloworld{code}
under Linux systems
 
Will create the library 'helloworld.jar' containing the SCA/Java compiled components of the helloworld example.

1.1 Running SCA composites

SCA composite definitions and SCA Java components are run using the FraSCAti runtime platform. This distribution provides a script allowing to start the FraSCAti runtime with a SCA composite. In a command shell, from the FRASCATI_HOME directory, type:

{code}bin/frascati.bat <composite> -libpath <jarList>{code}
under Windows systems or
{code}bin/frascati.sh <composite> -libpath <jarList>{code}
under Linux systems
 
Where <composite> is the SCA composite file to be run by FraSCAti, designated by its name. And <jarList> is a list of JAR files, separated by ':' under Linux systems and ';' under Windows systems.

Note that <composite> can be a resource of the libraries loaded by FraSCAti, a composite file in the file system, or an URL.

For instance, to run the helloworld example with FraSCAti, type the following command:

{code}bin/frascati helloworld -libpath helloworld.jar{code}
 
Will start the FraSCAti runtime with the helloworld composite included in the helloworld.jar archive in a server mode (no service/method to invoke). In order to invoke a specified method fo a service, you just have to use the \--service-name (-s) <serviceName> AND the \--method-name (-m) <methodName> options.

The Java RMI protocol can also be tested within the helloworld example, using the 'helloworld-rmi-standalone' composite definition, for running client and server at the same time, or with both 'helloworld-rmi-server' and 'helloworld-rmi-client' composite definitions for running client and server in two distinct shells.


1.1 Client and Server components implementation

When an SCA composite instance is created, the FraSCAti runtime checks if the resulting composite provides a SCA service implementing the java.lang.Runnable interface. 
When such service is promoted by the composite, the FraSCAti runtime invokes the "run()" method. Implementing an SCA composite client with this interface helps in having some procedures to be called after the composite instance has been created.

When the composite instance does not provide the java.lang.Runnable interface, the FraSCAti runtime creates and starts an instance of the SCA composite then wait until a key is pressed. Such case particularly helps in running SCA composite server waiting for remote invocations.

For example, typing the following command in a shell (using the helloworld sample previously compiled):

{code}bin/frascati.bat helloworld-ws-server -libpath helloworld.jar{code}
under Windows systems or
{code}bin/frascati.sh helloworld-ws-server -libpath helloworld.jar{code}
under Linux systems

Will start an helloworld message printer waiting for invocations through SOAP messages (server mode), while typing in another shell:

{code}bin/frascati.bat helloworld-ws-client --service-name r --method-name run -libpath helloworld.jar{code}
under Windows systems or
{code}bin/frascati.sh helloworld-ws-client --service-name r --method-name run -libpath helloworld.jar{code}
under Linux systems

Will start a client composite which performs invocations on the server in its "run()" method. This result in printing the 'Hello World' message on the server side.

1.1 Links

- SCOrWare Consortium : http://www.scorware.org
- OSOA Consortium : http://www.osoa.org
- Agence Nationale de la Recherche (ANR) : http://www.agence-nationale-recherche.fr/
Navigation

Contextual Menu

SCOrWare

Download

Actions

Resource Menu

Frascati-runtime-04-README
