java.nio.channels

Class DatagramChannel

Implemented Interfaces:
AutoCloseable, ByteChannel, Channel, Closeable, GatheringByteChannel, InterruptibleChannel, ReadableByteChannel, ScatteringByteChannel, WritableByteChannel
Known Direct Subclasses:
DatagramChannelImpl

public abstract class DatagramChannel
extends AbstractSelectableChannel
implements ByteChannel, ScatteringByteChannel, GatheringByteChannel

Since:
1.4

Constructor Summary

DatagramChannel(SelectorProvider provider)
Initializes the channel.

Method Summary

abstract DatagramChannel
connect(SocketAddress remote)
Connects this channel's socket.
abstract DatagramChannel
disconnect()
Disonnects this channel's socket.
abstract boolean
isConnected()
Tells whether or not this channel's socket is connected.
static DatagramChannel
open()
Opens a datagram channel.
abstract int
read(ByteBuffer dst)
Reads data from this channel.
long
read(ByteBuffer[] dsts)
Reads data from this channel.
abstract long
read(ByteBuffer[] dsts, int offset, int length)
Reads data from this channel.
abstract SocketAddress
receive(ByteBuffer dst)
Receives a datagram via this channel.
abstract int
send(ByteBuffer src, SocketAddress target)
Sends a datagram via this channel.
abstract DatagramSocket
socket()
Retrieves the channel's socket.
int
validOps()
Retrieves the valid operations for this channel.
abstract int
write(ByteBuffer src)
Writes data to this channel.
long
write(ByteBuffer[] srcs)
Writes data to this channel.
abstract long
write(ByteBuffer[] srcs, int offset, int length)
Writes data to this channel.

Methods inherited from class java.nio.channels.spi.AbstractSelectableChannel

blockingLock, configureBlocking, implCloseChannel, implCloseSelectableChannel, implConfigureBlocking, isBlocking, isRegistered, keyFor, provider, register

Methods inherited from class java.nio.channels.SelectableChannel

blockingLock, configureBlocking, isBlocking, isRegistered, keyFor, provider, register, register, validOps

Methods inherited from class java.nio.channels.spi.AbstractInterruptibleChannel

begin, close, end, implCloseChannel, isOpen

Methods inherited from class java.lang.Object

clone, equals, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DatagramChannel

protected DatagramChannel(SelectorProvider provider)
Initializes the channel.

Method Details

connect

public abstract DatagramChannel connect(SocketAddress remote)
            throws IOException
Connects this channel's socket.
Throws:
IOException - If an error occurs.
SecurityException - If a security manager has been installed and it does not permit datagrams to be sent to the given address.

disconnect

public abstract DatagramChannel disconnect()
            throws IOException
Disonnects this channel's socket.
Throws:
IOException - If an error occurs

isConnected

public abstract boolean isConnected()
Tells whether or not this channel's socket is connected.
Throws:
NotYetConnectedException - The channel's socket is not connected.

open

public static DatagramChannel open()
            throws IOException
Opens a datagram channel.
Throws:
IOException - If an error occurs

read

public abstract int read(ByteBuffer dst)
            throws IOException
Reads data from this channel.
Specified by:
read in interface ReadableByteChannel

read

public final long read(ByteBuffer[] dsts)
            throws IOException
Reads data from this channel.
Specified by:
read in interface ScatteringByteChannel

read

public abstract long read(ByteBuffer[] dsts,
                          int offset,
                          int length)
            throws IOException
Reads data from this channel.
Specified by:
read in interface ScatteringByteChannel
Throws:
IOException - If an error occurs.
NotYetConnectedException - The channel's socket is not connected.

receive

public abstract SocketAddress receive(ByteBuffer dst)
            throws IOException
Receives a datagram via this channel.
Throws:
IOException - If an error occurs
SecurityException - If a security manager has been installed and it does not permit datagrams to be sent to the given address.

send

public abstract int send(ByteBuffer src,
                         SocketAddress target)
            throws IOException
Sends a datagram via this channel.
Throws:
IOException - If an error occurs
SecurityException - If a security manager has been installed and it does not permit datagrams to be sent to the given address.

socket

public abstract DatagramSocket socket()
Retrieves the channel's socket.

validOps

public final int validOps()
Retrieves the valid operations for this channel.
Overrides:
validOps in interface SelectableChannel
Throws:
NotYetConnectedException - The channel's socket is not connected.

write

public abstract int write(ByteBuffer src)
            throws IOException
Writes data to this channel.
Specified by:
write in interface WritableByteChannel
Throws:
IOException - If an error occurs.
NotYetConnectedException - The channel's socket is not connected.

write

public final long write(ByteBuffer[] srcs)
            throws IOException
Writes data to this channel.
Specified by:
write in interface GatheringByteChannel
Throws:
IOException - If an error occurs
NotYetConnectedException - The channel's socket is not connected.

write

public abstract long write(ByteBuffer[] srcs,
                           int offset,
                           int length)
            throws IOException
Writes data to this channel.
Specified by:
write in interface GatheringByteChannel
Throws:
IOException - If an error occurs.
NotYetConnectedException - The channel's socket is not connected.

DatagramChannel.java -- Copyright (C) 2002 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.