home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 July / CMCD0704.ISO / Software / Shareware / Comunicatii / CrushFTP / CrushFTP.jar / README.txt < prev    next >
Text File  |  2004-05-23  |  4KB  |  123 lines
  1. // Copyright (C) 2002  Strangeberry Inc.
  2. // @(#)README.txt, 1.5, 02/05/2003
  3. //
  4. // This library is free software; you can redistribute it and/or
  5. // modify it under the terms of the GNU Lesser General Public
  6. // License as published by the Free Software Foundation; either
  7. // version 2.1 of the License, or (at your option) any later version.
  8. // 
  9. // This library is distributed in the hope that it will be useful,
  10. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12. // Lesser General Public License for more details.
  13. // 
  14. // You should have received a copy of the GNU Lesser General Public
  15. // License along with this library; if not, write to the Free Software
  16. // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  17.  
  18. Arthur van Hoff
  19. avh@strangeberry.com
  20.  
  21. ** JRendezvous
  22.  
  23. This is an implemenation of Rendezvous in Java. It currently
  24. supports service discovery and service registration. 
  25.  
  26.  
  27.  
  28. ** Requirements
  29.  
  30. JRendezvous has been tested only on Windows using the JDK 1.3.1
  31. and JDK 1.4.0. It has also been tried on Mac OS/10 using JDK1.3.1.
  32.  
  33.  
  34.  
  35. ** Running JRendezvous from the Command Line
  36.  
  37. GUI browser:
  38.  
  39.   java -jar jrendezvous.jar -browse
  40.  
  41. TTY browser for a particular service type:
  42.  
  43.   java -jar jrendezvous.jar -bs _http._tcp local.
  44.  
  45. Register a service:
  46.  
  47.   java -jar jrendezvous.jar -rs foobar _http._tcp local. 1234 index.html
  48.  
  49. To print debugging output specify -d as the first argument.  
  50.  
  51.  
  52.  
  53. ** Sample Code for Service Registration
  54.  
  55.     import com.strangeberry.rendezvous.*;
  56.  
  57.     Rendezvous rendezvous = new Rendezvous();
  58.     rendezvous.registerService(
  59.         new ServiceInfo("_http._tcp.local.", "foo._http._tcp.local.", 1234, "index.html")
  60.     );
  61.  
  62.  
  63. ** Sample code for Serivice Discovery
  64.  
  65.     import com.strangeberry.rendezvous.*;
  66.  
  67.     static class SampleListener implements ServiceListener
  68.     {
  69.     public void addService(Rendezvous rendezvous, String type, String name)
  70.     {
  71.         System.out.println("ADD: " + rendezvous.getServiceInfo(type, name));
  72.     }
  73.     public void removeService(Rendezvous rendezvous, String type, String name)
  74.     {
  75.         System.out.println("REMOVE: " + name);
  76.     }
  77.     }
  78.  
  79.     Rendezvous rendezvous = new Rendezvous();
  80.     rendezvous.addServiceListener("_http._tcp.local.", new SampleListener());
  81.  
  82.  
  83.  
  84. ** Changes since 9-10-2002
  85.  
  86. - Rendezvous.SocketListener: check done flag to avoid exception on close.
  87.  
  88. - Main: no arguments lauches the browser. Now you can double click on
  89.   the jar file
  90.  
  91. - Switch from GPL to LGPL. Now you can use JRendezvous in your
  92.   products without having to put them in the public domain.
  93.  
  94.  
  95.  
  96. ** Changes since 29-11-2002
  97.  
  98. - Handle unicast DNS queries. This is required to integrated with
  99.   legacy DNS clients. You can now advertize services that can be
  100.   launched from the Safari browser on the Mac.
  101.  
  102. - Make domain names case insensitive in all cases. Mixed case is
  103.   still allowed and preseved, but it is now ignored in queries.
  104.  
  105.  
  106.   
  107. ** Changes since 20-01-2003
  108.  
  109. - Fixed a bug introduced in the 20-01-2003, the query handler
  110.   was responding with unicast reponses to multicast queries.
  111.   This turned out to work fine when JRendezvous is talking to
  112.   another JRendezvous, but it fails when talking to other
  113.   rendezvous implementations.
  114.  
  115. - Fixed case sensitivity issue when removing services. This caused
  116.   multiple calls to ServiceListener.removeService.
  117.  
  118. - Increased the TTL from 1 minute to 1 hour.
  119.  
  120. - Started proper version numbers. The next release will be 0.1.1.
  121.  
  122.  
  123.