1 | README for the the NZDL Greenstone Java client
|
---|
2 |
|
---|
3 | This code is released under the Gnu Public Licence, as described in the
|
---|
4 | file GPL or on the web site http://www.gnu.org/
|
---|
5 |
|
---|
6 |
|
---|
7 | The main authors of this code are:
|
---|
8 | At the University of Waikato NZDL group http://www.nzdl.org:
|
---|
9 | David Bainbridge <[email protected]>
|
---|
10 | Dave Nichols <[email protected]>,
|
---|
11 | Brett Sheeran <[email protected]> (bas6 in the cvs log)
|
---|
12 | Stuart Yeates <[email protected]>
|
---|
13 |
|
---|
14 | Formerly with the NZDL group:
|
---|
15 | Aziz Mahoui <[email protected]>
|
---|
16 | Gordon W. Paynter <[email protected]>
|
---|
17 |
|
---|
18 | Collaborators:
|
---|
19 | George Buchanan <[email protected]>
|
---|
20 |
|
---|
21 | ************
|
---|
22 |
|
---|
23 | The NZDL Java-Client interface is a package for writing java applications to
|
---|
24 | communicate with the Greenstone Digital Library.
|
---|
25 |
|
---|
26 | The interface is through Common Object Reference Broker Architecture (CORBA).
|
---|
27 | In order to communicate to Greenstone collections, this software requires that
|
---|
28 | the server machine has Corbaserver installed and running.
|
---|
29 |
|
---|
30 | ************
|
---|
31 |
|
---|
32 | 1. Introduction
|
---|
33 |
|
---|
34 | It is now possible to access Greenstone collections using the Corba
|
---|
35 | protocol and a Java client.
|
---|
36 |
|
---|
37 | **
|
---|
38 |
|
---|
39 | As a Java programmer it is not necessary to understand Corba at all -
|
---|
40 | as the Corba complexity has been reduced to a series of Java objects,
|
---|
41 | methods and interfaces.
|
---|
42 |
|
---|
43 | **
|
---|
44 |
|
---|
45 | To demonstrate how to use the Nzdl classes we have created an
|
---|
46 | application, SimpleGraphicalClient, which can query a Corba server
|
---|
47 | and display the resulting documents. This client is probably a
|
---|
48 | good starting point to using Java with the NZDL.
|
---|
49 |
|
---|
50 |
|
---|
51 | 2. Getting the code
|
---|
52 |
|
---|
53 |
|
---|
54 | 2.1 Getting the SimpleGraphicalClient application source code
|
---|
55 |
|
---|
56 | cvs -d :pserver:[email protected]:2402/usr/local/global-cvs/gsdl-src checkout java-client
|
---|
57 | cd java-client
|
---|
58 | make
|
---|
59 |
|
---|
60 | 2.2 Getting the Server
|
---|
61 |
|
---|
62 | cvs :pserver:[email protected]:2402/usr/local/global-cvs/gsdl-src checkout gsdl
|
---|
63 | cd gsdl
|
---|
64 | ./configure --enable-corba
|
---|
65 | make
|
---|
66 | make install
|
---|
67 |
|
---|
68 | (anything else??)
|
---|
69 |
|
---|
70 | 3. Running the client
|
---|
71 |
|
---|
72 | It is important to get the directories correct - as Java
|
---|
73 | uses them to manage the namespace of the classes. So you
|
---|
74 | should have something that looks like:
|
---|
75 |
|
---|
76 | java-client/org/nzdl/gsdl/
|
---|
77 |
|
---|
78 | In this directory you will find:
|
---|
79 |
|
---|
80 | corba - directory, lots of nasty corba stuff, avoid
|
---|
81 | service - the java classes you use, no need to look at this
|
---|
82 | SimpleClient.java - early test application
|
---|
83 | SimpleGraphicalClient - directory, the Java package
|
---|
84 |
|
---|
85 | Run:
|
---|
86 | java org.nzdl.gsdl.SimpleGraphicalClient.SimpleGraphicalClient
|
---|
87 |
|
---|
88 |
|
---|
89 | 4. Running the server
|
---|
90 |
|
---|
91 | corbaserver -ORBNoCodeSets
|
---|
92 |
|
---|