[ ]

RIO

RIO is a http-based protocol I recently designed. It is short for "remote interface for objects" and is meant as a light-weight, ASCII based RPC protocol which can encode/decode several atomic datatypes (boolean, integer, long, float, double, time, string) as well as complex datatypes like hashtables, arrays and classes. I'm currently writing a tiny test-server in tkscript (not entirely finished, arrays args are not yet implemented) which I placed under the terms of the BSD license. Please notice that SDL_net uses blocking socket-writes by default but I guess this does not matter for a test-server :-) The more formal specs can be found here. Examples:
- Start the server
- Query available namespaces: http://127.0.0.1:8080//rio%20namespaces
  The service should return
```
return as 4 "PersonDAO" "RoleDAO" "rio" "TestDAO"
```
- Query procedures for namespace "rio": http://127.0.0.1:8080//rio%20procedures%201%20name%20rio
  The service should return
```
return ap 2 namespaces 0 : as procedures 1 name s : s
```
- Query procedures for namespace "TestDAO": http://127.0.0.1:8080//rio%20procedures%201%20name%20TestDAO
  The service should return
```
return ap 10 create 2 key s value s : TestVO find 1 key s : TestVO echoBooleanArray 1 array ab : ab echoIntArray 1 array ai : ai echoLongArray 1 array al : al echoFloatArray 1 array af : af echoDoubleArray 1 array ad : ad echoStringArray 1 array as : as echoClassArray 1 array aTestVO : aTestVO echoHashArray 1 array ah : ah
```
- Query procedures for namespace "RoleDAO": http://127.0.0.1:8080//rio%20procedures%201%20name%20RoleDAO
  The service should return
```
return ap 2 findById 1 id l : RoleVO findByName 1 name s : RoleVO
```
- Query procedures for namespace "PersonDAO": http://127.0.0.1:8080//rio%20procedures%201%20name%20PersonDAO
  The service should return
```
return ap 7 findById 1 id l : aPersonVO  findByName 1 name s : aPersonVO  create 1 person PersonVO : PersonVO  remove 1 person PersonVO : b  find 1 person PersonVO : aPersonVO  findBySurname 1 surname s : aPersonVO  findByMinMaxBirthdate 2 min t max t : aPersonVO
```
- Call the PersonDAO.create procedure: http://127.0.0.1:8080//PersonDAO%20create%201%20person%20(PersonVO%202%20forename%20Foo%20surname%20Bar
  The service should return
```
return (PersonVO 7 forename s "Foo" role_id l 1 surname s "Bar" birthdate t 2005-08-25-17-52-04-781250000 id l 1 role (RoleVO 3 granted_procedures as 0 id l 1 name s "User" name s "Foo Bar"
```
- Call the TestDAO.echoBooleanArray procedure: http://127.0.0.1:8080//TestDAO%20echoBooleanArray%201%20array%20ab%208%201%201%200%201%200%200%200%201
  The service should return
```
return ab 8 1 1 0 1 0 0 0 1
```
- Call the TestDAO.echoIntArray procedure: http://127.0.0.1:8080//TestDAO%20echoIntArray%201%20array%20ai%205%20-2%20-1%200%201%202
  The service should return
```
return ai 5 -2 -1 0 1 2
```
- Call the TestDAO.echoLongArray procedure: http://127.0.0.1:8080//TestDAO%20echoLongArray%201%20array%20al%203%20-9223372036854775807%2023%209223372036854775807
  The service should return
```
return al 3 -9223372036854775807 23 9223372036854775807
```
- Call the TestDAO.echoFloatArray procedure: http://127.0.0.1:8080//TestDAO%20echoFloatArray%201%20array%20af%205%20-2.2%20-1.1%200.123%201.12%202.23
  The service should return
```
return af 5 -2.200000 -1.100000 0.123000 1.120000 2.230000
```
- Call the TestDAO.echoDoubleArray procedure: http://127.0.0.1:8080//TestDAO%20echoDoubleArray%201%20array%20ad%203%20-1.000000123%200.123456789%201.000000123
  The service should return
```
return ad 3 -1.000000123 0.123456789 1.000000123
```
- Call the TestDAO.echoStringArray procedure: http://127.0.0.1:8080//TestDAO%20echoStringArray%201%20array%20as%207%20%22o%20n%20e%22%20two%20three%20four%20%22hello,%20world.%22%20':%5E%5D'%20'a%20%5C%22b%20c%5C%22%20d'
  The service should return
```
return as 7 "o n e" "two" "three" "four" "hello, world." ":^]" "a \"b c\" d"
```
- Call the TestDAO.echoClassArray procedure: http://127.0.0.1:8080//TestDAO%20echoClassArray%201%20array%20aTestVO%203%202%20key%20Foo1%20value%20Bar1%202%20key%20Foo2%20value%20Bar2%202%20key%20Foo3%20value%20Bar3
  The service should return
```
return aTestVO 3 2 key s "Foo1" value s "Bar1" 2 key s "Foo2" value s "Bar2" 2 key s "Foo3" value s "Bar3"
```
- Call the TestDAO.echoHashArray procedure: http://127.0.0.1:8080//TestDAO%20echoHashArray%201%20array%20ah%203%202%20Key1_1%20Value1_1%20Key1_2%20Value1_2%202%20Key2_1%20Value2_1%20Key2_2%20Value2_2%202%20Key3_1%20Value3_1%20Key3_2%20Value3_2
  The service should return
```
return ah 3 2 Key1_1 s "Value1_1" Key1_2 s "Value1_2" 2 Key2_1 s "Value2_1" Key2_2 s "Value2_2" 2 Key3_1 s "Value3_1" Key3_2 s "Value3_2"
```
- See the service.tks specific implementation source