[Zope3-checkins] CVS: Zope3/src/zope/app/registration - README.txt:1.2

Jim Fulton jim at zope.com
Sat Apr 17 07:14:01 EDT 2004


Update of /cvs-repository/Zope3/src/zope/app/registration
In directory cvs.zope.org:/tmp/cvs-serv30217

Modified Files:
	README.txt 
Log Message:
Quick update to relect package reorg.


=== Zope3/src/zope/app/registration/README.txt 1.1 => 1.2 ===
--- Zope3/src/zope/app/registration/README.txt:1.1	Sat Mar 13 14:26:12 2004
+++ Zope3/src/zope/app/registration/README.txt	Sat Apr 17 07:14:00 2004
@@ -1,43 +1,10 @@
-==============
-Local Services
-==============
+============
+Registration
+============
 
 :Author: Jim Fulton
 :Version: $Revision$
 
-This package includes implementations of several local services.
-It also contains infrastructure for implementing local services.
-
-Implementing local services is not too difficult, but there can be a
-lot of details that are hard to remember.
-
-A service is a component that implements a specific interface *and*
-that has the responsibility to collaborate with services above it.
-Local services are stored in the Zope object database, so they also
-need to be persistent.  Finally, many local services support modular
-registration through registration objects.
-
-A few words on the difference between local and global services:
-
-- Local services (usually) exist in the ZODB; global services don't.
-
-- Local services apply to a specific part of the object hierarchy;
-  global services (as their name suggests) don't.
-
-- Local services are (usually) created and configured through the ZMI;
-  global services are created and configured by ZCML directives.
-
-- Local services are expected to collaborate with services "above"
-  them in the object hierarchy, or with the global service; global
-  services by definition have nothing "above" them.
-
-  (Note that it's up to the service to decide what form the
-  collaboration will take.  An acceptable form of collaboration is to
-  not collaborate at all.
-
-Registration
-------------
-
 Many services act as component registries.  Their primary job is to
 allow components to be looked up based on parameters such as names,
 interfaces or both. Examples of component registries include the
@@ -163,21 +130,3 @@
   The interface ``IRegistered'' provides storage and access to the
   registrations for a registerable.  When we make a registration, we
   refer to it in a registration stack and in the registered object.
-
-
-Examples
---------
-
-Implementation of local services is described through examples.
-
-- The error reporting service is among the simplest examples because
-  error reporting services don't support registration and don't
-  delegate requests to services above.
-
-  See error.txt
-
-- The utility service is an example of a service that supports
-  local-object registration. It also provides a simple example of a
-  service that delegates to services above it.
-
-  See utility.txt.




More information about the Zope3-Checkins mailing list