langtools/src/share/classes/com/sun/mirror/apt/Filer.java
changeset 3378 22011d9a9398
parent 10 06bc494ca11e
child 5520 86e4b9a9da40
equal deleted inserted replaced
3377:22083952ee8f 3378:22011d9a9398
    49  * with a given pathname may be created only once.  If that file already
    49  * with a given pathname may be created only once.  If that file already
    50  * exists before the first attempt to create it, the old contents will
    50  * exists before the first attempt to create it, the old contents will
    51  * be deleted.  Any subsequent attempt to create the same file during
    51  * be deleted.  Any subsequent attempt to create the same file during
    52  * a run will fail.
    52  * a run will fail.
    53  *
    53  *
       
    54  * @deprecated All components of this API have been superseded by the
       
    55  * standardized annotation processing API.  The replacement for the
       
    56  * functionality of this interface is {@link
       
    57  * javax.annotation.processing.Filer}.
       
    58  *
    54  * @author Joseph D. Darcy
    59  * @author Joseph D. Darcy
    55  * @author Scott Seligman
    60  * @author Scott Seligman
    56  * @since 1.5
    61  * @since 1.5
    57  */
    62  */
    58 
    63 @Deprecated
       
    64 @SuppressWarnings("deprecation")
    59 public interface Filer {
    65 public interface Filer {
    60 
    66 
    61     /**
    67     /**
    62      * Creates a new source file and returns a writer for it.
    68      * Creates a new source file and returns a writer for it.
    63      * The file's name and path (relative to the root of all newly created
    69      * The file's name and path (relative to the root of all newly created
   138                                   File relPath) throws IOException;
   144                                   File relPath) throws IOException;
   139 
   145 
   140 
   146 
   141     /**
   147     /**
   142      * Locations (subtrees within the file system) where new files are created.
   148      * Locations (subtrees within the file system) where new files are created.
       
   149      *
       
   150      * @deprecated All components of this API have been superseded by
       
   151      * the standardized annotation processing API.  The replacement
       
   152      * for the functionality of this enum is {@link
       
   153      * javax.tools.StandardLocation}.
   143      */
   154      */
       
   155     @Deprecated
   144     enum Location {
   156     enum Location {
   145         /** The location of new source files. */
   157         /** The location of new source files. */
   146         SOURCE_TREE,
   158         SOURCE_TREE,
   147         /** The location of new class files. */
   159         /** The location of new class files. */
   148         CLASS_TREE
   160         CLASS_TREE