equal
deleted
inserted
replaced
59 * pool or volume. |
59 * pool or volume. |
60 * |
60 * |
61 * <p> The string returned by this method may differ from the string |
61 * <p> The string returned by this method may differ from the string |
62 * returned by the {@link Object#toString() toString} method. |
62 * returned by the {@link Object#toString() toString} method. |
63 * |
63 * |
64 * @return The name of this file store |
64 * @return the name of this file store |
65 */ |
65 */ |
66 public abstract String name(); |
66 public abstract String name(); |
67 |
67 |
68 /** |
68 /** |
69 * Returns the <em>type</em> of this file store. The format of the string |
69 * Returns the <em>type</em> of this file store. The format of the string |
70 * returned by this method is highly implementation specific. It may |
70 * returned by this method is highly implementation specific. It may |
71 * indicate, for example, the format used or if the file store is local |
71 * indicate, for example, the format used or if the file store is local |
72 * or remote. |
72 * or remote. |
73 * |
73 * |
74 * @return A string representing the type of this file store |
74 * @return a string representing the type of this file store |
75 */ |
75 */ |
76 public abstract String type(); |
76 public abstract String type(); |
77 |
77 |
78 /** |
78 /** |
79 * Tells whether this file store is read-only. A file store is read-only if |
79 * Tells whether this file store is read-only. A file store is read-only if |
94 * the default provider, this method cannot guarantee to give the correct |
94 * the default provider, this method cannot guarantee to give the correct |
95 * result when the file store is not a local storage device. The reasons for |
95 * result when the file store is not a local storage device. The reasons for |
96 * this are implementation specific and therefore unspecified. |
96 * this are implementation specific and therefore unspecified. |
97 * |
97 * |
98 * @param type |
98 * @param type |
99 * The file attribute view type |
99 * the file attribute view type |
100 * |
100 * |
101 * @return {@code true} if, and only if, the file attribute view is |
101 * @return {@code true} if, and only if, the file attribute view is |
102 * supported |
102 * supported |
103 */ |
103 */ |
104 public abstract boolean supportsFileAttributeView(Class<? extends FileAttributeView> type); |
104 public abstract boolean supportsFileAttributeView(Class<? extends FileAttributeView> type); |
113 * method cannot guarantee to give the correct result when the file store is |
113 * method cannot guarantee to give the correct result when the file store is |
114 * not a local storage device. The reasons for this are implementation |
114 * not a local storage device. The reasons for this are implementation |
115 * specific and therefore unspecified. |
115 * specific and therefore unspecified. |
116 * |
116 * |
117 * @param name |
117 * @param name |
118 * The {@link FileAttributeView#name name} of file attribute view |
118 * the {@link FileAttributeView#name name} of file attribute view |
119 * |
119 * |
120 * @return {@code true} if, and only if, the file attribute view is |
120 * @return {@code true} if, and only if, the file attribute view is |
121 * supported |
121 * supported |
122 */ |
122 */ |
123 public abstract boolean supportsFileAttributeView(String name); |
123 public abstract boolean supportsFileAttributeView(String name); |
135 * provides access to space attributes. In that case invoking this method |
135 * provides access to space attributes. In that case invoking this method |
136 * with a parameter value of {@code FileStoreSpaceAttributeView.class} will |
136 * with a parameter value of {@code FileStoreSpaceAttributeView.class} will |
137 * always return an instance of that class. |
137 * always return an instance of that class. |
138 * |
138 * |
139 * @param type |
139 * @param type |
140 * The {@code Class} object corresponding to the attribute view |
140 * the {@code Class} object corresponding to the attribute view |
141 * |
141 * |
142 * @return A file store attribute view of the specified type or |
142 * @return a file store attribute view of the specified type or |
143 * {@code null} if the attribute view is not available |
143 * {@code null} if the attribute view is not available |
144 */ |
144 */ |
145 public abstract <V extends FileStoreAttributeView> V |
145 public abstract <V extends FileStoreAttributeView> V |
146 getFileStoreAttributeView(Class<V> type); |
146 getFileStoreAttributeView(Class<V> type); |
147 |
147 |
158 * provides access to space attributes. In that case invoking this method |
158 * provides access to space attributes. In that case invoking this method |
159 * with a parameter value of {@code "space"} will always return an instance |
159 * with a parameter value of {@code "space"} will always return an instance |
160 * of that class. |
160 * of that class. |
161 * |
161 * |
162 * @param name |
162 * @param name |
163 * The name of the attribute view |
163 * the name of the attribute view |
164 * |
164 * |
165 * @return A file store attribute view of the given name, or {@code null} |
165 * @return a file store attribute view of the given name, or {@code null} |
166 * if the attribute view is not available |
166 * if the attribute view is not available |
167 */ |
167 */ |
168 public abstract FileStoreAttributeView getFileStoreAttributeView(String name); |
168 public abstract FileStoreAttributeView getFileStoreAttributeView(String name); |
169 } |
169 } |