summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorLoïc Collignon <loic.collignon@iot.bzh>2018-02-08 11:06:33 +0100
committerLoïc Collignon <loic.collignon@iot.bzh>2018-02-08 11:06:33 +0100
commit520aa79ae3b967cb4ef366f92266b53b78c2f1c9 (patch)
tree2893ff72dc2154adbe36ec74194fed1b14991ecc /README.md
parentb838d49bd4cfc6b085f2a5ff3343806cb5c74b13 (diff)
moved files to root folder.
Change-Id: I7103241843736e1a5747253781485afa457a64d0 Signed-off-by: Loïc Collignon <loic.collignon@iot.bzh>
Diffstat (limited to 'README.md')
-rw-r--r--README.md38
1 files changed, 37 insertions, 1 deletions
diff --git a/README.md b/README.md
index 1d1a1e8..fb420dc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# agl-service-data-persistence
+# Database Binding
+This binding provide a database API with key/value semantics.
+The backend is currently a Berkeley DB.
+
+## Verbs
+* **insert**:
+ This verb insert a key/value pair in the database.
+ If the key already exist, the verb fails.
+
+* **update**:
+ This verb update an existing record.
+ If the key doesn't exist, the verb fails.
+
+* **delete**:
+ This verb remove an existing key/value pair from the database.
+ If no matching record is found, the verb fails.
+
+* **read**:
+ This verb get the value associated with the specified key.
+ If no matching record is found, the verb fails.
+
+## Arguments
+* The **read** and **delete** verbs need only a **key** to work:
+```
+{
+ "key": "mykey"
+}
+```
+
+* The **insert** and **update** verbs need a **key** and a **value** to work:
+```
+{
+ "key": "mykey",
+ "value": "my value"
+}
+```
+The **value** can be any valid json.