01: /*
02: * %W% %E%
03: *
04: * Copyright 1990-2006 Sun Microsystems, Inc. All Rights Reserved.
05: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER
06: *
07: * This program is free software; you can redistribute it and/or
08: * modify it under the terms of the GNU General Public License version
09: * 2 only, as published by the Free Software Foundation.
10: *
11: * This program is distributed in the hope that it will be useful, but
12: * WITHOUT ANY WARRANTY; without even the implied warranty of
13: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14: * General Public License version 2 for more details (a copy is
15: * included at /legal/license.txt).
16: *
17: * You should have received a copy of the GNU General Public License
18: * version 2 along with this work; if not, write to the Free Software
19: * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20: * 02110-1301 USA
21: *
22: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
23: * Clara, CA 95054 or visit www.sun.com if you need additional
24: * information or have any questions.
25: */
26:
27: package com.sun.jump.module.preferences;
28:
29: import com.sun.jump.module.JUMPModuleFactory;
30:
31: /**
32: * <code>JUMPPreferencesModuleFactory</code> is a factory for
33: * <code>JUMPPreferencesModule</code> instances. It handles
34: * these instances constitute multiple disjoint namespaces of preferences.
35: */
36: public abstract class JUMPPreferencesModuleFactory extends
37: JUMPModuleFactory {
38:
39: //
40: // Currently we only have system preferences, but in the future,
41: // we can add more namespaces like User / Application preferences.
42: //
43: public static final String TYPE_SYSTEM_PREFERENCES = "system";
44:
45: private static JUMPPreferencesModuleFactory INSTANCE = null;
46:
47: public static JUMPPreferencesModuleFactory getInstance() {
48: return INSTANCE;
49: }
50:
51: /**
52: * Creates a new instance of JUMPPreferencesModuleFactory
53: */
54: protected JUMPPreferencesModuleFactory() {
55: synchronized (JUMPPreferencesModuleFactory.class) {
56: if (INSTANCE == null) {
57: INSTANCE = this ;
58: }
59: }
60: }
61:
62: /**
63: * Returns a <code>JUMPPreferencesModule</code> for the type specified.
64: *
65: * @param type the type or namespace of the preferences.
66: * The supported values are
67: * <ul>
68: * <li>{@link #TYPE_SYSTEM_PREFERENCES}</li>
69: * </ul>
70: * @throws java.lang.IllegalArgumentException if the type is not
71: * not supported by the factory.
72: */
73: public abstract JUMPPreferencesModule getModule(String type);
74:
75: /**
76: * @return a list of all registered preferences in the system for all
77: * namespaces.
78: */
79: public abstract JUMPPreferencesModule[] getAllPreferences();
80: }
|