001    /*
002     *  Copyright 2001-2009 Stephen Colebourne
003     *
004     *  Licensed under the Apache License, Version 2.0 (the "License");
005     *  you may not use this file except in compliance with the License.
006     *  You may obtain a copy of the License at
007     *
008     *      http://www.apache.org/licenses/LICENSE-2.0
009     *
010     *  Unless required by applicable law or agreed to in writing, software
011     *  distributed under the License is distributed on an "AS IS" BASIS,
012     *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013     *  See the License for the specific language governing permissions and
014     *  limitations under the License.
015     */
016    package org.joda.time.tz;
017    
018    import java.io.DataInputStream;
019    import java.io.File;
020    import java.io.FileInputStream;
021    import java.io.IOException;
022    import java.io.InputStream;
023    import java.lang.ref.SoftReference;
024    import java.util.Map;
025    import java.util.Set;
026    import java.util.TreeSet;
027    import java.util.concurrent.ConcurrentHashMap;
028    
029    import org.joda.time.DateTimeZone;
030    
031    /**
032     * ZoneInfoProvider loads compiled data files as generated by
033     * {@link ZoneInfoCompiler}.
034     * <p>
035     * ZoneInfoProvider is thread-safe and publicly immutable.
036     *
037     * @author Brian S O'Neill
038     * @since 1.0
039     */
040    public class ZoneInfoProvider implements Provider {
041    
042        /** The directory where the files are held. */
043        private final File iFileDir;
044        /** The resource path. */
045        private final String iResourcePath;
046        /** The class loader to use. */
047        private final ClassLoader iLoader;
048        /** Maps ids to strings or SoftReferences to DateTimeZones. */
049        private final Map<String, Object> iZoneInfoMap;
050    
051        /**
052         * ZoneInfoProvider searches the given directory for compiled data files.
053         *
054         * @throws IOException if directory or map file cannot be read
055         */
056        public ZoneInfoProvider(File fileDir) throws IOException {
057            if (fileDir == null) {
058                throw new IllegalArgumentException("No file directory provided");
059            }
060            if (!fileDir.exists()) {
061                throw new IOException("File directory doesn't exist: " + fileDir);
062            }
063            if (!fileDir.isDirectory()) {
064                throw new IOException("File doesn't refer to a directory: " + fileDir);
065            }
066    
067            iFileDir = fileDir;
068            iResourcePath = null;
069            iLoader = null;
070    
071            iZoneInfoMap = loadZoneInfoMap(openResource("ZoneInfoMap"));
072        }
073    
074        /**
075         * ZoneInfoProvider searches the given ClassLoader resource path for
076         * compiled data files. Resources are loaded from the ClassLoader that
077         * loaded this class.
078         *
079         * @throws IOException if directory or map file cannot be read
080         */
081        public ZoneInfoProvider(String resourcePath) throws IOException {
082            this(resourcePath, null, false);
083        }
084    
085        /**
086         * ZoneInfoProvider searches the given ClassLoader resource path for
087         * compiled data files.
088         *
089         * @param loader ClassLoader to load compiled data files from. If null,
090         * use system ClassLoader.
091         * @throws IOException if directory or map file cannot be read
092         */
093        public ZoneInfoProvider(String resourcePath, ClassLoader loader)
094            throws IOException
095        {
096            this(resourcePath, loader, true);
097        }
098    
099        /**
100         * @param favorSystemLoader when true, use the system class loader if
101         * loader null. When false, use the current class loader if loader is null.
102         */
103        private ZoneInfoProvider(String resourcePath,
104                                 ClassLoader loader, boolean favorSystemLoader) 
105            throws IOException
106        {
107            if (resourcePath == null) {
108                throw new IllegalArgumentException("No resource path provided");
109            }
110            if (!resourcePath.endsWith("/")) {
111                resourcePath += '/';
112            }
113    
114            iFileDir = null;
115            iResourcePath = resourcePath;
116    
117            if (loader == null && !favorSystemLoader) {
118                loader = getClass().getClassLoader();
119            }
120    
121            iLoader = loader;
122    
123            iZoneInfoMap = loadZoneInfoMap(openResource("ZoneInfoMap"));
124        }
125    
126        //-----------------------------------------------------------------------
127        /**
128         * If an error is thrown while loading zone data, uncaughtException is
129         * called to log the error and null is returned for this and all future
130         * requests.
131         * 
132         * @param id  the id to load
133         * @return the loaded zone
134         */
135        public DateTimeZone getZone(String id) {
136            if (id == null) {
137                return null;
138            }
139    
140            Object obj = iZoneInfoMap.get(id);
141            if (obj == null) {
142                return null;
143            }
144    
145            if (id.equals(obj)) {
146                // Load zone data for the first time.
147                return loadZoneData(id);
148            }
149    
150            if (obj instanceof SoftReference<?>) {
151                @SuppressWarnings("unchecked")
152                SoftReference<DateTimeZone> ref = (SoftReference<DateTimeZone>) obj;
153                DateTimeZone tz = ref.get();
154                if (tz != null) {
155                    return tz;
156                }
157                // Reference cleared; load data again.
158                return loadZoneData(id);
159            }
160    
161            // If this point is reached, mapping must link to another.
162            return getZone((String)obj);
163        }
164    
165        /**
166         * Gets a list of all the available zone ids.
167         * 
168         * @return the zone ids
169         */
170        public Set<String> getAvailableIDs() {
171            // Return a copy of the keys rather than an umodifiable collection.
172            // This prevents ConcurrentModificationExceptions from being thrown by
173            // some JVMs if zones are opened while this set is iterated over.
174            return new TreeSet<String>(iZoneInfoMap.keySet());
175        }
176    
177        /**
178         * Called if an exception is thrown from getZone while loading zone data.
179         * 
180         * @param ex  the exception
181         */
182        protected void uncaughtException(Exception ex) {
183            Thread t = Thread.currentThread();
184            t.getThreadGroup().uncaughtException(t, ex);
185        }
186    
187        /**
188         * Opens a resource from file or classpath.
189         * 
190         * @param name  the name to open
191         * @return the input stream
192         * @throws IOException if an error occurs
193         */
194        private InputStream openResource(String name) throws IOException {
195            InputStream in;
196            if (iFileDir != null) {
197                in = new FileInputStream(new File(iFileDir, name));
198            } else {
199                String path = iResourcePath.concat(name);
200                if (iLoader != null) {
201                    in = iLoader.getResourceAsStream(path);
202                } else {
203                    in = ClassLoader.getSystemResourceAsStream(path);
204                }
205                if (in == null) {
206                    StringBuffer buf = new StringBuffer(40)
207                        .append("Resource not found: \"")
208                        .append(path)
209                        .append("\" ClassLoader: ")
210                        .append(iLoader != null ? iLoader.toString() : "system");
211                    throw new IOException(buf.toString());
212                }
213            }
214            return in;
215        }
216    
217        /**
218         * Loads the time zone data for one id.
219         * 
220         * @param id  the id to load
221         * @return the zone
222         */
223        private DateTimeZone loadZoneData(String id) {
224            InputStream in = null;
225            try {
226                in = openResource(id);
227                DateTimeZone tz = DateTimeZoneBuilder.readFrom(in, id);
228                iZoneInfoMap.put(id, new SoftReference<DateTimeZone>(tz));
229                return tz;
230            } catch (IOException ex) {
231                uncaughtException(ex);
232                iZoneInfoMap.remove(id);
233                return null;
234            } finally {
235                try {
236                    if (in != null) {
237                        in.close();
238                    }
239                } catch (IOException ex) {
240                }
241            }
242        }
243    
244        //-----------------------------------------------------------------------
245        /**
246         * Loads the zone info map.
247         * 
248         * @param in  the input stream
249         * @return the map
250         */
251        private static Map<String, Object> loadZoneInfoMap(InputStream in) throws IOException {
252            Map<String, Object> map = new ConcurrentHashMap<String, Object>();
253            DataInputStream din = new DataInputStream(in);
254            try {
255                readZoneInfoMap(din, map);
256            } finally {
257                try {
258                    din.close();
259                } catch (IOException ex) {
260                }
261            }
262            map.put("UTC", new SoftReference<DateTimeZone>(DateTimeZone.UTC));
263            return map;
264        }
265    
266        /**
267         * Reads the zone info map from file.
268         * 
269         * @param din  the input stream
270         * @param zimap  gets filled with string id to string id mappings
271         */
272        private static void readZoneInfoMap(DataInputStream din, Map<String, Object> zimap) throws IOException {
273            // Read the string pool.
274            int size = din.readUnsignedShort();
275            String[] pool = new String[size];
276            for (int i=0; i<size; i++) {
277                pool[i] = din.readUTF().intern();
278            }
279    
280            // Read the mappings.
281            size = din.readUnsignedShort();
282            for (int i=0; i<size; i++) {
283                try {
284                    zimap.put(pool[din.readUnsignedShort()], pool[din.readUnsignedShort()]);
285                } catch (ArrayIndexOutOfBoundsException ex) {
286                    throw new IOException("Corrupt zone info map");
287                }
288            }
289        }
290    
291    }