SHOW Signed

net.rim.device.api.io
Interface SocketConnectionEnhanced

All Known Implementing Classes:
SSL30Connection, TLS10Connection

public interface SocketConnectionEnhanced

This class is provides extensions to javax.microedition.io.SocketConnection. It provides additional socket configuration abilities.

Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 4.1.0

Field Summary
 Category: Signed static short READ_TIMEOUT
          Socket option for the time in milliseconds to wait for blocking read calls. (254)
 
Method Summary
 Category: Signed  long getSocketOptionEx(short option)
          Get a socket option for this connection.
 Category: Signed  void setSocketOptionEx(short option, long value)
          Set a socket option for this connection.
 

Field Detail

READ_TIMEOUT

public static final short READ_TIMEOUT
Socket option for the time in milliseconds to wait for blocking read calls. (254)
Since:
JDE 4.1.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail

setSocketOptionEx

public void setSocketOptionEx(short option,
                              long value)
                       throws IllegalArgumentException,
                              IOException
Set a socket option for this connection. This is a extended API allowing more options to be set than the ones available in javax.microedition.io.
Parameters:
option - socket option identifier
value - value for specified option
Throws:
IllegalArgumentException - if the value is not valid (e.g. negative value) or if the option identifier is not valid
IOException - if the connection was closed
Since:
JDE 4.1.0
See Also:
getSocketOptionEx(short)
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

getSocketOptionEx

public long getSocketOptionEx(short option)
                       throws IllegalArgumentException,
                              IOException
Get a socket option for this connection. This is a extended API allowing more options to be queried than the ones available in javax.microedition.io.
Parameters:
option - socket option identifier
Returns:
numeric value for specified option or -1 if the value is not available.
Throws:
IllegalArgumentException - if the option identifier is not valid
IOException - if the connection was closed
Since:
JDE 4.1.0
See Also:
setSocketOptionEx(short, long)
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.