Download version 1.4.8: Windows or Linux

Network Library: Eiffel Remote Object Server (EROS)

This library has 40 classes.

EROS (for Eiffel Remote Object Server), is an experimental an XML orientated remote procedure call application framework with an original protocol based purely on XML processing instructions rather that any special XML tags.

Custom Variables

When including eros.ecf in your project it is necessary to define a custom variable eros_server_enabled. To build a server application set the value to true. To build a client application set value to false.

Features

Easily create multi threaded XML-RPC applications in Eiffel.
Allows standard XML documents (SVG, XHTML etc) to be turned into procedure calls with the addition of a single processing instruction.
Based on framework that allows flexible mapping of XML data to native Eiffel objects. Represent your XML data in Eiffel any way you want. The fact that you only need to include as much data as you need makes it much more efficient than a DOM based approach.
Deserialization (XML->Eiffel) uses declarative xpath to setter mapping arrays. Multi context mapping greatly simplifies deserialization of complex documents by eliminating the need for absolete XPaths. Instead a small number of XML contexts are defined and attribute mappings use relative xpaths.
Serialization (Eiffel->XML) uses Evolicity the Eiffel Loop templating mini-language. Evolicity is similar to Apache Velocity but supports multi-context serialization. This greatly simplifies serialization of complex Eiffel structures.
Remotely accessible application components can be developed initially with a single threaded console test harness, and then later deployed on multi-threaded server with thread output and performance monitor.
A server GUI controls startup/shutdown and thread log output context switching in command console. Context switching has browser like navigation controls and allows you to easily monitor a large number of threads.
The server GUI monitors 11 different performance characteristics.

Demo Applications

Two demo applications are provided that do signal math including Fourier transformations based on Greg Lee's Numeric Eiffel Library.

signal-math.ecf is a multi-mode command-line application with 2 client modes and 2 server-test modes.

signal-math-server.ecf performs the same calculations as the server mode of demo 1 but is multi-threaded and has a graphical user interface to control the thread logging context visible in terminal console.

Directory: library/network/eros

. /server/thread-communication

client

EROS_CALL_REQUEST_HANDLER_PROXY

Remote routine call request handler proxy

Further Information

Click on class link to see client examples.

EROS_CLIENT_CONNECTION

Eros client connection

Further Information

Click on class link to see client examples.

EROS_MAKEABLE_RESULT

Eros makeable result

Further Information

Click on class link to see client examples.

EROS_PROXY

Base class for objects that function as network-client proxies for objects hosted on server

Further Information

Click on class link to see client examples.

EROS_REMOTE_REQUEST

Format EROS request something like:

<?xml version="1.0" encoding="ISO-8859-1"?>
<?create $generator?>
<vector-complex>
   <row..
</vector-complex>
<?call {MY_CLASS}.my_routine (1, {COLUMN_VECTOR_COMPLEX_64}, 0.1, 2.3e-15, 'hello')?>

<?call{MY_CLASS}.my_routine?>

Note: COLUMN_VECTOR_COMPLEX_64 is an example of a place holder for an instance of a class deserialized from XML

Further Information

Click on class link to see notes.

EROS_RESULT

Remote result from call to remote EROS function

common/buildables

EROS_DEFAULT_RESULT

Eros default result

EROS_ERROR_RESULT

Eros error result

EROS_PROCEDURE_STATUS

Procedure execution acknowlegement

EROS_STRING_RESULT

Eros string result

EROS_XML_RESULT

Eros XML result

Further Information

Click on class link to see client examples.

common/object

EROS_OBJECT

Object with routines remotely callable via EROS protcol

EROS_REMOTELY_ACCESSIBLE

Object that is remotely accessible via EROS protocol

Further Information

Click on class link to see client examples.

Further Information

Click on class link to see notes and client examples.

EROS_CALL_REQUEST_HANDLER_I

Remote routine call request handler i

EROS_CALL_REQUEST_PARSER

Parse call expression like for example:

{MY_CLASS}.my_routine (1, {COLUMN_VECTOR_COMPLEX_64}, 0.1, 2.3e-15, 'hello')

{MY_CLASS}.my_routine

Note: COLUMN_VECTOR_COMPLEX_64 is an example of a place holder for an instance of a class deserialized from XML

Click on class link to see client examples.

EROS_SERVER_COMMAND

Eros server command for serializeable list of TYPES conforming to EROS_REMOTELY_ACCESSIBLE

Further Information

Click on class link to see client examples.

EROS_CALL_REQUEST_DELEGATING_CONSUMER_THREAD

Remote call request delegating consumer thread

Further Information

Click on class link to see client examples.

EROS_CALL_REQUEST_HANDLING_THREAD

Remote routine call request handling thread

Further Information

Click on class link to see client examples.