X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=979d35e83d06cf6e2f3561355240cd95a2cda106;hb=refs%2Ftags%2Fneedlefish%2F13.93.0;hp=ac0e94a7012df3214af04a7da8bff948108e50c0;hpb=1825c92b6971074dfb1efb5961e4e85c54edd9e2;p=apps%2Fagl-service-data-persistence.git diff --git a/README.md b/README.md index ac0e94a..979d35e 100644 --- a/README.md +++ b/README.md @@ -1 +1,52 @@ -# agl-identity \ No newline at end of file + +# 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: + +```code +{ + "key": "mykey" +} +``` + +* The **insert** and **update** verbs need a **key** and a **value** to work: + +```code +{ + "key": "mykey", + "value": "my value" +} +``` + +The **value** can be any valid json. + +## Dependencies + +You must install BerkeleyDB and GDBM \ No newline at end of file