mirror of
https://github.com/AdaCore/PolyORB.git
synced 2026-02-12 13:01:15 -08:00
22caeb59f9
[Imported from Perforce change 5618 at 2006-12-01 19:48:26] Subversion-branch: /trunk/polyorb Subversion-revision: 33963
86 lines
2.8 KiB
Plaintext
86 lines
2.8 KiB
Plaintext
----------------------------------------
|
|
-- --
|
|
-- ---- --- -- ---- --
|
|
-- - - - - - - --
|
|
-- - - ---- - - --
|
|
-- ---- --- - - ---- --
|
|
-- --
|
|
----------------------------------------
|
|
-- CORBA --
|
|
-- Interface for --
|
|
-- Ada'95 distributed systems annex --
|
|
-- Objects --
|
|
----------------------------------------
|
|
-- Copyright (C) 1999 --
|
|
-- École nationale supérieure des --
|
|
-- télécommunications --
|
|
----------------------------------------
|
|
-- Parts Copyright (C) --
|
|
-- Free Software Fundation, Inc. --
|
|
----------------------------------------
|
|
|
|
Created by Thomas Quinot <quinot@inf.enst.fr>.
|
|
|
|
$Id$
|
|
|
|
The purpose of the CIAO project is to provide an automated means
|
|
of providing a CORBA interface for CORBA clients to perform
|
|
requests on existing Ada'95 Distributed Systems Annex packages.
|
|
|
|
CIAO comprises:
|
|
- a translator that generates an OMG IDL description of
|
|
the visible part of a Remote_Types or Remote_Call_Interface
|
|
Ada'95 package;
|
|
- a code generator which produces an agent that listens to CORBA
|
|
requests for the CORBA objects corresponding to the DSA package,
|
|
and services them by performing the corresponding DSA calls.
|
|
|
|
The translator accepts as entry all legal Ada'95 library units
|
|
that have the Pure, Remote_Types or Remote_Call_Interface category,
|
|
with some restrictions listed in the documentation.
|
|
|
|
Usage
|
|
-----
|
|
|
|
1. Run ciao once for the specification of each RCI or RT package
|
|
in your application:
|
|
|
|
$ ciao -tkf rci1.ads
|
|
$ ciao -tkf rci2.ads
|
|
$ ciao -tkf rt1.ads
|
|
$ ciao -tkf rt2.ads
|
|
|
|
This produces IDL declarations and proxy implementation for each
|
|
package.
|
|
|
|
2. Run idlac, AdaBroker's IDL to Ada compiler, for each of the generated
|
|
IDL contracts:
|
|
|
|
$ idlac rci1.idl
|
|
$ idlac rci2.idl
|
|
$ idlac rt1.idl
|
|
$ idlac rt2.idl
|
|
|
|
3. Add the proxy partition in your GNATDIST configuration file:
|
|
|
|
ProxyP : Partition := (DSA_RCI1.Impl, DSA_RCI2.Impl);
|
|
-- List all RCI impls here.
|
|
procedure Proxy_Main;
|
|
-- proxy_main.adb is part of the CIAO distribution
|
|
for ProxyP'Main use Proxy_Main;
|
|
for ProxyP'Termination use Local_Termination;
|
|
|
|
4. Run gnatdist. You need to have a configured AdaBroker source
|
|
tree in $AB_SRC.
|
|
|
|
$ gnatdist <your-args> `adabroker-config --cflags` \
|
|
-I$AB_SRC/cos/naming -I$AB_SRC/idls/cos/naming \
|
|
-largs `adabroker-config --libs`
|
|
|
|
The generated proxy partition acts as a CORBA server.
|
|
It will register each RCI package with the CORBA Naming
|
|
Service. CORBA clients can then query the naming service to
|
|
obtain references to RCI packages, and invoke services provided
|
|
by these packages to obtain references to DSA distributed objects.
|
|
|