A Jini Tutorial

Jan Newmarch

Version 0.03, 24 March 1999

1. Contents

  1. Overview
  2. Discovering a Lookup Service
  3. Entry Objects
  4. Service Registration
  5. Client Search
  6. Simple Example
  7. Security
  8. Remote Events (to come)
  9. etc (to come :-)

2. Files

The programs are available as a zip file programs.zip.

The documentation files are also available as a zip file docs.zip. You might not like what you get from this doc file - I am using XML as document format, using a mishmash of the DocBook DTD with extra tags and HTML thrown in. A Perl program, xml_handler.pl, is a handler called by my Apache Web server to deliver XML files as HTML. Another perl program, docbook2html.pl, will convert them standalone, but it will leave the hypertext links pointing to the XML files.

3. Update Information

 This tutorial will be updated on a regular basis, maybe several times a week. If you want to receive an email announcement of each version release, send email to jan@newmarch.name with subject ``Jini tutorial update''

4. Other Resources
  1. The Jini FAQ at http://www.artima.com/jini/faq.html
  2. Noel Enete's ``Nuggets'' tutorial at www.enete.com/download/#_nuggets_
  3. Eran Davidov's timeservice example at www.artima.com/jini/resources/timeservice.html
  4. Roger Whitney's lecture notes on ``Java Distributed Computing'' at http://www.eli.sdsu.edu/courses/spring99/cs696/notes/
  5. Jini Home page http://www.sun.com/jini/index.html
  6. RMI Home page http://java.sun.com/products/jdk/rmi/index.html

5. Changes

 See the file Changes for the list of version releases and changes made between versions.

6. Copyright Information

This tutorial (and the pages it contains) are covered by the OpenContent license. This basically gives you freedom to do what you want with the document in a similar way to the GNU license for software. Any changes or additions that you make to this set of pages as a Web document must be made publically available, and may be folded into later versions of this tutorial. Any such inclusions will of course be credited with your copyright, under the OpenContent license.

On the other hand, the programs that this tutorial references are also available unbundled from the tutorial, and do not have the restriction that source derived from them must be made publically available. So you can derive your own source code from them, without having to make it public. I'm not sure what suitable license will do this...

And, of course, there is no warranty...

7. Acknowledgements

The author is currently on a sabbatical program at the CRC for Distributed Systems Technology, http://www.dstc.edu.au and the work reported in this tutorial has been funded in part by the Co-operative Research Centre Program through the Department of Industry, Science and Tourism of the Commonwealth Government of Australia.

This file is Copyright ©Jan Newmarch (http://jan.newmarch.name) jan@newmarch.name

The copyright is the OpenContent License (http://www.opencontent.org/opl.shtml), which is the ``document'' version of the GNU OpenSource license.