Package org.osgi.service.device
Interface DriverLocator
-
public interface DriverLocator
A Driver Locator service can find and load device driver bundles given a property set. Each driver is represented by a uniqueDRIVER_ID
.Driver Locator services provide the mechanism for dynamically downloading new device driver bundles into an OSGi environment. They are supplied by providers and encapsulate all provider-specific details related to the location and acquisition of driver bundles.
- See Also:
Driver
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.lang.String[]
findDrivers(java.util.Dictionary<java.lang.String,?> props)
Returns an array ofDRIVER_ID
strings of drivers capable of attaching to a device with the given properties.java.io.InputStream
loadDriver(java.lang.String id)
Get anInputStream
from which the driver bundle providing a driver with the givingDRIVER_ID
can be installed.
-
-
-
Method Detail
-
findDrivers
java.lang.String[] findDrivers(java.util.Dictionary<java.lang.String,?> props)
Returns an array ofDRIVER_ID
strings of drivers capable of attaching to a device with the given properties.The property keys in the specified
Dictionary
objects are case-insensitive.- Parameters:
props
- the properties of the device for which a driver is sought- Returns:
- array of driver
DRIVER_ID
strings of drivers capable of attaching to a Device service with the given properties, ornull
if this Driver Locator service does not know of any such drivers
-
loadDriver
java.io.InputStream loadDriver(java.lang.String id) throws java.io.IOException
Get anInputStream
from which the driver bundle providing a driver with the givingDRIVER_ID
can be installed.- Parameters:
id
- theDRIVER_ID
of the driver that needs to be installed.- Returns:
- An
InputStream
object from which the driver bundle can be installed ornull
if the driver with the given ID cannot be located - Throws:
java.io.IOException
- the input stream for the bundle cannot be created
-
-