1062N/A * Copyright (c) 2005, 2011, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 553N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 553N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 553N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 553N/A * or visit www.oracle.com if you need additional information or have any 0N/A * The FilerImplementation class must maintain a number of 0N/A * constraints. First, multiple attempts to open the same path within 0N/A * the same invocation of the tool results in an IOException being 0N/A * thrown. For example, trying to open the same source file twice: 0N/A * createSourceFile("foo.Bar") 0N/A * createSourceFile("foo.Bar") 0N/A * is disallowed as is opening a text file that happens to have 0N/A * the same name as a source file: 0N/A * createSourceFile("foo.Bar") 0N/A * createTextFile(SOURCE_TREE, "foo", new File("Bar"), null) 0N/A * <p>Additionally, creating a source file that corresponds to an 0N/A * already created class file (or vice versa) also results in an 0N/A * IOException since each type can only be created once. However, if 0N/A * the Filer is used to create a text file named *.java that happens 0N/A * to correspond to an existing class file, a warning is *not* 0N/A * generated. Similarly, a warning is not generated for a binary file 0N/A * named *.class and an existing source file. 0N/A * <p>The reason for this difference is that source files and class 0N/A * files are registered with the tool and can get passed on as 0N/A * declarations to the next round of processing. Files that are just 0N/A * named *.java and *.class are not processed in that manner; although 0N/A * having extra source files and class files on the source path and 0N/A * class path can alter the behavior of the tool and any final 580N/A * <p><b>This is NOT part of any supported API. 0N/A * If you write code that depends on this, you do so at your own risk. 0N/A * This code and its internal interfaces are subject to change or 0N/A * deletion without notice.</b> 0N/A // TODO: Implement different transaction model for updating the 0N/A // Filer's record keeping on file close. 0N/A "Output stream or writer has already been opened.";
0N/A "FileObject was not opened for reading.";
0N/A "FileObject was not opened for writing.";
0N/A * Wrap a JavaFileObject to manage writing by the Filer. 0N/A // Three anti-literacy methods 0N/A * Wrap a JavaFileObject to manage reading by the Filer. 0N/A * Wrap a {@code OutputStream} returned from the {@code 0N/A * JavaFileManager} to properly register source or class files 0N/A * when they are closed. 0N/A * @param typeName name of class or {@code null} if just a 0N/A * If an IOException occurs when closing the underlying 0N/A * stream, still try to process the file. 0N/A * Wrap a {@code Writer} returned from the {@code JavaFileManager} 0N/A * to properly register source or class files when they are 0N/A * @param fileObject the fileObject to be written to 0N/A * @param typeName name of source file or {@code null} if just a 0N/A * If an IOException occurs when closing the underlying 0N/A * Writer, still try to process the file. 0N/A * Logical names of all created files. This set must be 0N/A * Names of types that have had files created but not closed. 0N/A * Names of source files closed in this round. This set must be 0N/A * synchronized. Its iterators should preserve insertion order. 0N/A * Names and class files of the class files closed in this round. 0N/A * This set must be synchronized. Its iterators should preserve 0N/A * JavaFileObjects for source files closed in this round. This 0N/A * set must be synchronized. Its iterators should preserve 0N/A * Names of all created source files. Its iterators should 0N/A * preserve insertion order. 0N/A * Names of all created class files. Its iterators should 0N/A * preserve insertion order. 0N/A // TODO: Only support reading resources in selected output 0N/A // locations? Only allow reading of non-source, non-class 0N/A // files from the supported input locations? 1062N/A // In the following, getFileForInput is the "obvious" method 1062N/A // to use, but it does not have the "obvious" semantics for 1062N/A // SOURCE_OUTPUT and CLASS_OUTPUT. Conversely, getFileForOutput 1062N/A // does not have the correct semantics for any "path" location 1062N/A // with more than one component. So, for now, we use a hybrid 0N/A // If the path was already opened for writing, throw an exception. 0N/A // Is the name of the form "package-info" or 0N/A // "foo.bar.package-info"? 0N/A // "foo.bar.package-info." illegal 0N/A // TODO: Check if type already exists on source or class path? 0N/A // If so, use warning message key proc.type.already.exists 0N/A * Check to see if the file has already been opened; if so, throw 0N/A * an exception, otherwise add it to the set of files. 0N/A * Update internal state for a new round. 0N/A // Cross-round state 0N/A * Debugging function to display internal state. 0N/A return "javac Filer";
0N/A * Upon close, register files opened by create{Source, Class}File 0N/A * for annotation processing. 0N/A * If typeName is non-null, the file object was opened as a 0N/A * source or class file by the user. If a file was opened as 0N/A * a resource, typeName will be null and the file is *not* 0N/A * subject to annotation processing.