rsitze 2002/06/04 15:55:51
Modified: java/docs developers-guide.html
Log:
New guides lines for using 'system properties'. Briefly, use
AxisEngine.getGlobalProperties() to get these, so we can
establish a central point of access. In the near future I
expect to update this method to introduce other ways of
setting these properties (as alternatives to the system properties).
Revision Changes Path
1.18 +16 -0 xml-axis/java/docs/developers-guide.html
Index: developers-guide.html
===================================================================
RCS file: /home/cvs/xml-axis/java/docs/developers-guide.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- developers-guide.html 30 Apr 2002 19:06:17 -0000 1.17
+++ developers-guide.html 4 Jun 2002 22:55:51 -0000 1.18
@@ -31,6 +31,7 @@
<br><a href="#General Guidelines">General Guidelines</a>
<br><a href="#Development Environment">Development Environment</a>
<br><a href="#Logging/Tracing">Logging/Tracing</a>
+<br><a href="#Configuration Properties">Configuration Properties</a>
<br><a href="#Exception Handling">Exception Handling</a>
<br><a href="#Compile And Run">Compile and Run</a>
<br><a href="#Internationalization">Internationalization</a>
@@ -292,6 +293,21 @@
For example: one can capture DEBUG (and higher) level information in a logfile,
while limiting console output to INFO (and higher).
</ul>
+
+<h2>
+<a NAME="Configuration Properties"></a>Configuration Properties</h2>
+AXIS is in the process of moving away from using system properties
+as the primary point of internal configuration.
+Avoid calling <code>System.getProperty()</code>,
+and instead call <code>AxisEngine.getGlobalProperty</code>.
+<code>AxisEngine.getGlobalProperty</code> will
+call <code>System.getProperty</code>, and will (eventually)
+query other sources of configuration information.
+<p>
+Using this central point of access will allow the
+global configuration system to be redesigned
+to better support multiple AXIS engines in a
+single JVM.
<h2>
<a NAME="Exception Handling"></a>Exception Handling</h2>
