Compiled with:

  java version "1.4.2_01"
  Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_01-b06)
  Java HotSpot(TM) Client VM (build 1.4.2_01-b06, mixed mode)



Command line usage:

  Classpath must include Jena2, and files ontogator.owl, bookmark.rdf and vbsearch.conf.
  Usage: java -cp <classpath> vbsearch.VBSearch --input <file name> --query <file name> [options]
  Options:
      --input          projection file (categories and bookmarks).
      --inputLang      language of input (default: RDF/XML).
      --query          name of the file containing the query.
      --queryLang      language of query (default: RDF/XML).
      --output         file name to store the results. If not
                       provided stdout is used.
      --repeat         number of repetitions.

  Note: you may need to adjust stack size using Java VM -option -XX:ThreadStackSize 
        and memory heap size using option -mx (see singleQuery.sh for examples).



Test:
  
  singleQuery.sh

    Uses options: 
       --input  doc/inputExample.rdf (RDF/XML)
       --query  doc/singleQuery.rdf (RDF/XML)
       --output doc/singleQueryResults.rdf
       --repeat 5

  queryExample.sh

    Uses options:
       --input  doc/inputExample.rdf (RDF/XML)
       --query  doc/queryExample.rdf (RDF/XML)
       --output doc/queryExampleResults.rdf
       --repeat 5



Examples:

  doc/inputExample.rdf 

    Relatively small (239 bookmarks) and old input example for testing.  

  doc/singleQuery.rdf

    Single query.

  doc/queryExample.rdf

    Series of queries. 

  For output examples run test-scripts (queryExample.sh or singleQuery.sh).



API:

  Main class: vbsearch.VBSearch (see main-method for usage example). 



Compiling:

  Requires Ant (http://ant.apache.org/)

  ant 

  distribution package (jar) with "ant dist" and clean up with "ant clean"



Jar:

  dist/vbsearch-20040319.jar



Classes:

  build/classes 



Vocabularies:

  conf/ontogator.owl 

    Projection (input/output) and query ontologies.

  conf/bookmark.owl

    Top vocabulary for projections.


 
Configuration:

  conf/vbsearch.conf

    Do not touch XML Namespaces (uri.xmlns.*)!

    You can refer to other keys in the same file usin ${<key>}-syntax.

    uri.base 

      default base uri for (any) input.

    literalBookmarkIndexProperties

       is an ARRAY_DELIM separated list of property URI's to be indexed 
       for bookmarkKeyword -search.

    literalCategoryIndexProperties

       is an ARRAY_DELIM separated list of property URI's to be indexed 
       for categoryKeyword -search.

    ARRAY_DELIM

       a string used as delimiter for list entities (default: |).
       For syntax, please refer to the java.util.StringTokenizer -API.