langtools/src/java.compiler/share/classes/javax/tools/JavaFileManager.java
changeset 43767 9cff98a149cb
parent 42814 058fc03646d9
child 43860 e1f41df9a00c
equal deleted inserted replaced
43648:ce7b7f98a236 43767:9cff98a149cb
   163          * @implNote This implementation returns true if the name includes
   163          * @implNote This implementation returns true if the name includes
   164          * the word "MODULE".
   164          * the word "MODULE".
   165          *
   165          *
   166          * @return true if this location is expected to contain modules
   166          * @return true if this location is expected to contain modules
   167          * @since 9
   167          * @since 9
       
   168          * @spec JPMS
   168          */
   169          */
   169         default boolean isModuleOrientedLocation() {
   170         default boolean isModuleOrientedLocation() {
   170             return getName().matches("\\bMODULE\\b");
   171             return getName().matches("\\bMODULE\\b");
   171         }
   172         }
   172     }
   173     }
   470      * @throws IOException if an I/O error occurred
   471      * @throws IOException if an I/O error occurred
   471      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   472      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   472      * @throws IllegalArgumentException if the location is neither an output location nor a
   473      * @throws IllegalArgumentException if the location is neither an output location nor a
   473      * module-oriented location
   474      * module-oriented location
   474      * @since 9
   475      * @since 9
       
   476      * @spec JPMS
   475      */ // TODO: describe failure modes
   477      */ // TODO: describe failure modes
   476     default Location getLocationForModule(Location location, String moduleName) throws IOException {
   478     default Location getLocationForModule(Location location, String moduleName) throws IOException {
   477         throw new UnsupportedOperationException();
   479         throw new UnsupportedOperationException();
   478     }
   480     }
   479 
   481 
   497      * @throws IOException if an I/O error occurred
   499      * @throws IOException if an I/O error occurred
   498      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   500      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   499      * @throws IllegalArgumentException if the location is neither an output location nor a
   501      * @throws IllegalArgumentException if the location is neither an output location nor a
   500      * module-oriented location
   502      * module-oriented location
   501      * @since 9
   503      * @since 9
       
   504      * @spec JPMS
   502      */
   505      */
   503     default Location getLocationForModule(Location location, JavaFileObject fo, String pkgName) throws IOException {
   506     default Location getLocationForModule(Location location, JavaFileObject fo, String pkgName) throws IOException {
   504         throw new UnsupportedOperationException();
   507         throw new UnsupportedOperationException();
   505     }
   508     }
   506 
   509 
   520      * @return a service loader for the given service class
   523      * @return a service loader for the given service class
   521      *
   524      *
   522      * @throws IOException if an I/O error occurred
   525      * @throws IOException if an I/O error occurred
   523      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   526      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   524      * @since 9
   527      * @since 9
       
   528      * @spec JPMS
   525      */ // TODO: describe failure modes
   529      */ // TODO: describe failure modes
   526     default <S> ServiceLoader<S> getServiceLoader(Location location, Class<S> service) throws  IOException {
   530     default <S> ServiceLoader<S> getServiceLoader(Location location, Class<S> service) throws  IOException {
   527         throw new UnsupportedOperationException();
   531         throw new UnsupportedOperationException();
   528     }
   532     }
   529 
   533 
   538      *
   542      *
   539      * @throws IOException if an I/O error occurred
   543      * @throws IOException if an I/O error occurred
   540      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   544      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   541      * @throws IllegalArgumentException if the location is not one known to this file manager
   545      * @throws IllegalArgumentException if the location is not one known to this file manager
   542      * @since 9
   546      * @since 9
       
   547      * @spec JPMS
   543      */ // TODO: describe failure modes
   548      */ // TODO: describe failure modes
   544     default String inferModuleName(Location location) throws IOException {
   549     default String inferModuleName(Location location) throws IOException {
   545         throw new UnsupportedOperationException();
   550         throw new UnsupportedOperationException();
   546     }
   551     }
   547 
   552 
   557      *
   562      *
   558      * @throws IOException if an I/O error occurred
   563      * @throws IOException if an I/O error occurred
   559      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   564      * @throws UnsupportedOperationException if this operation if not supported by this file manager
   560      * @throws IllegalArgumentException if the location is not a module-oriented location
   565      * @throws IllegalArgumentException if the location is not a module-oriented location
   561      * @since 9
   566      * @since 9
       
   567      * @spec JPMS
   562      */ // TODO: describe failure modes
   568      */ // TODO: describe failure modes
   563     default Iterable<Set<Location>> listLocationsForModules(Location location) throws IOException {
   569     default Iterable<Set<Location>> listLocationsForModules(Location location) throws IOException {
   564         throw new UnsupportedOperationException();
   570         throw new UnsupportedOperationException();
   565     }
   571     }
   566 
   572