@@ -190,16 +190,16 @@ Iterable<? extends JavaFileObject> getJavaFileObjectsFromFiles(
190
190
* Returns file objects representing the given paths.
191
191
*
192
192
* @implSpec
193
- * The default implementation converts each path to a file and calls
194
- * {@link #getJavaFileObjectsFromFiles getJavaObjectsFromFiles }.
195
- * IllegalArgumentException will be thrown if any of the paths
196
- * cannot be converted to a file.
193
+ * The default implementation lazily converts each path to a file and calls
194
+ * {@link #getJavaFileObjectsFromFiles(Iterable) getJavaFileObjectsFromFiles }.
195
+ * {@code IllegalArgumentException} will be thrown
196
+ * if any of the paths cannot be converted to a file at the point the conversion happens .
197
197
*
198
198
* @param paths a list of paths
199
199
* @return a list of file objects
200
200
* @throws IllegalArgumentException if the list of paths includes
201
201
* a directory or if this file manager does not support any of the
202
- * given paths.
202
+ * given paths
203
203
*
204
204
* @since 13
205
205
*/
@@ -229,10 +229,10 @@ public File next() {
229
229
* Returns file objects representing the given paths.
230
230
*
231
231
* @implSpec
232
- * The default implementation converts each path to a file and calls
233
- * {@link #getJavaFileObjectsFromFiles getJavaObjectsFromFiles }.
234
- * IllegalArgumentException will be thrown if any of the paths
235
- * cannot be converted to a file.
232
+ * The default implementation lazily converts each path to a file and calls
233
+ * {@link #getJavaFileObjectsFromPaths(Collection) getJavaFileObjectsFromPaths }.
234
+ * {@code IllegalArgumentException} will be thrown
235
+ * if any of the paths cannot be converted to a file at the point the conversion happens .
236
236
*
237
237
* @param paths a list of paths
238
238
* @return a list of file objects
@@ -273,7 +273,8 @@ default Iterable<? extends JavaFileObject> getJavaFileObjectsFromPaths(
273
273
* @param files an array of files
274
274
* @return a list of file objects
275
275
* @throws IllegalArgumentException if the array of files includes
276
- * a directory
276
+ * a directory or if this file manager does not support any of the
277
+ * given paths
277
278
* @throws NullPointerException if the given array contains null
278
279
* elements
279
280
*/
@@ -287,10 +288,15 @@ default Iterable<? extends JavaFileObject> getJavaFileObjectsFromPaths(
287
288
* getJavaFileObjectsFromPaths({@linkplain java.util.Arrays#asList Arrays.asList}(paths))
288
289
* </pre>
289
290
*
291
+ * @implSpec
292
+ * The default implementation will only throw {@code NullPointerException}
293
+ * if {@linkplain #getJavaFileObjectsFromPaths(Collection)} throws it.
294
+ *
290
295
* @param paths an array of paths
291
296
* @return a list of file objects
292
297
* @throws IllegalArgumentException if the array of files includes
293
- * a directory
298
+ * a directory or if this file manager does not support any of the
299
+ * given paths
294
300
* @throws NullPointerException if the given array contains null
295
301
* elements
296
302
*
@@ -357,10 +363,10 @@ void setLocation(Location location, Iterable<? extends File> files)
357
363
* will be cancelled.
358
364
*
359
365
* @implSpec
360
- * The default implementation converts each path to a file and calls
361
- * {@link #getJavaFileObjectsFromFiles getJavaObjectsFromFiles }.
362
- * {@linkplain IllegalArgumentException IllegalArgumentException}
363
- * will be thrown if any of the paths cannot be converted to a file .
366
+ * The default implementation lazily converts each path to a file and calls
367
+ * {@link #setLocation setLocation }.
368
+ * {@code IllegalArgumentException} will be thrown if any of the paths cannot
369
+ * be converted to a file at the point the conversion happens .
364
370
*
365
371
* @param location a location
366
372
* @param paths a list of paths, if {@code null} use the default
0 commit comments