All Downloads are FREE. Search and download functionalities are using the official Maven repository.

java.nio.channels.WritableByteChannel Maven / Gradle / Ivy

Go to download

A library jar that provides APIs for Applications written for the Google Android Platform.

There is a newer version: 14-robolectric-10818077
Show newest version
/* Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package java.nio.channels;

import java.io.IOException;
import java.nio.ByteBuffer;

/**
 * A {@code WritableByteChannel} is a type of {@link Channel} that can write
 * bytes.
 * 

* Write operations are synchronous on a {@code WritableByteChannel}, that is, * if a write is already in progress on the channel then subsequent writes will * block until the first write completes. It is undefined whether non-write * operations will block. */ public interface WritableByteChannel extends Channel { /** * Writes bytes from the given buffer to the channel. *

* The maximum number of bytes that will be written is the * remaining() number of bytes in the buffer when the method * invoked. The bytes will be written from the buffer starting at the * buffer's position. *

* The call may block if other threads are also attempting to write on the * same channel. *

* Upon completion, the buffer's position() is updated to the * end of the bytes that were written. The buffer's limit() * is unmodified. * * @param buffer * the byte buffer containing the bytes to be written. * @return the number of bytes actually written. * @throws NonWritableChannelException * if the channel was not opened for writing. * @throws ClosedChannelException * if the channel was already closed. * @throws AsynchronousCloseException * if another thread closes the channel during the write. * @throws ClosedByInterruptException * if another thread interrupt the calling thread during the * write. * @throws IOException * another IO exception occurs, details are in the message. */ public int write(ByteBuffer buffer) throws IOException; }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy