X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=doc%2Fafb-daemon-vocabulary.html;h=5a585c23c65e27c62254bfbbbcae5d6ed02762d4;hb=d00d1b7ce817aa3fefed9ee59d0904af561bb66c;hp=096f5076f54a8213049f07b247e239e212e502c8;hpb=b81bab801d1a39cce7254b0c056d991412ec4331;p=src%2Fapp-framework-binder.git diff --git a/doc/afb-daemon-vocabulary.html b/doc/afb-daemon-vocabulary.html index 096f5076..5a585c23 100644 --- a/doc/afb-daemon-vocabulary.html +++ b/doc/afb-daemon-vocabulary.html @@ -1,131 +1,79 @@ +
- - + + + + +version: 1
-Date: 26 mai 2016
-Author: José Bollo
-
-
-Message with data propagated from the services to the client and not expecting -any reply.
- +A shared library object intended to be add a functionnality to an afb-daemon instance. It implements an API. It may provide a service.
+Binding made for services can have specific entry point called after initialisation and before serving.
+Message with data propagated from the services to the client and not expecting any reply.
The current implementation allows to widely broadcast events to all clients.
- - -This level that can be from 0 to 3 represent the level of -assurance that the services can expect from the session.
- -The exact definition of the meaning of this levels and of -how to use it remains to be achived.
- - -A shared library object intended to be plug to an afb-daemon instance -to implement an API.
- - -A request is an invocation by a client to a method of a plugin using a message -transfered through some protocol: HTTP, WebSocket, DBUS… served by afb-daemon
- - -This level that can be from 0 to 3 represent the level of assurance that the services can expect from the session.
+The exact definition of the meaning of this levels and of how to use it remains to be achived.
+Old name for binding, see binding.
+A request is an invocation by a client to a method of a binding using a message transfered through some protocol: HTTP, WebSocket, DBUS... served by afb-daemon
+This is a message sent to client as the result of the request.
- - -Service are made of plugins runnning by their side on their binder. -It can serve many client. Each one being attached to one session.
- -The framework establishes the connection between the services and -the clients. Using DBus currently.
- - -A session is meant to be the unic context of an instance of client, -identifying that instance across requests.
- +Service are made of binding runnning by their side on their binder. It can serve many client. Each one being attached to one session.
+The framework establishes the connection between the services and the clients. Using DBus currently but other protocols are considered.
+A session is meant to be the unic context of an instance of client, identifying that instance across requests.
Each session has an identifier. Session identifier generated by afb-daemon are UUIDs.
- -Internally, afb-daemon offers a mechanism to attach data to sessions. -When the session is closed or disappears, the data attached to that session -are freed.
- - -Internally, afb-daemon offers a mechanism to attach data to sessions. When the session is closed or disappears, the data attached to that session are freed.
+The token is an identifier that the the client must give to be authentificated.
- -At start, afb-daemon get an initial token. This initial token must be presented -incoming client to be authentificated.
- +At start, afb-daemon get an initial token. This initial token must be presented incoming client to be authentificated.
A token is valid only for a period.
- -The token must be renewed periodically. When the token is renewed, afb-daemon -sends the new token to the client.
- +The token must be renewed periodically. When the token is renewed, afb-daemon sends the new token to the client.
Tokens generated by afb-daemon are UUIDs.
- - -It stand for Universal Unic IDentifier.
- -Its is designed to create identifier in a way that avoid has much as possible conflicts. -It means that if two differents instance create a UUID, the probability that they create the same UUID is very low, near to zero.
- - -Argument name that can be used with HTTP request. -When this argument is given, it is automatically added to the “request” object of the -answer.
- - -Argument name for giving the token without ambiguity. -You can also use the name token but it may conflicts with other arguments.
- - -Argument name for giving explicitely the session identifier without ambiguity. -You can also use the name uuid but it may conflicts with other arguments.
+Its is designed to create identifier in a way that avoid has much as possible conflicts. It means that if two differents instance create a UUID, the probability that they create the same UUID is very low, near to zero.
+Argument name that can be used with HTTP request. When this argument is given, it is automatically added to the "request" object of the answer.
+Argument name for giving the token without ambiguity. You can also use the name token but it may conflicts with other arguments.
+Argument name for giving explicitely the session identifier without ambiguity. You can also use the name uuid but it may conflicts with other arguments.