company logo

Testing HTTP requests

ODABA provides a little test framework for testing OHTTP requests. Tests may be prepared in a test script containing any number of tests. The test script consists of any number of test blocks, where each test block has the following structure:

  • line 1: test header (fix text 'TEST:' followed by test title)
  • line 2: request type (GET, PUT, PATCH, POST, DELETE)
  • line 3: user name
  • line 4: password (in the example, user name and password must have same length)
  • line 5: URL without server:port (e.g. /Persons::Person/0/children )
  • line 6 and following (until end of file or next empty line or next test header): body

Empty lines or comment lines (beginning with //) between test blocks and block lines will be ignored.

In order to run the test script, a command line server or server daemon has to be started and an OSI scrip as shown below has to be called:

  • OShell.exe OShell.ini TestHTTP.osh

Since the function OHTTPExecute(testscript,server,port) for running the test script is implemented in ode.dev, the database has to be defined as RESOURCES database in the data source (here Sample).

While running the script, Test case head line, HTTP return code and result string are written to console.

// test block in Test.txt

TEST: Create instance with pid P1001

PUT

user

upwd

/Person::Persons/P1001

{ name:"Hops0", first_name: [ "Sala0", "Tralala0"], married: true, location: {zip: 1000, city: City1000, street: "Short Lane", number: 1000}, notes: "temporary notes", birth_date: "2000-10-31" }

// TestHTTP.osh (run with OShell)

cd Sample                         // open data source (see OShell.ini)

osi 'dictionary.loadOSILibraries' // load login function when not defined in .dev

osi begin

  Option("HTTP.timeout").assign("300"); // increase timeout

  OHTTPExecute("Test.txt","localhost","8888"); // run test script

end

// OShell.ini for running OShell

[SYSTEM]

DICTIONARY=ode.sys

[OShell]

DSC_Language=English

[OSI]

Library=./*.osi

[Sample]

DICTIONARY=Sample.dev

RESOURCES=ode.dev

DATABASE=Sample.dat

PLATFORM_INDEPENDENT=YES

SHARE=YES

ACCESS_MODE=Write

ONLINE_VERSION=YES