duke@1: /*
jjg@1230:  * Copyright (c) 2006, 2012, Oracle and/or its affiliates. All rights reserved.
duke@1:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
duke@1:  *
duke@1:  * This code is free software; you can redistribute it and/or modify it
duke@1:  * under the terms of the GNU General Public License version 2 only, as
ohair@554:  * published by the Free Software Foundation.  Oracle designates this
duke@1:  * particular file as subject to the "Classpath" exception as provided
ohair@554:  * by Oracle in the LICENSE file that accompanied this code.
duke@1:  *
duke@1:  * This code is distributed in the hope that it will be useful, but WITHOUT
duke@1:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
duke@1:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
duke@1:  * version 2 for more details (a copy is included in the LICENSE file that
duke@1:  * accompanied this code).
duke@1:  *
duke@1:  * You should have received a copy of the GNU General Public License version
duke@1:  * 2 along with this work; if not, write to the Free Software Foundation,
duke@1:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
duke@1:  *
ohair@554:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@554:  * or visit www.oracle.com if you need additional information or have any
ohair@554:  * questions.
duke@1:  */
duke@1: 
duke@1: package javax.tools;
duke@1: 
duke@1: import javax.tools.JavaFileManager.Location;
duke@1: 
duke@1: import java.util.concurrent.*;
duke@1: 
duke@1: /**
duke@1:  * Standard locations of file objects.
duke@1:  *
duke@1:  * @author Peter von der Ahé
duke@1:  * @since 1.6
duke@1:  */
duke@1: public enum StandardLocation implements Location {
duke@1: 
duke@1:     /**
duke@1:      * Location of new class files.
duke@1:      */
duke@1:     CLASS_OUTPUT,
duke@1: 
duke@1:     /**
duke@1:      * Location of new source files.
duke@1:      */
duke@1:     SOURCE_OUTPUT,
duke@1: 
duke@1:     /**
duke@1:      * Location to search for user class files.
duke@1:      */
duke@1:     CLASS_PATH,
duke@1: 
duke@1:     /**
duke@1:      * Location to search for existing source files.
duke@1:      */
duke@1:     SOURCE_PATH,
duke@1: 
duke@1:     /**
duke@1:      * Location to search for annotation processors.
duke@1:      */
duke@1:     ANNOTATION_PROCESSOR_PATH,
duke@1: 
duke@1:     /**
duke@1:      * Location to search for platform classes.  Sometimes called
duke@1:      * the boot class path.
duke@1:      */
jjg@1230:     PLATFORM_CLASS_PATH,
jjg@1230: 
jjg@1230:     /**
jjg@1230:      * Location of new native header files.
jjg@1230:      * @since 1.8
jjg@1230:      */
jjg@1230:     NATIVE_HEADER_OUTPUT;
duke@1: 
duke@1:     /**
duke@1:      * Gets a location object with the given name.  The following
duke@1:      * property must hold: {@code locationFor(x) ==
duke@1:      * locationFor(y)} if and only if {@code x.equals(y)}.
duke@1:      * The returned location will be an output location if and only if
duke@1:      * name ends with {@code "_OUTPUT"}.
duke@1:      *
duke@1:      * @param name a name
duke@1:      * @return a location
duke@1:      */
duke@1:     public static Location locationFor(final String name) {
duke@1:         if (locations.isEmpty()) {
duke@1:             // can't use valueOf which throws IllegalArgumentException
duke@1:             for (Location location : values())
duke@1:                 locations.putIfAbsent(location.getName(), location);
duke@1:         }
duke@1:         locations.putIfAbsent(name.toString(/* null-check */), new Location() {
duke@1:                 public String getName() { return name; }
duke@1:                 public boolean isOutputLocation() { return name.endsWith("_OUTPUT"); }
duke@1:             });
duke@1:         return locations.get(name);
duke@1:     }
duke@1:     //where
vromero@1442:         private static final ConcurrentMap<String,Location> locations
duke@1:             = new ConcurrentHashMap<String,Location>();
duke@1: 
duke@1:     public String getName() { return name(); }
duke@1: 
duke@1:     public boolean isOutputLocation() {
jjg@1230:         switch (this) {
jjg@1230:             case CLASS_OUTPUT:
jjg@1230:             case SOURCE_OUTPUT:
jjg@1230:             case NATIVE_HEADER_OUTPUT:
jjg@1230:                 return true;
jjg@1230:             default:
jjg@1230:                 return false;
jjg@1230:         }
duke@1:     }
duke@1: }