OSGi™ Service Platform
Release 4

org.osgi.service.io
Interface ConnectionFactory


public interface ConnectionFactory

A Connection Factory service is called by the implementation of the Connector Service to create javax.microedition.io.Connection objects which implement the scheme named by IO_SCHEME. When a ConnectorService.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(java.lang.String, int, boolean) method of the selected Connection Factory will then be called to create the actual Connection object.


Field Summary
static java.lang.String IO_SCHEME
          Service property containing the scheme(s) for which this Connection Factory can create Connection objects.
 
Method Summary
 javax.microedition.io.Connection createConnection(java.lang.String name, int mode, boolean timeouts)
          Create a new Connection object for the specified URI.
 

Field Detail

IO_SCHEME

public static final java.lang.String IO_SCHEME
Service property containing the scheme(s) for which this Connection Factory can create Connection objects. This property is of type String[].

See Also:
Constant Field Values
Method Detail

createConnection

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

Parameters:
name - The full URI passed to the ConnectorService.open method
mode - The mode parameter passed to the ConnectorService.open method
timeouts - The timeouts parameter passed to the ConnectorService.open method
Returns:
A new javax.microedition.io.Connection object.
Throws:
java.io.IOException - If a javax.microedition.io.Connection object can not not be created.

OSGi™ Service Platform
Release 4

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