greenstone.org greenstone wiki greenstone trac planet greenstone

Changeset 9905

Show
Ignore:
Timestamp:
2005-05-18 14:51:39 (4 years ago)
Author:
kjdon
Message:

updated the README with some stuff from a tutorial file that Dave had on his computer

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/java-client/README

    r2157 r9905  
    88At the University of Waikato NZDL group http://www.nzdl.org: 
    99   David Bainbridge <davidb@cs.waikato.ac.nz> 
    10    Dave Nichols <daven@cs.waikato.ac.nz>, 
     10   Dave Nichols <dmn@cs.waikato.ac.nz>, 
    1111   Brett Sheeran <bsheeran@xtra.co.nz> (bas6 in the cvs log) 
    1212   Stuart Yeates <s.yeates@cs.waikato.ac.nz> 
    …… 
    1414Formerly with the NZDL group: 
    1515   Aziz Mahoui <amahoui@yahoo.com> 
    16    Gordon W. Paynter <paynter@cs.waikato.ac.nz>         
     16   Gordon W. Paynter <paynter@library.ucr.edu> 
    1717 
    1818Collaborators: 
    19    George Buchanan <g.buchanan@mdx.ac.uk> 
     19   George Buchanan <g.buchanan@cs.ucl.ac.uk> 
     20 
     21************ 
     22 
     23The NZDL Java-Client interface is a package for writing java applications to  
     24communicate with the Greenstone Digital Library. 
     25 
     26The interface is through Common Object Reference Broker Architecture (CORBA). 
     27In order to communicate to Greenstone collections, this software requires that  
     28the server machine has Corbaserver installed and running. 
     29 
     30************ 
     31 
     321. Introduction 
     33 
     34It is now possible to access Greenstone collections using the Corba  
     35protocol and a Java client. 
     36 
     37** 
     38 
     39As a Java programmer it is not necessary to understand Corba at all -  
     40as the Corba complexity has been reduced to a series of Java objects,  
     41methods and interfaces. 
     42 
     43** 
     44 
     45To demonstrate how to use the Nzdl classes we have created an  
     46application, SimpleGraphicalClient, which can query a Corba server  
     47and display the resulting documents. This client is probably a  
     48good starting point to using Java with the NZDL. 
     49 
     50 
     512. Getting the code 
     52 
     53 
     542.1 Getting the SimpleGraphicalClient application source code 
     55 
     56cvs -d :pserver:cvs_anon@cvs.scms.waikato.ac.nz:2402/usr/local/global-cvs/gsdl-src checkout java-client 
     57cd java-client 
     58make 
     59 
     602.2 Getting the Server 
     61 
     62cvs :pserver:cvs_anon@cvs.scms.waikato.ac.nz:2402/usr/local/global-cvs/gsdl-src checkout gsdl 
     63cd gsdl 
     64./configure --enable-corba 
     65make 
     66make install 
     67 
     68(anything else??) 
     69 
     703. Running the client 
     71 
     72It is important to get the directories correct - as Java  
     73uses them to manage the namespace of the classes. So you  
     74should have something that looks like: 
     75 
     76java-client/org/nzdl/gsdl/ 
     77 
     78In this directory you will find: 
     79 
     80corba - directory, lots of nasty corba stuff, avoid 
     81service - the java classes you use, no need to look at this 
     82SimpleClient.java - early test application 
     83SimpleGraphicalClient - directory, the Java package 
     84 
     85Run: 
     86java org.nzdl.gsdl.SimpleGraphicalClient.SimpleGraphicalClient 
     87 
     88 
     894. Running the server 
     90 
     91corbaserver -ORBNoCodeSets 
     92