org/jsampler/Prefs.java

/*
 *   JSampler - a java front-end for LinuxSampler
 *
 *   Copyright (C) 2005 Grigor Kirilov Iliev
 *
 *   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 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 final static String ORCHESTRAS = "Orchestras";
        private final static String DEF_ORCHESTRAS = null;
        
                
        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 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);
        }
        
        /**
         * Gets the orchestras' content (in XML format).
         * @return The orchestras' content (in XML format).
         */
        public static String
        getOrchestras() { return user().get(ORCHESTRAS, DEF_ORCHESTRAS); }
        
        /**
         * Sets the orchestras' content (in XML format).
         * @param s The orchestras' content (in XML format).
         */
        public static void
        setOrchestras(String s) {
                if(s == null) {
                        user().remove(ORCHESTRAS);
                        return;
                }
                if(s.equals(getOrchestras())) return;
                
                user().put(ORCHESTRAS, s);
        }
}
1	/*
2	* JSampler - a java front-end for LinuxSampler
3	*
4	* Copyright (C) 2005 Grigor Kirilov Iliev
5	*
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	* This class represents the preferences of the JSampler package.
30	* @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	private final static String INTERFACE_LANGUAGE = "iface.language";
39	private final static String DEF_INTERFACE_LANGUAGE = "en";
40
41	private final static String INTERFACE_COUNTRY = "iface.country";
42	private final static String DEF_INTERFACE_COUNTRY = "US";
43
44	private final static String INTERFACE_FONT = "iface.font";
45	private final static String DEF_INTERFACE_FONT = null;
46
47	private final static String LS_ADDRESS = "LinuxSampler.address";
48	private final static String DEF_LS_ADDRESS = "127.0.0.1";
49
50	private final static String LS_PORT = "LinuxSampler.port";
51	private final static int DEF_LS_PORT = 8888;
52
53	private final static String ORCHESTRAS = "Orchestras";
54	private final static String DEF_ORCHESTRAS = null;
55
56
57	private static Preferences userPrefs = Preferences.userRoot().node(prefNode);
58
59	/**
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	user() { return userPrefs; }
65
66
67	// VIEW
68	/**
69	* Gets the name of the current View.
70	* @return the name of the current View.
71	*/
72	public static String
73	getView() { return user().get(VIEW, DEF_VIEW); }
74
75	/**
76	* Sets the current View of JSampler.
77	* @param view the name of the new View.
78	*/
79	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	/**
86	* Gets the interface language.
87	* @return The interface language.
88	*/
89	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	/**
110	* Gets the interface country.
111	* @return The interface country.
112	*/
113	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	/**
134	* Gets the interface font.
135	* @return The interface font.
136	*/
137	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	/**
160	* Gets the LinuxSampler address.
161	* @return The LinuxSampler address.
162	*/
163	public static String
164	getLSAddress() { return user().get(LS_ADDRESS, DEF_LS_ADDRESS); }
165
166	/**
167	* Sets the LinuxSampler address.
168	* @param address The LinuxSampler address.
169	*/
170	public static void
171	setLSAddress(String address) {
172	if(address.length() == 0) user().remove(LS_ADDRESS);
173	else if(!address.equals(getLSAddress()))
174	user().put(LS_ADDRESS, address);
175	}
176
177	/**
178	* Gets the LinuxSampler port.
179	* @return The LinuxSampler port number.
180	*/
181	public static int
182	getLSPort() { return user().getInt(LS_PORT, DEF_LS_PORT); }
183
184	/**
185	* Sets the LinuxSampler port number.
186	* This method das not check the validity of the port number.
187	* @param port the port number. Use -1 to reset to default value.
188	*/
189	public static void
190	setLSPort(int port) {
191	if(port == -1) user().remove(LS_PORT);
192	else if(port != getLSPort()) user().putInt(LS_PORT, port);
193	}
194
195	/**
196	* Gets the orchestras' content (in XML format).
197	* @return The orchestras' content (in XML format).
198	*/
199	public static String
200	getOrchestras() { return user().get(ORCHESTRAS, DEF_ORCHESTRAS); }
201
202	/**
203	* Sets the orchestras' content (in XML format).
204	* @param s The orchestras' content (in XML format).
205	*/
206	public static void
207	setOrchestras(String s) {
208	if(s == null) {
209	user().remove(ORCHESTRAS);
210	return;
211	}
212	if(s.equals(getOrchestras())) return;
213
214	user().put(ORCHESTRAS, s);
215	}
216	}