org/jsampler/Prefs.java

/*
 *   JSampler - a java front-end for LinuxSampler
 *
 *   Copyright (C) 2005-2006 Grigor Iliev <grigor@grigoriliev.com>
 *
 *   This file is part of JSampler.
 *
 *   JSampler is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License version 2
 *   as published by the Free Software Foundation.
 *
 *   JSampler is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with JSampler; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 *   MA  02111-1307  USA
 */

package org.jsampler;

import java.util.prefs.Preferences;


/**
 * This class represents the preferences of the JSampler package.
 * @author Grigor Iliev
 */
public class Prefs {
        private final static String prefNode = "org.jsampler";
        
        private final static String VIEW = "VIEW";
        private final static String DEF_VIEW = "classic";
        
        private final static String JSAMPLER_HOME = "JSampler.home";
        private final static String DEF_JSAMPLER_HOME = null;
        
        private final static String INTERFACE_LANGUAGE = "iface.language";
        private final static String DEF_INTERFACE_LANGUAGE = "en";
        
        private final static String INTERFACE_COUNTRY = "iface.country";
        private final static String DEF_INTERFACE_COUNTRY = "US";
        
        private final static String INTERFACE_FONT = "iface.font";
        private final static String DEF_INTERFACE_FONT = null;
        
        private final static String LS_ADDRESS = "LinuxSampler.address";
        private final static String DEF_LS_ADDRESS = "127.0.0.1";
        
        private final static String LS_PORT = "LinuxSampler.port";
        private final static int DEF_LS_PORT = 8888;
        
                
        private static Preferences userPrefs = Preferences.userRoot().node(prefNode);
        
        /**
         * Gets the user preferences node of the JSampler package.
         * @return The user preferences node of the JSampler package.
         */
        private static Preferences
        user() { return userPrefs; }
        
        
// VIEW
        /**
         * Gets the name of the current View.
         * @return the name of the current View.
         */
        public static String
        getView() { return user().get(VIEW, DEF_VIEW); }
        
        /**
         * Sets the current View of JSampler.
         * @param view the name of the new View.
         */
        public static void
        setView(String view) {
                if(view == null) user().remove(VIEW);
                else if(!view.equals(getView())) user().put(VIEW, view);
        }
        
        /**
         * Gets the interface language.
         * @return The interface language.
         */
        public static String
        getInterfaceLanguage() { return user().get(INTERFACE_LANGUAGE, DEF_INTERFACE_LANGUAGE); }
        
        /**
         * Sets the interface language.
         * @return <code>true</code> if the interface language has changed and <code>false</code>
         * otherwise.
         */
        public static boolean
        setInterfaceLanguage(String language) {
                if(language == null) {
                        user().remove(INTERFACE_LANGUAGE);
                        return true;
                } else if(!language.equals(getInterfaceLanguage())) {
                        user().put(INTERFACE_LANGUAGE, language);
                        return true;
                }
                return false;
        }
        
        /**
         * Gets the interface country.
         * @return The interface country.
         */
        public static String
        getInterfaceCountry() { return user().get(INTERFACE_COUNTRY, DEF_INTERFACE_COUNTRY); }
        
        /**
         * Sets the interface country.
         * @return <code>true</code> if the interface country has changed and <code>false</code>
         * otherwise.
         */
        public static boolean
        setInterfaceCountry(String country) {
                if(country == null) {
                        user().remove(INTERFACE_COUNTRY);
                        return true;
                } else if(!country.equals(getInterfaceCountry())) {
                        user().put(INTERFACE_COUNTRY, country);
                        return true;
                }
                return false;
        }
        
        /**
         * Gets the interface font.
         * @return The interface font.
         */
        public static String
        getInterfaceFont() { return user().get(INTERFACE_FONT, DEF_INTERFACE_FONT); }
        
        /**
         * Sets the interface font.
         * @return <code>true</code> if the interface font has changed and <code>false</code>
         * otherwise.
         */
        public static boolean
        setInterfaceFont(String font) {
                if(font == null) {
                        if(getInterfaceFont() == null) return false;
                        user().remove(INTERFACE_FONT);
                        return true;
                } else if(!font.equals(getInterfaceFont())) {
                        user().put(INTERFACE_FONT, font);
                        return true;
                }
                return false;
        }

// PREFERENCES
        /**
         * Gets the absolute path of JSampler home directory.
         * @return The absolute path of JSampler home directory or
         * <code>null</code> if the JSampler home directory is not set.
         */
        public static String
        getJSamplerHome() { return user().get(JSAMPLER_HOME, DEF_JSAMPLER_HOME); }
        
