The Ivy Java library guide

CENA NT02-819

Yannick Jestin

Abstract

This document is a programmer's guide that describes how to use the Ivy Java library to connect applications to an Ivy bus. This guide describes version 1.2.12 of the library. This document itself is part of the Java package, available on the Ivy web site.


Table of Contents

Foreword
What is Ivy?
The Ivy Java library
What is it?
Getting and installing the Ivy Java library
Your first Ivy application
The code
Compiling it
Testing
Basic functions
Initialization an Ivy object and joining the bus
Emitting messages
Subscription to messages
Subscribing to application events
Advanced functions
Sending to self
Initializing a domain
Newline within messages
Sending direct messages
Ivy and swing GUI
Asynchronous Subscription to messages
Waiting for someone: waitForClient and waitForMsg
Subscribing to subscriptions
Monitoring the bus
Message classes
Utilities
jprobe
IvyDaemon
jafter
programmer's style guide
join the right bus
nice regular expressions
Something's not working
time consuming callbacks
how to perform requests
how to quit the application ?
Contacting the authors

Foreword

This document was written in SGML according to the DocBook DtD, so as to be able to generate PDF and html output. However, the authors have not yet mastered the intricacies of SGML, the DocBook DtD, the DocBook Stylesheets and the related tools, which have achieved the glorious feat of being far more complex than LaTeX and Microsoft Word combined together. This explains why this document, in addition to being incomplete, is quite ugly. We'll try and improve it.