jetty-9 javadoc improvement

This commit is contained in:
Greg Wilkins 2012-11-13 10:00:04 +11:00
parent d72feaa941
commit 3d27933600
2 changed files with 30 additions and 1 deletions

View File

@ -106,7 +106,7 @@ public class LikeJettyXml
webapp_provider.setParentLoaderPriority(false);
webapp_provider.setExtractWars(true);
webapp_provider.setScanInterval(2);
webapp_provider.setDefaultsDescriptor(jetty_home + "/etc/webdefault.xml");
//webapp_provider.setDefaultsDescriptor(jetty_home + "/etc/webdefault.xml");
deployer.addAppProvider(webapp_provider);
HashLoginService login = new HashLoginService();

View File

@ -68,6 +68,14 @@ import org.xml.sax.SAXException;
* {@link ConfigurationProcessorFactory} interface to be found by the
* {@link ServiceLoader} by using the DTD and first tag element in the file.
* Note that DTD will be null if validation is off.</p>
* <p>
* The configuration can be parameterised with properties that are looked up via the
* Property XML element and set on the configuration via the map returned from
* {@link #getProperties()}</p>
* <p>
* The configuration can create and lookup beans by ID. If multiple configurations are used, then it
* is good practise to copy the entries from the {@link #getIdMap()} of a configuration to the next
* configuration so that they can share an ID space for beans.</p>
*/
public class XmlConfiguration
{
@ -203,11 +211,32 @@ public class XmlConfiguration
_processor.init(_url,config,_idMap, _propertyMap);
}
/* ------------------------------------------------------------ */
/** Get the map of ID String to Objects that is used to hold
* and lookup any objects by ID.
* <p>
* A New, Get or Call XML element may have an
* id attribute which will cause the resulting object to be placed into
* this map. A Ref XML element will lookup an object from this map.</p>
* <p>
* When chaining configuration files, it is good practise to copy the
* ID entries from the ID map to the map of the next configuration, so
* that they may share an ID space
* </p>
*
* @return A modifiable map of ID strings to Objects
*/
public Map<String, Object> getIdMap()
{
return _idMap;
}
/* ------------------------------------------------------------ */
/**
* Get the map of properties used by the Property XML element
* to parameterise configuration.
* @return A modifiable map of properties.
*/
public Map<String, String> getProperties()
{
return _propertyMap;