        /**
         * Sets the JSampler home directory.
         * @param home The absolute path of JSampler home directory.
         * @return <code>true</code> if the JSampler home directory has
         * been changed and <code>false</code> otherwise.
         */
        public static boolean
        setJSamplerHome(String home) {
                if(home == null) {
                        if(getJSamplerHome() == null) return false;
                        user().remove(JSAMPLER_HOME);
                        return true;
                } else if(!home.equals(getJSamplerHome())) {
                        user().put(JSAMPLER_HOME, home);
                        return true;
                }
                return false;
        }
        
        /**
         * Gets the LinuxSampler address.
         * @return The LinuxSampler address.
         */
        public static String
        getLSAddress() { return user().get(LS_ADDRESS, DEF_LS_ADDRESS); }
        
        /**
         * Sets the LinuxSampler address.
         * @param address The LinuxSampler address.
         */
        public static void
        setLSAddress(String address) {
                if(address.length() == 0) user().remove(LS_ADDRESS);
                else if(!address.equals(getLSAddress()))
                        user().put(LS_ADDRESS, address);
        }

        /**
         * Gets the LinuxSampler port.
         * @return The LinuxSampler port number.
         */
        public static int
        getLSPort() { return user().getInt(LS_PORT, DEF_LS_PORT); }
        
