[doc] 3.15 services api description
authorSylvain Thénault <sylvain.thenault@logilab.fr>
Wed, 11 Apr 2012 16:47:30 +0200
changeset 8368 062c9c7fe502
parent 8367 fc59d2380c48
child 8369 e538ad6f9b99
[doc] 3.15 services api description
doc/3.15.rst
--- a/doc/3.15.rst	Wed Apr 11 14:36:19 2012 +0200
+++ b/doc/3.15.rst	Wed Apr 11 16:47:30 2012 +0200
@@ -71,8 +71,12 @@
 
 * New 'zmqrql' source type, similar to 'pyrorql' but using ømq instead of Pyro.
 
-* A new call_service api is available through on `_cw` attribute of
-  appobjects. It can be used to
+* A new registry called 'services' has appeared, where you can register
+  server-side `cubicweb.server.Service` child classes. Their `call` method can be
+  invoked from a web-side AppObject instance using new `self._cw.call_service`
+  method or a server-side one using `self.session.call_service`. This is a new
+  way to call server-side methods, much cleaner than monkey patching the
+  Repository class, which becomes a deprecated way to perform similar tasks.
 
 * a new `ajaxfunction` registry now hosts all remote functions (i.e. functions
   callable through the `asyncRemoteExec` JS api). A convenience `ajaxfunc`