org.apache.commons.net.tftp
public class TFTP extends DatagramSocketClient
Details regarding the TFTP protocol and the format of TFTP packets can be found in RFC 783. But the point of these classes is to keep you from having to worry about the internals.
See Also: DatagramSocketClient TFTPPacket TFTPPacketException
Field Summary | |
---|---|
static int | ASCII_MODE
The ascii transfer mode. |
static int | BINARY_MODE
The binary transfer mode. |
static int | DEFAULT_PORT
The default TFTP port according to RFC 783 is 69.
|
static int | DEFAULT_TIMEOUT
The default number of milliseconds to wait to receive a datagram
before timing out. |
static int | IMAGE_MODE
The image transfer mode. |
static int | NETASCII_MODE
The netascii transfer mode. |
static int | OCTET_MODE
The octet transfer mode. |
Constructor Summary | |
---|---|
TFTP()
Creates a TFTP instance with a default timeout of DEFAULT_TIMEOUT,
a null socket, and buffered operations disabled.
|
Method Summary | |
---|---|
void | beginBufferedOps()
Initializes the internal buffers. |
TFTPPacket | bufferedReceive()
This is a special method to perform a more efficient packet receive.
|
void | bufferedSend(TFTPPacket packet)
This is a special method to perform a more efficient packet send.
|
void | discardPackets()
This method synchronizes a connection by discarding all packets that
may be in the local socket buffer. |
void | endBufferedOps()
Releases the resources used to perform buffered sends and receives.
|
static String | getModeName(int mode)
Returns the TFTP string representation of a TFTP transfer mode.
|
TFTPPacket | receive()
Receives a TFTPPacket.
|
void | send(TFTPPacket packet)
Sends a TFTP packet to its destination.
|
Returns: The TFTPPacket received.
Throws: InterruptedIOException If a socket timeout occurs. The Java documentation claims an InterruptedIOException is thrown on a DatagramSocket timeout, but in practice we find a SocketException is thrown. You should catch both to be safe. SocketException If a socket timeout occurs. The Java documentation claims an InterruptedIOException is thrown on a DatagramSocket timeout, but in practice we find a SocketException is thrown. You should catch both to be safe. IOException If some other I/O error occurs. TFTPPacketException If an invalid TFTP packet is received.
Parameters: packet The TFTP packet to send.
Throws: IOException If some I/O error occurs.
Throws: IOException if an I/O error occurs.
Parameters: mode The TFTP transfer mode. One of the MODE constants.
Returns: The TFTP string representation of the TFTP transfer mode.
Returns: The TFTPPacket received.
Throws: InterruptedIOException If a socket timeout occurs. The Java documentation claims an InterruptedIOException is thrown on a DatagramSocket timeout, but in practice we find a SocketException is thrown. You should catch both to be safe. SocketException If a socket timeout occurs. The Java documentation claims an InterruptedIOException is thrown on a DatagramSocket timeout, but in practice we find a SocketException is thrown. You should catch both to be safe. IOException If some other I/O error occurs. TFTPPacketException If an invalid TFTP packet is received.
Parameters: packet The TFTP packet to send.
Throws: IOException If some I/O error occurs.