284 * then it is assumed to be the fully-qualified class name of a service |
284 * then it is assumed to be the fully-qualified class name of a service |
285 * type. The entries in the file are assumed to be the fully-qualified |
285 * type. The entries in the file are assumed to be the fully-qualified |
286 * class names of provider classes. </p></li> |
286 * class names of provider classes. </p></li> |
287 * |
287 * |
288 * <li><p> If the JAR file has a {@code Main-Class} attribute in its |
288 * <li><p> If the JAR file has a {@code Main-Class} attribute in its |
289 * main manifest then its value is the module {@link |
289 * main manifest, its value is a legal class name, and its package is |
290 * ModuleDescriptor#mainClass() main class}. </p></li> |
290 * in the set of packages derived for the module, then the value is the |
|
291 * module {@linkplain ModuleDescriptor#mainClass() main class}. </p></li> |
291 * |
292 * |
292 * </ul> |
293 * </ul> |
293 * |
294 * |
294 * <p> If a {@code ModuleDescriptor} cannot be created (by means of the |
295 * <p> If a {@code ModuleDescriptor} cannot be created (by means of the |
295 * {@link ModuleDescriptor.Builder ModuleDescriptor.Builder} API) for an |
296 * {@link ModuleDescriptor.Builder ModuleDescriptor.Builder} API) for an |
296 * automatic module then {@code FindException} is thrown. This can arise |
297 * automatic module then {@code FindException} is thrown. This can arise |
297 * when a legal module name cannot be derived from the file name of the JAR |
298 * when a legal module name cannot be derived from the file name of the JAR |
298 * file, where the JAR file contains a {@code .class} in the top-level |
299 * file, where the JAR file contains a {@code .class} in the top-level |
299 * directory of the JAR file, where an entry in a service configuration |
300 * directory of the JAR file, where an entry in a service configuration |
300 * file is not a legal class name or its package name is not in the set of |
301 * file is not a legal class name or its package name is not in the set of |
301 * packages derived for the module, or where the module main class is not |
302 * packages derived for the module. </p> |
302 * a legal class name or its package is not in the module. </p> |
|
303 * |
303 * |
304 * <p> In addition to JAR files, an implementation may also support modules |
304 * <p> In addition to JAR files, an implementation may also support modules |
305 * that are packaged in other implementation specific module formats. If |
305 * that are packaged in other implementation specific module formats. If |
306 * an element in the array specified to this method is a path to a directory |
306 * an element in the array specified to this method is a path to a directory |
307 * of modules then entries in the directory that not recognized as modules |
307 * of modules then entries in the directory that not recognized as modules |