This method is used by the CSI infrastructure to retrieve configuration information in a standardized format.
Syntax
Map< String, String >
getConfiguration
(
Map< String, Object >
selectors
) throws SecException
Parameters
-
selectors –
a map of selectors that dynamically alter the returned configuration. The specific keys and values that are meaningful depend on the underling implementation.
Returns
map of configuration options.
Exceptions
-
SecException class –
on a configuration error
Usage
This method will be called once for the creation of every SecContext object. Because of this the following guidelines should be followed by any implementation:
- The return value of this method should not change if the configuration data has not changed. This allows the CSI infrastructure to properly cache configuration data.
- If the underlying configuration data has changed, the return value should not be modified and returned. Instead a new object should be created from scratch. CSI infrastructure caches based on object identity, not contents, so if this rule is not followed then updated configuration data will not be noticed by CSI.