The {@code mode} parameter specifies how the region of the file is
- * mapped and may be one of the following modes:
+ *

A region of a file may be mapped into memory in one of three modes:
+ *

*
*

*
@@ -865,8 +859,6 @@
*
*

*
- *

An implementation may support additional map modes.
- *
*

For a read-only mapping, this channel must have been opened for
* reading; for a read/write or private mapping, this channel must have
* been opened for both reading and writing.
@@ -900,8 +892,7 @@
* MapMode#READ_WRITE READ_WRITE}, or {@link MapMode#PRIVATE
* PRIVATE} defined in the {@link MapMode} class, according to
* whether the file is to be mapped read-only, read/write, or
- * privately (copy-on-write), respectively, or an implementation
- * specific map mode
+ * privately (copy-on-write), respectively
*
* @param position
* The position within the file at which the mapped region
@@ -914,29 +905,25 @@
* @return The mapped byte buffer
*
* @throws NonReadableChannelException
- * If the {@code mode} is {@link MapMode#READ_ONLY READ_ONLY} or
- * an implementation specific map mode requiring read access
- * but this channel was not opened for reading
+ * If the {@code mode} is {@link MapMode#READ_ONLY READ_ONLY} but
+ * this channel was not opened for reading
*
* @throws NonWritableChannelException
- * If the {@code mode} is {@link MapMode#READ_WRITE READ_WRITE}.
- * {@link MapMode#PRIVATE PRIVATE} or an implementation specific
- * map mode requiring write access but this channel was not
- * opened for both reading and writing
+ * If the {@code mode} is {@link MapMode#READ_WRITE READ_WRITE} or
+ * {@link MapMode#PRIVATE PRIVATE} but this channel was not opened
+ * for both reading and writing
*
* @throws IllegalArgumentException
* If the preconditions on the parameters do not hold
*
- * @throws UnsupportedOperationException
- * If an unsupported map mode is specified
- *
* @throws IOException
* If some other I/O error occurs
*
* @see java.nio.channels.FileChannel.MapMode
* @see java.nio.MappedByteBuffer
*/
- public abstract MappedByteBuffer map(MapMode mode, long position, long size)
+ public abstract MappedByteBuffer map(MapMode mode,
+ long position, long size)
throws IOException;