org.settings4j.settings

Class DefaultSettings

java.lang.Object

org.settings4j.settings.DefaultSettings

All Implemented Interfaces:

Settings4jInstance

public class DefaultSettings
extends Object
implements Settings4jInstance

The default Settings Object.

Author:

Harald.Brabenetz

Constructor Summary

Constructors

Constructor and Description
DefaultSettings()

Method Summary

Methods

Modifier and Type	Method and Description
void	addConnector(Connector connector) Add a Connector.
void	addConnector(Connector connector, ConnectorPosition position) Add a custom Connector to the right position in relation to the other connectors.
Connector	getConnector(String connectorName) Return the Connector for the given Name.
List<Connector>	getConnectors() Return a List off Connector who can be used with this Settings4jInstance instance.
byte[]	getContent(String key) return the found byte[]-Value for the given key.
Map	getMapping() The key mapping defined in settings4j.xml.
Object	getObject(String key) return the found Object-Value for the given key.
String	getString(String key) return the found String-Value for the given key.
void	removeAllConnectors() Remove all Settings.
void	setMapping(Map mapping) Set the mapping for this Settings-Object without inheritance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultSettings

public DefaultSettings()

Method Detail

getConnectors

public List<Connector> getConnectors()

Return a List off Connector who can be used with this Settings4jInstance instance.

Specified by:

getConnectors in interface Settings4jInstance

Returns:

a list off all Connectors who can be used with this Settings4jInstance instance

getConnector

public Connector getConnector(String connectorName)

Return the Connector for the given Name.

Specified by:

getConnector in interface Settings4jInstance

Parameters:

connectorName - The Connector Name.

Returns:

The Connector for the given Name.

addConnector

public void addConnector(Connector connector)

Add a Connector.
This method will be call, if you create a connector-ref to a connector configuration in your settings4j.xml

 Example configuration in settings4j.xml:
 --------------------------------------
 <settings name="com.mycompany" >
     <connector-ref name="DBConnector" />
 </settings>
 --------------------------------------
 

Specified by:

addConnector in interface Settings4jInstance

Parameters:

connector - The connector to add.

addConnector

public void addConnector(Connector connector,
                ConnectorPosition position)

Add a custom Connector to the right position in relation to the other connectors.
This method can be used to add custom connectors into the Settings4jInstance

Example usage 1:

 --------------------------------------
 Connector myConnector = ...
 addConnector(myConnector, ConnectorPositions.afterLast(SystemPropertyConnector.class));
 --------------------------------------
 

Example usage 2:

ConnectorPositions.afterLast(SystemPropertyConnector.class) will throw an exception if the Settings4jInstance doesn't have a SystemPropertyConnector.
To prevent an Exception you can provide multiple ConnectorPositions as fallback:

 --------------------------------------
 Connector myConnector = ...
 addConnector(myConnector, ConnectorPositions.firstValid(//
     ConnectorPositions.afterLast(SystemPropertyConnector.class),
     ConnectorPositions.atFirst() // fallback if no SystemPropertyConnector exists.
   )
 );
 --------------------------------------
 

Example usage 3:

Settings4jInstance.addConnector(Connector) will throw an exception if a connector with the same name already exists.
To prevent this Exception you should also check with Settings4jInstance.getConnector(String) if the Connector already exists:

 --------------------------------------
 Connector myConnector = ...
 if(getConnector(myConnector.getName()) == null) {
   addConnector(myConnector, ConnectorPositions.firstValid(//
       ConnectorPositions.afterLast(SystemPropertyConnector.class),
       ConnectorPositions.atFirst() // fallback if no SystemPropertyConnector exists.
     )
   );
 }
 --------------------------------------
 

Specified by:

addConnector in interface Settings4jInstance

Parameters:

connector - The connector to add.

position - The position where the connector should be added.

removeAllConnectors

public void removeAllConnectors()

Remove all Settings. (Internal use only)

Specified by:

removeAllConnectors in interface Settings4jInstance

getContent

public byte[] getContent(String key)

return the found byte[]-Value for the given key.
The Settings4jInstance Instance iterates all his Connectors and return the first found Value.

Returns null if no connector found a Value for the given key

Specified by:

getContent in interface Settings4jInstance

Parameters:

key - the Key for the configuration-property. e.g.: "com/mycompany/myapp/myParameterKey"

Returns:

the found byte[]-Value for the given key

getObject

public Object getObject(String key)

return the found Object-Value for the given key.
The Settings4jInstance iterates all his Connectors and return the first found Value.
Returns null if no connector found a Value for the given key

Specified by:

getObject in interface Settings4jInstance

Parameters:

key - the Key for the configuration-property. e.g.: "com/mycompany/myapp/myParameterKey"

Returns:

the found Object-Value for the given key

getString

public String getString(String key)

return the found String-Value for the given key.
The Settings4jInstance Instance iterates all his Connectors and return the first found Value.

Returns null if no connector found a Value for the given key

Specified by:

getString in interface Settings4jInstance

Parameters:

key - the Key for the configuration-property. e.g.: "com/mycompany/myapp/myParameterKey"

Returns:

the found String-Value for the given key

getMapping

public Map getMapping()

The key mapping defined in settings4j.xml.

if some Sub-Modules of your App defines separated Keys for e.g. the DataSource, you can refer it to one unique Key:

 Example:
 <mapping name="defaultMapping">
     <entry key="com/mycompany/moduleX/datasource" ref-key="global/datasource"/>
     <entry key="com/mycompany/moduleY/datasource" ref-key="global/datasource"/>
 </mapping>
 

Settings4j.getXXX("com/mycompany/moduleX/datasource");
should return the configured value under "global/datasource"

Specified by:

getMapping in interface Settings4jInstance

Returns:

the Mappings of this Settings-Object (without inheritances)

setMapping

public void setMapping(Map mapping)

Set the mapping for this Settings-Object without inheritance.
This method will be call, if you create a mapping-ref to a mapping configuration in your settings4j.xml

 Example:
 <root mapping-ref="defaultMapping" >
    ...
 </root>
 
 <mapping name="defaultMapping">
     <entry key="com/mycompany/moduleX/datasource" ref-key="global/datasource"/>
     <entry key="com/mycompany/moduleY/datasource" ref-key="global/datasource"/>
 </mapping>
 

Specified by:

setMapping in interface Settings4jInstance

Parameters:

mapping - The Mapping between available settings to used settings.