Installation and Running

Unpacking

Unpack the archive. It contains the following files:
    install.html         - the page you are reading
    org/ginf/*           - GINF software
    org/w3c/rdf/*        - a modified version of SiRPAC
    com/microstar/xml/*  - AElfred XML parser
    SM/ginf/*            - examples
    doc/*                - javadoc generated documentation
Set your CLASSPATH environment variable to point to the distribution directory:
    setenv CLASSPATH /u/me/here_I_unpacked_it         (UNIX, tcsh)

Testing Parser/Serializer/Validator

Choose a valid RDF file and run parser/serializer against it:
    java SM.ginf.TestParser http://www.w3.org/1999/02/22-rdf-syntax-ns
This will fetch the RDF Model and Syntax schema, parse it, print it as triples, print it in an RDF serialization generated out of the internal model representation and validate it.
    java SM.ginf.TestParser http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-coll
This will fetch the above schema, fetch the schemas used by it (26-core-comm), parse, serialize, validate.
    java SM.ginf.TestParser <url or file of your choice>
(Just see what happens...)

Hello World

The interesting part: test the component communication. Standard "HelloWorld":
    Start server:
        java SM.ginf.HelloWorldServer
    You should see the following output:
        Registred schema http://www.w3.org/1999/02/22-rdf-syntax-ns of size 13
        Registred schema http://www.w3.org/TR/WD-rdf-schema of size 61
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-core-comm of size 29
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-core-state of size 11
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-http of size 10
    The above schemas are NOT fetched from the corresponding URLs, but are loaded from Java classes.

    Start client on the same machine (it tries to connect to localhost by default):
        java SM.ginf.HelloWorldClient
    You should see the following output:
        CONNECTING: http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-hello-world
        Registred schema http://www.w3.org/1999/02/22-rdf-syntax-ns of size 13
        Registred schema http://www.w3.org/TR/WD-rdf-schema of size 61
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-core-comm of size 29
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-hello-world of size 9
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-core-state of size 11
        Registred schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-http of size 10
        Hello world!
    Schema http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-hello-worldis fetched over the network. The server fetches and registeres this schema upon receiving the client request, too.

Schema Class Generator

HelloWorldServer2 and HelloWorldClient2 load the hello-world schema from the Java class HelloWorld.java. It can be generated using the following command:
    java org.ginf.javagen.Main
        -d /u/me/here_I_unpacked_it -schema
        -use file:/u/me/here_I_unpacked_it/SM/ginf/HelloWorldPackage.rdf
        http://www-diglib.stanford.edu/diglib/ginf/1999/05/26-hello-world
Run  java org.ginf.javagen.Main
to get help on the generator.

Simple Digital Library Server and Client

Start the server; the file doc-db.rdf contains a number of DublinCore bibliographic records:
java SM.diglib.Server file:/u/me/here_I_unpacked_it/doc-db.rdf
Run the client against it:
java SM.diglib.Client http://your.host/
Test your server instance: go to the Java client page and type in http://your.host into the field "Host".


GINF (c) 1999 by Sergey Melnik