        /**
         * Sets the LinuxSampler port number.
         * This method das not check the validity of the port number.
         * @param port the port number. Use -1 to reset to default value.
         */
        public static void
        setLSPort(int port) {
                if(port == -1) user().remove(LS_PORT);
                else if(port != getLSPort()) user().putInt(LS_PORT, port);
        }
}
1	iliev	787	/*
2			* JSampler - a java front-end for LinuxSampler
3			*
4	iliev	1143	* Copyright (C) 2005-2006 Grigor Iliev <grigor@grigoriliev.com>
5	iliev	787	*
6			* This file is part of JSampler.
7			*
8			* JSampler is free software; you can redistribute it and/or modify
9			* it under the terms of the GNU General Public License version 2
10			* as published by the Free Software Foundation.
11			*
12			* JSampler is distributed in the hope that it will be useful,
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15			* GNU General Public License for more details.
16			*
17			* You should have received a copy of the GNU General Public License
18			* along with JSampler; if not, write to the Free Software
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
20			* MA 02111-1307 USA
21			*/
22
23			package org.jsampler;
24
25			import java.util.prefs.Preferences;
26
27
28			/**
29	iliev	842	* This class represents the preferences of the JSampler package.
30	iliev	787	* @author Grigor Iliev
31			*/
32			public class Prefs {
33			private final static String prefNode = "org.jsampler";
34
35			private final static String VIEW = "VIEW";
36			private final static String DEF_VIEW = "classic";
37
38	iliev	1143	private final static String JSAMPLER_HOME = "JSampler.home";
39			private final static String DEF_JSAMPLER_HOME = null;
40
41	iliev	842	private final static String INTERFACE_LANGUAGE = "iface.language";
42			private final static String DEF_INTERFACE_LANGUAGE = "en";
43	iliev	787
44	iliev	842	private final static String INTERFACE_COUNTRY = "iface.country";
45			private final static String DEF_INTERFACE_COUNTRY = "US";
46	iliev	787
47	iliev	842	private final static String INTERFACE_FONT = "iface.font";
48			private final static String DEF_INTERFACE_FONT = null;
49	iliev	787
50	iliev	842	private final static String LS_ADDRESS = "LinuxSampler.address";
51			private final static String DEF_LS_ADDRESS = "127.0.0.1";
52	iliev	787
53	iliev	842	private final static String LS_PORT = "LinuxSampler.port";
54			private final static int DEF_LS_PORT = 8888;
55	iliev	787
56	iliev	911
57	iliev	787	private static Preferences userPrefs = Preferences.userRoot().node(prefNode);
58
59	iliev	842	/**
60			* Gets the user preferences node of the JSampler package.
61			* @return The user preferences node of the JSampler package.
62			*/
63			private static Preferences
64	iliev	787	user() { return userPrefs; }
65
66	iliev	842
67	iliev	787	// VIEW
68	iliev	842	/**
69			* Gets the name of the current View.
70			* @return the name of the current View.
71			*/
72	iliev	787	public static String
73			getView() { return user().get(VIEW, DEF_VIEW); }
74
75	iliev	842	/**
76			* Sets the current View of JSampler.
77			* @param view the name of the new View.
78			*/
79	iliev	787	public static void
80			setView(String view) {
81			if(view == null) user().remove(VIEW);
82			else if(!view.equals(getView())) user().put(VIEW, view);
83			}
84
85	iliev	842	/**
86			* Gets the interface language.
87			* @return The interface language.
88			*/
89	iliev	787	public static String
90			getInterfaceLanguage() { return user().get(INTERFACE_LANGUAGE, DEF_INTERFACE_LANGUAGE); }
91
92			/**
93			* Sets the interface language.
94			* @return <code>true</code> if the interface language has changed and <code>false</code>
95			* otherwise.
96			*/
97			public static boolean
98			setInterfaceLanguage(String language) {
99			if(language == null) {
100			user().remove(INTERFACE_LANGUAGE);
101			return true;
102			} else if(!language.equals(getInterfaceLanguage())) {
103			user().put(INTERFACE_LANGUAGE, language);
104			return true;
105			}
106			return false;
107			}
108
109	iliev	842	/**
110			* Gets the interface country.
111			* @return The interface country.
112			*/
113	iliev	787	public static String
114			getInterfaceCountry() { return user().get(INTERFACE_COUNTRY, DEF_INTERFACE_COUNTRY); }
115
116			/**
117			* Sets the interface country.
118			* @return <code>true</code> if the interface country has changed and <code>false</code>
119			* otherwise.
120			*/
121			public static boolean
122			setInterfaceCountry(String country) {
123			if(country == null) {
124			user().remove(INTERFACE_COUNTRY);
125			return true;
126			} else if(!country.equals(getInterfaceCountry())) {
127			user().put(INTERFACE_COUNTRY, country);
128			return true;
129			}
130			return false;
131			}
132
133	iliev	842	/**
134			* Gets the interface font.
135			* @return The interface font.
136			*/
137	iliev	787	public static String
138			getInterfaceFont() { return user().get(INTERFACE_FONT, DEF_INTERFACE_FONT); }
139
140			/**
141			* Sets the interface font.
142			* @return <code>true</code> if the interface font has changed and <code>false</code>
143			* otherwise.
144			*/
145			public static boolean
146			setInterfaceFont(String font) {
147			if(font == null) {
148			if(getInterfaceFont() == null) return false;
149			user().remove(INTERFACE_FONT);
150			return true;
151			} else if(!font.equals(getInterfaceFont())) {
152			user().put(INTERFACE_FONT, font);
153			return true;
154			}
155			return false;
156			}
157
158			// PREFERENCES
159	iliev	842	/**
160	iliev	1143	* Gets the absolute path of JSampler home directory.
161			* @return The absolute path of JSampler home directory or
162			* <code>null</code> if the JSampler home directory is not set.
163			*/
164			public static String
165			getJSamplerHome() { return user().get(JSAMPLER_HOME, DEF_JSAMPLER_HOME); }
166
167			/**
168			* Sets the JSampler home directory.
169			* @param home The absolute path of JSampler home directory.
170			* @return <code>true</code> if the JSampler home directory has
171			* been changed and <code>false</code> otherwise.
172			*/
173			public static boolean
174			setJSamplerHome(String home) {
175			if(home == null) {
176			if(getJSamplerHome() == null) return false;
177			user().remove(JSAMPLER_HOME);
178			return true;
179			} else if(!home.equals(getJSamplerHome())) {
180			user().put(JSAMPLER_HOME, home);
181			return true;
182			}
183			return false;
184			}
185
186			/**
187	iliev	842	* Gets the LinuxSampler address.
188			* @return The LinuxSampler address.
189			*/
190	iliev	787	public static String
191			getLSAddress() { return user().get(LS_ADDRESS, DEF_LS_ADDRESS); }
192
193	iliev	842	/**
194			* Sets the LinuxSampler address.
195			* @param address The LinuxSampler address.
196			*/
197	iliev	787	public static void
198			setLSAddress(String address) {
199			if(address.length() == 0) user().remove(LS_ADDRESS);
200			else if(!address.equals(getLSAddress()))
201			user().put(LS_ADDRESS, address);
202			}
203
204	iliev	842	/**
205			* Gets the LinuxSampler port.
206			* @return The LinuxSampler port number.
207			*/
208	iliev	787	public static int
209			getLSPort() { return user().getInt(LS_PORT, DEF_LS_PORT); }
210
211			/**
212			* Sets the LinuxSampler port number.
213			* This method das not check the validity of the port number.
214			* @param port the port number. Use -1 to reset to default value.
215			*/
216			public static void
217	iliev	842	setLSPort(int port) {
218	iliev	787	if(port == -1) user().remove(LS_PORT);
219			else if(port != getLSPort()) user().putInt(LS_PORT, port);
220			}
221			}