001: /*
002: * Copyright (C) 2005 Jeff Tassin
003: *
004: * This library is free software; you can redistribute it and/or
005: * modify it under the terms of the GNU Lesser General Public
006: * License as published by the Free Software Foundation; either
007: * version 2.1 of the License, or (at your option) any later version.
008: *
009: * This library is distributed in the hope that it will be useful,
010: * but WITHOUT ANY WARRANTY; without even the implied warranty of
011: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
012: * Lesser General Public License for more details.
013: *
014: * You should have received a copy of the GNU Lesser General Public
015: * License along with this library; if not, write to the Free Software
016: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
017: */
018:
019: package com.jeta.swingbuilder.app;
020:
021: import java.io.InputStream;
022: import java.io.OutputStream;
023: import java.util.Properties;
024:
025: import com.jeta.open.registry.JETARegistry;
026: import com.jeta.swingbuilder.interfaces.resources.ResourceLoader;
027: import com.jeta.swingbuilder.interfaces.userprops.TSUserProperties;
028:
029: /**
030: * @author Jeff Tassin
031: */
032: public class UserPropertiesStore implements TSUserProperties {
033: private static final String PROPS_RESOURCE_NAME = "userdata.properties"; // the
034: // name
035: // of
036: // the
037: // 'file'
038: // we
039: // store
040: // to
041: private Properties m_props = new Properties(); // the set of objects
042: /**
043: * Flag that indicates if store should be read only. (Needed for webstart)
044: */
045: private boolean m_readonly = false;
046:
047: public UserPropertiesStore() {
048:
049: }
050:
051: /**
052: * Reads the named property for the given keyname from the user properties
053: * store. This method does not throw any exceptions, it is assumed the
054: * implementor will log the exception somewhere
055: *
056: * @param keyName
057: * the unique key name to get the property for
058: * @return the property string. Null is returned if the string is not found
059: */
060: public String getProperty(String keyName) {
061: return m_props.getProperty(keyName);
062: }
063:
064: /**
065: * Reads the named property for the given key from the user properties
066: * store. This method does not throw any exceptions, it is assumed the
067: * implementor will log the exception somewhere
068: *
069: * @param keyName
070: * the unique key name within that component to get the property
071: * for
072: * @param defaultValue
073: * if the key is not found, return this value
074: * @return the property string. Null is returned if the string is not found
075: */
076: public String getProperty(String keyName, String defaultValue) {
077: return m_props.getProperty(keyName, defaultValue);
078: }
079:
080: /**
081: * TSComponent implementation. Get's called by JETARegistry at startup
082: */
083: public void startup() {
084: try {
085: JETARegistry.rebind(TSUserProperties.COMPONENT_ID, this );
086:
087: if (m_readonly) {
088: m_props = new Properties();
089: } else {
090: ResourceLoader loader = (ResourceLoader) JETARegistry
091: .lookup(ResourceLoader.COMPONENT_ID);
092: InputStream reader = loader
093: .getInputStream(PROPS_RESOURCE_NAME);
094: m_props.load(reader);
095: reader.close();
096: }
097: } catch (Exception e) {
098: m_props = new Properties();
099: }
100: }
101:
102: /**
103: */
104: public void shutdown() {
105: try {
106: if (!m_readonly) {
107: ResourceLoader loader = (ResourceLoader) JETARegistry
108: .lookup(ResourceLoader.COMPONENT_ID);
109: OutputStream writer = loader
110: .getOutputStream(PROPS_RESOURCE_NAME);
111: m_props.store(writer, null);
112: writer.close();
113: }
114: } catch (Exception e) {
115: e.printStackTrace();
116: }
117: }
118:
119: /**
120: * Stores the named property for the given key to the user properties store.
121: * This method does not throw any exceptions, it is assumed the implementor
122: * will log the exception somewhere
123: */
124: public void setProperty(String keyName, String value) {
125: m_props.setProperty(keyName, value);
126: }
127:
128: public void setReadOnly(boolean readonly) {
129: m_readonly = readonly;
130: }
131: }
|