File	Doc	Category	Size	Date	Package
Socket.java	API Doc	J2ME MIDP 2.0	6566	Thu Nov 07 12:02:22 GMT 2002	com.sun.midp.io.j2me.serversocket

Socket

• java.lang.Object

Fields Summary
private int	handle Socket object used by native code, for now must be the first field.
boolean	connectionOpen Flag to indicate connection is currently open.

Constructors Summary

Methods Summary
private native int	accept() Accepts a TCP connection socket handle to a client, accesses the handle field. return TCP connection socket handle exception IOException If some other kind of I/O error occurs.
public synchronized StreamConnection	acceptAndOpen() Returns a connection that represents a server side socket connection. Polling the native code is done here to allow for simple asynchronous native code to be written. Not all implementations work this way (they block in the native code) but the same Java code works for both. return a socket to communicate with a client. exception IOException if an I/O error occurs when creating the input stream com.sun.midp.io.j2me.socket.Protocol con; ensureOpen(); while (true) { int handle = accept(); if (handle >= 0) { con = new com.sun.midp.io.j2me.socket.Protocol(); con.open(handle); break; } /* Wait a while for I/O to become ready */ GeneralBase.iowait(); } return con;
public void	close() Closes the connection, accesses the handle field. exception IOException if an I/O error occurs when closing the connection if (connectionOpen) { close0(); connectionOpen = false; }
public native void	close0() Closes the connection, accesses the handle field. exception IOException if an I/O error occurs when closing the connection
void	ensureOpen() Checks if the connection is open. exception IOException is thrown, if the stream is not open if (!connectionOpen) { throw new IOException("Connection closed"); }
private native void	finalize() Native finalizer
public java.lang.String	getLocalAddress() Gets the local address to which the socket is bound. The host address(IP number) that can be used to connect to this end of the socket connection from an external system. Since IP addresses may be dynamically assigned, a remote application will need to be robust in the face of IP number reasssignment. The local hostname (if available) can be accessed from System.getProperty("microedition.hostname") return the local address to which the socket is bound exception IOException if the connection was closed see ServerSocketConnection ensureOpen(); return getLocalAddress0();
private native java.lang.String	getLocalAddress0() Gets the requested printable IP number. return the IP address as a String
public int	getLocalPort() Returns the local port to which this socket is bound. return the local port number to which this socket is connected exception IOException if the connection was closed see ServerSocketConnection ensureOpen(); return getLocalPort0();
private native int	getLocalPort0() Returns the local port to which this socket is bound. return the local port number to which this socket is connected
public void	open(int port) Opens a port to listen on. param port TCP to listen on exception IOException if some other kind of I/O error occurs Scheduler scheduler = Scheduler.getScheduler(); MIDletSuite midletSuite = scheduler.getMIDletSuite(); String root = midletSuite.getStorageName(); byte[] asciiStorage = Util.toCString(root); open0(port > 0 ? port : 0, asciiStorage); connectionOpen = true; port = getLocalPort(); // check permission after the open so we can get the assigned port try { // When asking permission use Internet protocol name. midletSuite.checkForPermission(Permissions.TCP_SERVER, "TCP://:" + port); } catch (SecurityException e) { close(); throw e; } catch (InterruptedException ie) { throw new InterruptedIOException( "Interrupted while trying to ask the user permission"); } registerCleanup();
public native void	open0(int port, byte[] storage) Opens a native socket and put its handle in the handle field. Called by socket Protocol class after it parses a given URL and finds no host. param port TCP port to listen for connections on param storage name of current suite storage exception IOException if some other kind of I/O error occurs or if reserved by another suite
private native void	registerCleanup() Registers with the native cleanup code, accesses the handle field.