You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by rs...@apache.org on 2002/08/07 23:46:23 UTC
cvs commit: jakarta-commons/discovery project.xml PROPOSAL.html
rsitze 2002/08/07 14:46:23
Modified: discovery project.xml PROPOSAL.html
Log:
Update proposal summary & correct project.xml
Revision Changes Path
1.3 +2 -2 jakarta-commons/discovery/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/discovery/project.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- project.xml 25 Jul 2002 02:36:45 -0000 1.2
+++ project.xml 7 Aug 2002 21:46:22 -0000 1.3
@@ -7,10 +7,10 @@
<currentVersion>1.0-dev</currentVersion>
<inceptionYear>2002</inceptionYear>
<gumpRepositoryId>jakarta</gumpRepositoryId>
- <shortDescription>Commons Database Connection Pooling</shortDescription>
+ <shortDescription>Commons Discovery</shortDescription>
<description>
- Commons Database Connection Pooling
+ Commons Discovery
</description>
<developers>
1.3 +13 -5 jakarta-commons/discovery/PROPOSAL.html
Index: PROPOSAL.html
===================================================================
RCS file: /home/cvs/jakarta-commons/discovery/PROPOSAL.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- PROPOSAL.html 2 Aug 2002 19:16:37 -0000 1.2
+++ PROPOSAL.html 7 Aug 2002 21:46:22 -0000 1.3
@@ -11,18 +11,26 @@
<h3>(0) Rationale</h3>
<p>
-Service Discovery provides fundamental discovery pattern used in many projects.
+Discovery locates and manages singleton class instances,
+loading configuration and instantiating if necessary,
+that implement a given Java interface.
+Discovery is, in fact, a pattern used in many projects
+including JAXP (SaxParserFactory and others) and commons-logging (LogFactory).
+By extracting this fundamental pattern,
+other projects can reuse the existing pattern,
+and take advantage of improvements to the pattern as Discovery evolves.
</p>
<p>
-It also provides the resources to make such discovery easily adaptable
-for use within a project whenever/wherever a pluggable interface is
-to be introduced.
+Discovery improves over previous implementations
+by establishing facilities for working within managed environments.
+These allow configuration and property overrides without appealing
+to the global System properties (which are scoped across an entire JVM).
</p>
<h3>(1) Scope of the Package</h3>
<p>
-This is not indended to be a replacement to be used by the user, but rather
+This is not indended to be a replacement to be used strictly by the user, but rather
a replacement to be used directly by projects. Use by the user is also reasonable,
but limited due to 'keeping this simple'. In particular, there is no configuration
for this discovery service, it relies soley on usage patterns.
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>