001    /**
002     * Copyright (c) 2000-2011 Liferay, Inc. All rights reserved.
003     *
004     * This library is free software; you can redistribute it and/or modify it under
005     * the terms of the GNU Lesser General Public License as published by the Free
006     * Software Foundation; either version 2.1 of the License, or (at your option)
007     * any later version.
008     *
009     * This library is distributed in the hope that it will be useful, but WITHOUT
010     * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
011     * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
012     * details.
013     */
014    
015    package com.liferay.portal.kernel.util;
016    
017    import com.liferay.portal.kernel.json.JSONObject;
018    
019    import java.util.Locale;
020    import java.util.Map;
021    
022    import javax.portlet.PortletPreferences;
023    import javax.portlet.PortletRequest;
024    
025    /**
026     * @author Alexander Chow
027     * @author Jorge Ferrer
028     * @author Mauro Mariuzzo
029     * @author Julio Camarero
030     * @author Brian Wing Shun Chan
031     * @see    Localization
032     */
033    public class LocalizationUtil {
034    
035            public static Object deserialize(JSONObject jsonObject) {
036                    return getLocalization().deserialize(jsonObject);
037            }
038    
039            public static String[] getAvailableLocales(String xml) {
040                    return getLocalization().getAvailableLocales(xml);
041            }
042    
043            public static String getDefaultLocale(String xml) {
044                    return getLocalization().getDefaultLocale(xml);
045            }
046    
047            public static Localization getLocalization() {
048                    return _localization;
049            }
050    
051            public static String getLocalization(
052                    String xml, String requestedLanguageId) {
053    
054                    return getLocalization().getLocalization(xml, requestedLanguageId);
055            }
056    
057            public static String getLocalization(
058                    String xml, String requestedLanguageId, boolean useDefault) {
059    
060                    return getLocalization().getLocalization(
061                            xml, requestedLanguageId, useDefault);
062            }
063    
064            public static Map<Locale, String> getLocalizationMap(
065                    PortletPreferences preferences, String parameter) {
066    
067                    return getLocalization().getLocalizationMap(preferences, parameter);
068            }
069    
070            public static Map<Locale, String> getLocalizationMap(
071                    PortletRequest portletRequest, String parameter) {
072    
073                    return getLocalization().getLocalizationMap(portletRequest, parameter);
074            }
075    
076            public static Map<Locale, String> getLocalizationMap(String xml) {
077                    return getLocalization().getLocalizationMap(xml);
078            }
079    
080            public static String getLocalizationXmlFromPreferences(
081                    PortletPreferences preferences, PortletRequest portletRequest,
082                    String parameter) {
083    
084                    return getLocalization().getLocalizationXmlFromPreferences(
085                            preferences, portletRequest, parameter);
086            }
087    
088            /**
089             * @deprecated Use <code>getLocalizationMap</code>.
090             */
091            public static Map<Locale, String> getLocalizedParameter(
092                    PortletRequest portletRequest, String parameter) {
093    
094                    return getLocalization().getLocalizedParameter(
095                            portletRequest, parameter);
096            }
097    
098            public static String getPreferencesKey(String key, String languageId) {
099                    return getLocalization().getPreferencesKey(key, languageId);
100            }
101    
102            public static String getPreferencesValue(
103                    PortletPreferences preferences, String key, String languageId) {
104    
105                    return getLocalization().getPreferencesValue(
106                            preferences, key, languageId);
107            }
108    
109            public static String getPreferencesValue(
110                    PortletPreferences preferences, String key, String languageId,
111                    boolean useDefault) {
112    
113                    return getLocalization().getPreferencesValue(
114                            preferences, key, languageId, useDefault);
115            }
116    
117            public static String[] getPreferencesValues(
118                    PortletPreferences preferences, String key, String languageId) {
119    
120                    return getLocalization().getPreferencesValues(
121                            preferences, key, languageId);
122            }
123    
124            public static String[] getPreferencesValues(
125                    PortletPreferences preferences, String key, String languageId,
126                    boolean useDefault) {
127    
128                    return getLocalization().getPreferencesValues(
129                            preferences, key, languageId, useDefault);
130            }
131    
132            public static String removeLocalization(
133                    String xml, String key, String requestedLanguageId) {
134    
135                    return getLocalization().removeLocalization(
136                            xml, key, requestedLanguageId);
137            }
138    
139            public static String removeLocalization(
140                    String xml, String key, String requestedLanguageId, boolean cdata) {
141    
142                    return getLocalization().removeLocalization(
143                            xml, key, requestedLanguageId, cdata);
144            }
145    
146            public static String removeLocalization(
147                    String xml, String key, String requestedLanguageId, boolean cdata,
148                    boolean localized) {
149    
150                    return getLocalization().removeLocalization(
151                            xml, key, requestedLanguageId, cdata, localized);
152            }
153    
154            public static void setLocalizedPreferencesValues (
155                            PortletRequest portletRequest, PortletPreferences preferences,
156                            String parameter)
157                    throws Exception {
158    
159                    getLocalization().setLocalizedPreferencesValues(
160                            portletRequest, preferences, parameter);
161            }
162    
163            public static void setPreferencesValue(
164                            PortletPreferences preferences, String key, String languageId,
165                            String value)
166                    throws Exception {
167    
168                    getLocalization().setPreferencesValue(
169                            preferences, key, languageId, value);
170            }
171    
172            public static void setPreferencesValues(
173                            PortletPreferences preferences, String key, String languageId,
174                            String[] values)
175                    throws Exception {
176    
177                    getLocalization().setPreferencesValues(
178                            preferences, key, languageId, values);
179            }
180    
181            public static String updateLocalization(
182                    String xml, String key, String value) {
183    
184                    return getLocalization().updateLocalization(xml, key, value);
185            }
186    
187            public static String updateLocalization(
188                    String xml, String key, String value, String requestedLanguageId) {
189    
190                    return getLocalization().updateLocalization(
191                            xml, key, value, requestedLanguageId);
192            }
193    
194            public static String updateLocalization(
195                    String xml, String key, String value, String requestedLanguageId,
196                    String defaultLanguageId) {
197    
198                    return getLocalization().updateLocalization(
199                            xml, key, value, requestedLanguageId, defaultLanguageId);
200            }
201    
202            public static String updateLocalization(
203                    String xml, String key, String value, String requestedLanguageId,
204                    String defaultLanguageId, boolean cdata) {
205    
206                    return getLocalization().updateLocalization(
207                            xml, key, value, requestedLanguageId, defaultLanguageId, cdata);
208            }
209    
210            public static String updateLocalization(
211                    String xml, String key, String value, String requestedLanguageId,
212                    String defaultLanguageId, boolean cdata, boolean localized) {
213    
214                    return getLocalization().updateLocalization(
215                            xml, key, value, requestedLanguageId, defaultLanguageId, cdata,
216                            localized);
217            }
218    
219            public void setLocalization(Localization localization) {
220                    _localization = localization;
221            }
222    
223            private static Localization _localization;
224    
225    }