SocketConnection is a basic StreamConnection for network communications. It works much like HttpConnection. However, it has no particular understanding of HTTP or any other protocol. It just opens a standard TCP socket to a specified host and relies on your code to tell it what to do with the input and output from that host.

Socket URLs look like this:


This indicates a TCP connection to on port 13.

Opening SocketConnection is straightforward and works much like opening any other sort of connection:

Connection connection ="socket://");

If you don need to set any special socket options, you can use one of the four open stream methods, and proceed as you would with any other connection. Example 24-1 used the socket protocol.

Most of the time thats all you need. However, SocketConnection does have six unique methods of its own. To use these, you must first cast the connection object returned by open( ) to SocketConnection:

SocketConnection socket = (SocketConnection) connection;

.6.1. Getters

First, there are four getter methods that return the address and port of the remote and local hosts the socket connects:

public String getAddress( ) throws IOException
public int getPort( ) throws IOException
public int getLocalPort( ) throws IOException
public String getLocalAddress( ) throws IOException

J2ME doesn include the InetAddress class, so the host addresses are all returned as strings like "" or "FEDC::DC:0:7076:10". Theres no method to get the hostname, because devices where J2ME runs are unlikely to have hostnames.

These methods all throw an IOException if the socket has been closed.

.6.2. Socket Options

J2ME devices often have different network characteristics than typical desktop and server systems. They may have very limited, unreliable, or sporadic bandwidth. As a result, it may be important to change socket options to better fit the characteristics of the network. The getSocketOption( ) and setSocketOption( ) methods enable this:

public void setSocketOption(byte option, int value)
 throws IllegalArgumentException, IOException
public int getSocketOption(byte option)
 throws IllegalArgumentException, IOException

Socket options must be set before the socket is connected; that is, before you ask a connection for its input or output stream.

J2ME recognizes five socket options, each referenced as a named constant in the SocketConnection class:


Nonzero to enable Nagles algorithm; zero to disable Nagles algorithm


Number of seconds to wait before closing a connection with pending data to write


Nonzero to enable keepalive; zero to disable keepalive


Size in bytes of the send buffer


Size in bytes of the receive buffer

Picking an option not in this list throws an IllegalArgumentException.

Basic I/O

Introducing I/O

Output Streams

Input Streams

Data Sources

File Streams

Network Streams

Filter Streams

Filter Streams

Print Streams

Data Streams

Streams in Memory

Compressing Streams

JAR Archives

Cryptographic Streams

Object Serialization

New I/O



Nonblocking I/O

The File System

Working with Files

File Dialogs and Choosers


Character Sets and Unicode

Readers and Writers

Formatted I/O with java.text


The Java Communications API


The J2ME Generic Connection Framework


Character Sets

Java I/O
Java I/O
ISBN: 0596527500
EAN: 2147483647
Year: 2004
Pages: 244 © 2008-2020.
If you may any questions please contact us: