01: // THIS SOFTWARE IS PROVIDED BY SOFTARIS PTY.LTD. AND OTHER METABOSS
02: // CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING,
03: // BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
04: // FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SOFTARIS PTY.LTD.
05: // OR OTHER METABOSS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
06: // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
07: // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
08: // OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
09: // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
10: // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
11: // EVEN IF SOFTARIS PTY.LTD. OR OTHER METABOSS CONTRIBUTORS ARE ADVISED OF THE
12: // POSSIBILITY OF SUCH DAMAGE.
13: //
14: // Copyright 2000-2005 © Softaris Pty.Ltd. All Rights Reserved.
15: package com.metaboss.enterprise.foundationservices;
16:
17: /** This service provides basic access to settings. When implemented for a particular
18: * enterprise this service will implement some settings hierarch policies. For example
19: * it may have a separate user settings storage, branch settings storage and global settings storage.
20: * The various branches of settings hierarchy may even be implemented using different storage technologies.
21: * This interface provides access to the settings storage from the aplication level */
22: public interface FSAccessToSettings {
23: /** Naming URL of the component */
24: public static final String COMPONENT_URL = "component:/com.metaboss.enterprise.foundationservices.FSAccessToSettings";
25:
26: /** Stores the value of the setting for the specified key at the specified path
27: * @param pPath the path experession with java package like syntax
28: * @param pKey the key uniquely identifying the value
29: * @param pValue the serializable value to store */
30: public void storeSetting(String pPath, String pKey, String pValue);
31:
32: /** Retrieves the value of the setting for the specified key at the specified path
33: * @param pPath the path experession with java package like syntax
34: * @param pKey the key uniquely identifying the value
35: * @return the retrieved setting or null if no key has been found */
36: public String getSetting(String pPath, String pKey);
37: }
|