mirror of
https://github.com/AdaCore/PolyORB.git
synced 2026-02-12 13:01:15 -08:00
78ff56464d
[Imported from Perforce change 4708 at 2006-12-01 19:40:32] Subversion-branch: /trunk/polyorb Subversion-revision: 33600
187 lines
7.6 KiB
Plaintext
187 lines
7.6 KiB
Plaintext
------------------------------------------------------------------------------
|
|
-- --
|
|
-- POLYORB COMPONENTS --
|
|
-- --
|
|
-- Copyright (C) 2001 Free Software Fundation --
|
|
-- --
|
|
-- PolyORB is free software; you can redistribute it and/or modify it --
|
|
-- under terms of the GNU General Public License as published by the Free --
|
|
-- Software Foundation; either version 2, or (at your option) any later --
|
|
-- version. PolyORB is distributed in the hope that it will be useful, --
|
|
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
|
|
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public --
|
|
-- License for more details. You should have received a copy of the GNU --
|
|
-- General Public License distributed with PolyORB; see file COPYING. If --
|
|
-- not, write to the Free Software Foundation, 59 Temple Place - Suite 330, --
|
|
-- Boston, MA 02111-1307, USA. --
|
|
-- --
|
|
-- PolyORB is maintained by ENST Paris University. --
|
|
-- --
|
|
------------------------------------------------------------------------------
|
|
|
|
This is the documentation for PolyORB version @polyorb_version@.
|
|
|
|
The home page of the project is located at http://www.polyorb.eu.org/.
|
|
This is where you can find news about the project, new releases, and
|
|
pointers to several documents and papers related to PolyORB.
|
|
|
|
What is PolyORB?
|
|
----------------
|
|
|
|
PolyORB is a polymorphic, reusable infrastructure for building
|
|
object-oriented distributed systems. Middleware environments are
|
|
software libraries that hide the complex issues of distribution
|
|
and provide the programmer with high-level abstractions that allow
|
|
easy and transparent construction of distributed applications.
|
|
A number of different standards exist for creating object-oriented
|
|
distributed applications. These standards define two things:
|
|
|
|
* the interface seen by the developer's applicative objects;
|
|
* the protocol used by the middleware environment to talk to other
|
|
nodes in the distributed application.
|
|
|
|
Usually, middleware for one platform supports only one set of
|
|
such interfaces, and cannot interoperate with other platforms.
|
|
|
|
A polymorphic middleware allows the existence of several different
|
|
implementations of each of these aspects to be used within the same
|
|
middleware framework. In addition, PolyORB allows such different
|
|
personalities to coexist in the same instance of the running middleware;
|
|
it decouples the personality presented to applications on one side
|
|
("application personality"), and the personality presented
|
|
to other middlewares on the other side ("protocol personality").
|
|
Multiple implementations of each personalisable aspect can
|
|
coexist within the same instance of the running middleware:
|
|
unlike previous generic middlewares, PolyORB is actually schizophrenic.
|
|
|
|
The decoupling of application and protocol personalities, and the support
|
|
for multiple simultaneous personalities within the same running middleware
|
|
are key features required for the construction of interoperable
|
|
distributed applications. This allows PolyORB to communicate
|
|
with middlewares that implement different distribution standards:
|
|
PolyORB provides middleware-to-middleware interoperability.
|
|
|
|
The PolyORB architecture also permits the automatic,
|
|
just-in-time creation of proxies between incompatible environments
|
|
(although this feature is not implemented yet).
|
|
|
|
Build requirements
|
|
------------------
|
|
|
|
Ada 95 compiler: GNAT 3.14a1 or later.
|
|
|
|
Optional: XmlAda (http://libre.act-europe.fr/xmlada/) if you want to
|
|
build the SOAP protocol personality.
|
|
|
|
Build instructions
|
|
------------------
|
|
|
|
See file INSTALL.
|
|
|
|
Developers building PolyORB from the version control repository
|
|
who need to rebuild the configure and Makefile.in files should
|
|
use the script support/reconfig for this purpose.
|
|
|
|
Available options for the 'configure' script include:
|
|
--enable-xmlada: set if you have XmlAda and you want to build the
|
|
SOAP protocol personality.
|
|
--enable-shared: build shared libraries.
|
|
--enable-debug: enable debugging information generation and supplementary
|
|
runtime checks.
|
|
|
|
Documentation overview
|
|
----------------------
|
|
|
|
README: This file, first instructions.
|
|
src/ROADMAP: Overview of PolyORB source code.
|
|
doc/*: Miscellaneous documents describing PolyORB internals.
|
|
|
|
Usage of idlac
|
|
--------------
|
|
|
|
idlac is the IDL-to-Ada 95 compiler of PolyORB. It is an evolution
|
|
of the compiler that was present in AdaBroker.
|
|
|
|
idlac [-i] [-k] idl_file [-cppargs ...]
|
|
|
|
-i Generate implementation template.
|
|
-k Keep temporary files.
|
|
-q Be quiet.
|
|
-cppargs ARGS
|
|
Pass ARGS to the C++ preprocessor.
|
|
|
|
This creates several files :
|
|
|
|
- myinterface.ads, myinterface.adb : these files contain the mapping
|
|
for user defined types (client and server side).
|
|
|
|
- myinterface-impl.ads, myinterface-impl.adb : these files are to be
|
|
filled by the user. They contain the implementation of the
|
|
server. They are generated only if the -i flag is specified.
|
|
|
|
- myinterface.ads, myinterface.adb : these files
|
|
contain the client stubs for the interface.
|
|
|
|
- myinterface-skel.ads, myinterface-skel.adb : these files
|
|
contain the server-side skeletons for the interface.
|
|
|
|
- myinterface-stream.ads, myinterface-stream.adb : these files
|
|
contain subprograms to marshall data according to the CDR protocol.
|
|
|
|
Usage of PolyORB
|
|
----------------
|
|
|
|
See examples of simple CORBA clients and servers in subdirectory 'examples/'.
|
|
Basically, a simple non-tasking CORBA client should have a dependency
|
|
and a pragma Elaborate_All on PolyORB.Setup.CORBA_Client. A CORBA+SOAP
|
|
server should have a dependcy and pragma Elaborate_All on one of
|
|
PolyORB.Setup.No_Tasking_Server, PolyORB.Setup.Thread_Pool_Server or
|
|
PolyORB.Setup.Thread_Per_Session_Server.
|
|
|
|
If you want anything different, you should create a package similar
|
|
to one of these setup packages and use it instead. That package must
|
|
have dependencies and pragmas Elaborate_All on all subsystems you need
|
|
to use, and must contain a call to PolyORB.Configurator.Initialize_World
|
|
in its own elaboration code.
|
|
|
|
Bug reports
|
|
-----------
|
|
|
|
If you find a bug or would like to submit patches, please do so indicating
|
|
the release you use. We accept patch files. To produce such a patch file,
|
|
put your files in the PolyORB directory and our files in the directory
|
|
PolyORB.orig, and use the following command:
|
|
|
|
diff --recursive --context PolyORB.orig PolyORB > patch_file
|
|
|
|
and send us the patch_file via e-mail at the address
|
|
|
|
polyorb-devel@polyorb.eu.org
|
|
|
|
If your diff version do not understand the --recursive or --context
|
|
option, please use the GNU diffutils package which may be found on any
|
|
GNU archive (e.g. ftp://ftp.lip6.fr/pub/gnu/).
|
|
|
|
Note that unified diff files (-u option of GNU diff) are also welcomed.
|
|
|
|
Contributors:
|
|
-------------
|
|
|
|
PolyORB has been developped since January, 1999 by the following
|
|
contributors:
|
|
|
|
* Fabien Azavant (azavant@enst.fr)
|
|
* Emmanuel Chavane (chavane@enst.fr)
|
|
* Jean-Marie Cottin (cottin@enst.fr)
|
|
* Michael Friess
|
|
* Nicolas Fritsch
|
|
* Mejdi Kaddour
|
|
* Laurent Kubler (kubler@enst.fr)
|
|
* Vincent Niebel (niebel@enst.fr)
|
|
* Laurent Pautet (pautet@enst.fr)
|
|
* Sebastien Ponce (ponce@enst.fr)
|
|
* Thomas Quinot (quinot@enst.fr)
|
|
* Nicolas Setton
|
|
* Frank Singhoff (singhoff@enst.fr)
|
|
* Samuel Tardieu (sam@enst.fr)
|