< prev index next >

src/java.base/share/classes/java/nio/channels/FileChannel.java

Print this page

        

*** 789,799 **** // -- Memory-mapped buffers -- /** ! * A file-mapping mode. * * @since 1.4 * * @see java.nio.channels.FileChannel#map */ --- 789,799 ---- // -- Memory-mapped buffers -- /** ! * A typesafe enumeration for file-mapping modes. * * @since 1.4 * * @see java.nio.channels.FileChannel#map */
*** 817,832 **** public static final MapMode PRIVATE = new MapMode("PRIVATE"); private final String name; - /** - * Constructs an instance of this class. This constructor may be used - * by code in java.base to create file mapping modes beyond the file - * mapping modes defined here. - * @param name the name of the map mode - */ private MapMode(String name) { this.name = name; } /** --- 817,826 ----
*** 841,852 **** } /** * Maps a region of this channel's file directly into memory. * ! * <p> The {@code mode} parameter specifies how the region of the file is ! * mapped and may be one of the following modes: * * <ul> * * <li><p> <i>Read-only:</i> Any attempt to modify the resulting buffer * will cause a {@link java.nio.ReadOnlyBufferException} to be thrown. --- 835,846 ---- } /** * Maps a region of this channel's file directly into memory. * ! * <p> A region of a file may be mapped into memory in one of three modes: ! * </p> * * <ul> * * <li><p> <i>Read-only:</i> Any attempt to modify the resulting buffer * will cause a {@link java.nio.ReadOnlyBufferException} to be thrown.
*** 863,874 **** * copies of the modified portions of the buffer to be created. ({@link * MapMode#PRIVATE MapMode.PRIVATE}) </p></li> * * </ul> * - * <p> An implementation may support additional map modes. - * * <p> 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. * * <p> The {@link MappedByteBuffer <i>mapped byte buffer</i>} --- 857,866 ----
*** 898,909 **** * @param mode * One of the constants {@link MapMode#READ_ONLY READ_ONLY}, {@link * 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 * * @param position * The position within the file at which the mapped region * is to start; must be non-negative * --- 890,900 ---- * @param mode * One of the constants {@link MapMode#READ_ONLY READ_ONLY}, {@link * 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 * * @param position * The position within the file at which the mapped region * is to start; must be non-negative *
*** 912,944 **** * no greater than {@link java.lang.Integer#MAX_VALUE} * * @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 * * @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 * * @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) throws IOException; // -- Locks -- --- 903,931 ---- * no greater than {@link java.lang.Integer#MAX_VALUE} * * @return The mapped byte buffer * * @throws NonReadableChannelException ! * 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} 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 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) throws IOException; // -- Locks --
< prev index next >