47 * |
47 * |
48 * <p>Some methods in this interface use class names. Such class |
48 * <p>Some methods in this interface use class names. Such class |
49 * names must be given in the Java Virtual Machine internal form of |
49 * names must be given in the Java Virtual Machine internal form of |
50 * fully qualified class and interface names. For convenience '.' |
50 * fully qualified class and interface names. For convenience '.' |
51 * and '/' are interchangeable. The internal form is defined in |
51 * and '/' are interchangeable. The internal form is defined in |
52 * chapter four of the |
52 * chapter four of |
53 * <a href="http://java.sun.com/docs/books/vmspec/2nd-edition/jvms-maintenance.html">Java |
53 * <cite>The Java™ Virtual Machine Specification</cite>. |
54 * Virtual Machine Specification</a>. |
|
55 |
54 |
56 * <blockquote><p> |
55 * <blockquote><p> |
57 * <i>Discussion:</i> this means that the names |
56 * <i>Discussion:</i> this means that the names |
58 * "java/lang.package-info", "java/lang/package-info", |
57 * "java/lang.package-info", "java/lang/package-info", |
59 * "java.lang.package-info", are valid and equivalent. Compare to |
58 * "java.lang.package-info", are valid and equivalent. Compare to |
60 * binary name as defined in the |
59 * binary name as defined in |
61 * <a href="http://java.sun.com/docs/books/jls/">Java Language |
60 * <cite>The Java™ Language Specification</cite>, |
62 * Specification (JLS)</a> section 13.1 "The Form of a Binary". |
61 * section 13.1 "The Form of a Binary". |
63 * </p></blockquote> |
62 * </p></blockquote> |
64 * |
63 * |
65 * <p>The case of names is significant. All names should be treated |
64 * <p>The case of names is significant. All names should be treated |
66 * as case-sensitive. For example, some file systems have |
65 * as case-sensitive. For example, some file systems have |
67 * case-insensitive, case-aware file names. File objects representing |
66 * case-insensitive, case-aware file names. File objects representing |
171 boolean recurse) |
170 boolean recurse) |
172 throws IOException; |
171 throws IOException; |
173 |
172 |
174 /** |
173 /** |
175 * Infers a binary name of a file object based on a location. The |
174 * Infers a binary name of a file object based on a location. The |
176 * binary name returned might not be a valid JLS binary name. |
175 * binary name returned might not be a valid binary name according to |
|
176 * <cite>The Java™ Language Specification</cite>. |
177 * |
177 * |
178 * @param location a location |
178 * @param location a location |
179 * @param file a file object |
179 * @param file a file object |
180 * @return a binary name or {@code null} the file object is not |
180 * @return a binary name or {@code null} the file object is not |
181 * found in the given location |
181 * found in the given location |