aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/ivy-java.17
-rw-r--r--doc/ivy-java.sgml37
2 files changed, 34 insertions, 10 deletions
diff --git a/doc/ivy-java.1 b/doc/ivy-java.1
index c519238..5887da2 100644
--- a/doc/ivy-java.1
+++ b/doc/ivy-java.1
@@ -75,7 +75,7 @@ java \-DIVYBUS=127.0.0.1:3042,10.192.36:2021,228.5.6.7:54321 fr.dgac.ivy.Probe '
java fr.dgac.ivy.Probe \-b 10.192.36:2021 '^coucou (.*)'
.SH "NEEDED LIBRARIES"
-.I jdk 1.1, 1.2, 1.3 or 1.4
+.I jdk from 1.1 to 1.4
.nf
.I libgnu\-regexp\-java version 1.1.3
.nf
@@ -84,7 +84,7 @@ java fr.dgac.ivy.Probe \-b 10.192.36:2021 '^coucou (.*)'
.I If you want to run the TestIvySwing example with a 1.1 VM, you will need a swing jar
.SH "BUGS"
-So far, there are problems with old java VMs ( 1.1.7A )
+See the BUGS files for details.
.SH "AUTHORS"
.nf
@@ -105,4 +105,5 @@ For further details, please refer to the Ivy html page at http://www.tls.cena.fr
.SH "NOTES"
In case of any comment or bug report on this library, please contact jestin@cena.fr
.nf
-Special thanks to Michelle Jacomi (jacomi@cena.fr) for her kind support
+Special thanks to Michelle Jacomi for her kind support and
+documentation writing.
diff --git a/doc/ivy-java.sgml b/doc/ivy-java.sgml
index 310a733..5408851 100644
--- a/doc/ivy-java.sgml
+++ b/doc/ivy-java.sgml
@@ -75,7 +75,8 @@ library. There is also a section dedicated to this port.
<sect1><title>What is Ivy?</title>
<para>
-Ivy is a software bus designed at <ulink url="http://www.cena.fr/">CENA</ulink> (France). A software bus is a system
+Ivy is a software bus designed at <ulink url="http://www.cena.fr/">CENA</ulink> (France).
+A software bus is a system
that allows software applications to exchange information with the illusion of
broadcasting that information, selection being performed by the receiving
applications. Using a software bus is very similar to dealing with events in a
@@ -108,12 +109,12 @@ The Ivy java library (aka ivy-java or fr.dgac.ivy) is a java package that
allows you to connect applications to an Ivy bus. You can use it to write
applications in java. You can also use it to integrate any thread-safe java
application. So far, this library has been tested and used on a variety of
-java virtual machines (from 1.1.8 to 1.4.0), and on a variety of architectures
+java virtual machines (from 1.1.7 to 1.4.1), and on a variety of architectures
(GNU/Linux, Solaris, Windows NT,XP,2000, MacOSX).
</para>
<para>
-The Ivy C library was originally developed by François-Régis Colin and then
+The Ivy java library was originally developed by François-Régis Colin and then
by Yannick Jestin at CENA. It is maintained by a group at CENA (Toulouse, France)
</para>
</sect2>
@@ -153,7 +154,8 @@ machine to the jar file.
<sect1><title>Your first Ivy application</title>
<para>
-We are going to write a "Hello world translater" for an Ivy bus. The application will subscribe to all messages starting with "Hello", and re-emit them after
+We are going to write a "Hello world translater" for an Ivy bus. The application will
+subscribe to all messages starting with "Hello", and re-emit them after
translating "Hello" into "Bonjour". In addition, the application will quit when
it receives any message containing exactly "Bye".
</para>
@@ -380,6 +382,10 @@ with this name to leave the bus
.bye (or .quit) forces the JPROBE application to exit. This is the same as issing an end of file character on a single input line ( ^D ).
</para></listitem>
<listitem><para>
+.direct client id message sends the direct message to the remote client, using
+the numeric id
+</para></listitem>
+<listitem><para>
.list gives the list of clients seen on the ivy bus
</para></listitem>
<listitem><para>
@@ -391,15 +397,32 @@ check the connectivity.
</para>
</sect2>
+<sect2><title>fr.dgac.ivy.IvyDaemon utility</title>
+<para>
+As the launching and quitting of an ivy bus is a bit slow, it is not
+convenient to spawn an Ivy client each time we want to send a simple message.
+To do so, we can use the IvyDaemon, which is a TCP daemon sitting and waiting
+on the port 3456, and also connected on the default bus. Each time a remote
+application connects to this port, every line read until EOF will be forwarded
+on the bus. The standard port and bus domain can be overriden by command line
+switches. ( java fr.dgac.ivy.IvyDaemon -h ).
+</para>
+
+<para>First, spawn an ivy Damon: $ java fr.dgac.ivy.IvyDaemon</para>
+<para>then, within your shell scripts, use a short tcp connexion ( for instance
+netcat ) : $ echo "hello world" | nc -q 0 localhost 3456
+</para>
+<para>The message will be sent on the default Ivy Bus.</para>
+</sect2>
+
<sect2><title>Direct messages</title>
<para>
Direct messages is an ivy feature allowing the exchange of information between
two ivy clients. It overrides the subscription mechanism, making the exchange
faster ( there is no regexp matching, etc ). However, this features breaks the
software bus metaphor, and should be replaced with the relevant bounded
-regexps, at the cost of a small CPU overhead. So far, the sending of direct
-message is not available from java, but the receiving is available in the
-fr.dgac.Ivy class.
+regexps, at the cost of a small CPU overhead. The full direct message
+mechanism in java has been made available since the ivy-java-1.2.3.
</para>
</sect2>