|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.eclipse.jetty.xml.XmlConfiguration
public class XmlConfiguration
Configure Objects from XML. This class reads an XML file conforming to the configure.dtd DTD and uses it to configure and object by calling set, put or other methods on the object.
The actual XML file format may be changed (eg to spring XML) by implementing the ConfigurationProcessorFactory
interfaces to be found by the
ServiceLoader
by using the DTD and first tag element in the file. Note that DTD will be null if validation is off.
Constructor Summary | |
---|---|
XmlConfiguration(InputStream configuration)
Constructor. |
|
XmlConfiguration(String configuration)
Constructor. |
|
XmlConfiguration(URL configuration)
Constructor. |
Method Summary | |
---|---|
Object |
configure()
Configure an object. |
Object |
configure(Object obj)
Configure an object. |
Map<String,Object> |
getIdMap()
|
Map<String,String> |
getProperties()
|
static void |
main(String[] args)
Run the XML configurations as a main application. |
void |
setIdMap(Map<String,Object> map)
Deprecated. use getIdMap() .put(...) |
void |
setProperties(Map<String,String> map)
Deprecated. use getProperties() .putAll(...) |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public XmlConfiguration(URL configuration) throws SAXException, IOException
configuration
-
SAXException
IOException
public XmlConfiguration(String configuration) throws SAXException, IOException
configuration
- String of XML configuration commands excluding the normal XML preamble. The String should start with a " SAXException
IOException
public XmlConfiguration(InputStream configuration) throws SAXException, IOException
configuration
- An input stream containing a complete e.g. configuration file
SAXException
IOException
Method Detail |
---|
public Map<String,Object> getIdMap()
public void setIdMap(Map<String,Object> map)
getIdMap()
.put(...)
public void setProperties(Map<String,String> map)
getProperties()
.putAll(...)
public Map<String,String> getProperties()
public Object configure(Object obj) throws Exception
Apply the XML configuration script to the passed object.
obj
- The object to be configured, which must be of a type or super type of the class attribute of the Configure element.
Exception
public Object configure() throws Exception
Exception
public static void main(String[] args) throws Exception
Any property file on the command line is added to a combined Property instance that is passed to each configuration file via
setProperties(Map)
.
Each configuration file on the command line is used to create a new XmlConfiguration instance and the configure()
method is used
to create the configured object. If the resulting object is an instance of LifeCycle
, then it is started.
Any IDs created in a configuration are passed to the next configuration file on the command line using getIdMap()
and setIdMap(Map)
.
This allows objects with IDs created in one config file to be referenced in subsequent config files on the command line.
args
- array of property and xml configuration filenames or Resource
s.
Exception
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |