Changeset 3983 for TI01-discovery


Ignore:
Timestamp:
03/06/08 15:28:32 (11 years ago)
Author:
cbyrom
Message:

Update system docs.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • TI01-discovery/branches/ws-Discovery2-upgrade/readme.txt

    r3958 r3983  
    22------------ 
    33 
     4Build Info/Set up 
     5-------------------- 
    46NB, completing the build here assumes you have both apache axis2 and ant installed.  The AXIS2_HOME environment variable 
    57should be set to point to the top level directory of the axis2 install.  If you are deploying locally to tomcat, you need 
     
    1416ant -f buildClient.xml deploy.client - build the service jar and deploy it to a local tomcat install 
    1517ant -f buildClient.xml deploy.client - build the service jar and deploy it to a local tomcat install + restart tomcat 
     18ant -f buildClient.xml generatestubs - generate both client and server side stubs - and generate the XBeans jar using the client-side stubs 
    1619ant -f buildClient.xml - defaults to building the service jar 
    1720 
     
    2326Eclipse set up 
    2427------------------- 
    25 To remove build errors in the code, ensure that the client build is ran, and eclipse is refreshed to pick the 
     28To remove build errors in the code, run the build with the 'generatestubs' target, and eclipse is refreshed to pick the 
    2629generated code.  Add all the jars in the resources dir to the build classpath and also add all the jars in the AXIS2_HOME/lib 
    2730dir. 
     
    2932Running tests 
    3033---------------- 
    31 There are a few JUnit tests that can be ran to check the basic integrity of the web service.  From these to be ran from inside 
    32 eclipse, you'll need to add the generated XBeans-packaged.jar (in build/lib) to the build path. 
     34There are JUnit tests that can be ran to check the basic integrity of the web services.  For these to be ran from inside 
     35eclipse, you'll need to add the generated XBeans-packaged.jar (in build/lib) to the build path.  The tests also assume that 
     36the files test_file.xml and test_file2.xml, in resources, have been ingested to the postgres DB as badc files (i.e. put them 
     37into the expected harvest directory (currently, /usr/local/jakarta-tomcat/webapps/oai/WEB-INF/harvested_records/badc-nerc-ac-uk-dif) 
     38and run oai_document_ingester.py badc 
     39 
     40Failing tests 
     41---------------- 
     42There are currently 3 tests that fail: 
     43 
     44i) validAuthorTermSearch 
     45- this fails currently since unsure where the author data should be set and retrieved from 
     46 
     47ii) nullDateStartRangeSearch 
     48- Generated code is a little ropey atm; if a start date is not defined, this date range is automatically 
     49not set - however if it is it will be - i.e. the end date is not consulted when setting up this object 
     50- this makes it currently impossible to recognise the case where a start date is null and the end date is set 
     51- NB, would be better to tighten up WSDL definition so that you can/cannot set things up wrongly 
     52 
     53iii) basicPresentDIFFormatCompare 
     54- This naively assumes the original format returned will equal the DIF format returned (since the original was in  
     55DIF format).  Clearly there are discrepancies introduced by the transform. 
    3356 
    3457Trouble Shooting 
     
    4770 
    4871when the webservice is deployed to tomcat. 
     72 
     73iii) Be very careful when playing around with the Setsrid sql calls - the following apostrophes must be ' and not ` - NB, eclipse 
     74may substitute these in which will cause problems which can be difficult to diagnose...  
     75 
     76To do 
     77------------ 
     78i) Currently the time searches use only the 'overlaps' function - i.e. the 'temporalOperator' element of the WS is unused.  This 
     79could be implemented to allow similar search types to the spatial operator - i.e. within, overlaps and no overlaps 
    4980 
    5081 
Note: See TracChangeset for help on using the changeset viewer.