OSGi™ Service Platform
Release 4 Version 4.1

org.osgi.service.io
Interface ConnectorService


public interface ConnectorService

The Connector Service should be called to create and open javax.microedition.io.Connection objects. When an open* method is called, the implementation of the Connector Service will examine the specified name for a scheme. The Connector Service will then look for a Connection Factory service which is registered with the service property IO_SCHEME which matches the scheme. The createConnection method of the selected Connection Factory will then be called to create the actual Connection object.

If more than one Connection Factory service is registered for a particular scheme, the service with the highest ranking (as specified in its service.ranking property) is called. If there is a tie in ranking, the service with the lowest service ID (as specified in its service.id property), that is the service that was registered first, is called. This is the same algorithm used by BundleContext.getServiceReference.


Field Summary
static int READ
          Read access mode.
static int READ_WRITE
          Read/Write access mode.
static int WRITE
          Write access mode.
 
Method Summary
 javax.microedition.io.Connection open(java.lang.String name)
          Create and open a Connection object for the specified name.
 javax.microedition.io.Connection open(java.lang.String name, int mode)
          Create and open a Connection object for the specified name and access mode.
 javax.microedition.io.Connection open(java.lang.String name, int mode, boolean timeouts)
          Create and open a Connection object for the specified name, access mode and timeouts.
 java.io.DataInputStream openDataInputStream(java.lang.String name)
          Create and open a DataInputStream object for the specified name.
 java.io.DataOutputStream openDataOutputStream(java.lang.String name)
          Create and open a DataOutputStream object for the specified name.
 java.io.InputStream openInputStream(java.lang.String name)
          Create and open an InputStream object for the specified name.
 java.io.OutputStream openOutputStream(java.lang.String name)
          Create and open an OutputStream object for the specified name.
 

Field Detail

READ

public static final int READ
Read access mode.

See Also:
"javax.microedition.io.Connector.READ", Constant Field Values

WRITE

public static final int WRITE
Write access mode.

See Also:
"javax.microedition.io.Connector.WRITE", Constant Field Values

READ_WRITE

public static final int READ_WRITE
Read/Write access mode.

See Also:
"javax.microedition.io.Connector.READ_WRITE", Constant Field Values
Method Detail

open

public javax.microedition.io.Connection open(java.lang.String name)
                                      throws java.io.IOException
Create and open a Connection object for the specified name.

Parameters:
name - The URI for the connection.
Returns:
A new javax.microedition.io.Connection object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.open(String name)"

open

public javax.microedition.io.Connection open(java.lang.String name,
                                             int mode)
                                      throws java.io.IOException
Create and open a Connection object for the specified name and access mode.

Parameters:
name - The URI for the connection.
mode - The access mode.
Returns:
A new javax.microedition.io.Connection object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.open(String name, int mode)"

open

public javax.microedition.io.Connection open(java.lang.String name,
                                             int mode,
                                             boolean timeouts)
                                      throws java.io.IOException
Create and open a Connection object for the specified name, access mode and timeouts.

Parameters:
name - The URI for the connection.
mode - The access mode.
timeouts - A flag to indicate that the caller wants timeout exceptions.
Returns:
A new javax.microedition.io.Connection object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.open"

openInputStream

public java.io.InputStream openInputStream(java.lang.String name)
                                    throws java.io.IOException
Create and open an InputStream object for the specified name.

Parameters:
name - The URI for the connection.
Returns:
An InputStream object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.openInputStream(String name)"

openDataInputStream

public java.io.DataInputStream openDataInputStream(java.lang.String name)
                                            throws java.io.IOException
Create and open a DataInputStream object for the specified name.

Parameters:
name - The URI for the connection.
Returns:
A DataInputStream object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.openDataInputStream(String name)"

openOutputStream

public java.io.OutputStream openOutputStream(java.lang.String name)
                                      throws java.io.IOException
Create and open an OutputStream object for the specified name.

Parameters:
name - The URI for the connection.
Returns:
An OutputStream object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.openOutputStream(String name)"

openDataOutputStream

public java.io.DataOutputStream openDataOutputStream(java.lang.String name)
                                              throws java.io.IOException
Create and open a DataOutputStream object for the specified name.

Parameters:
name - The URI for the connection.
Returns:
A DataOutputStream object.
Throws:
java.lang.IllegalArgumentException - If a parameter is invalid.
javax.microedition.io.ConnectionNotFoundException - If the connection cannot be found.
java.io.IOException - If some other kind of I/O error occurs.
See Also:
"javax.microedition.io.Connector.openDataOutputStream(String name)"

OSGi™ Service Platform
Release 4 Version 4.1

Copyright © OSGi Alliance (2000, 2007). All Rights Reserved. Licensed under the OSGi Specification License, Version 1.0