public class ExtendedLogReaderServiceFactory extends Object implements ServiceFactory<ExtendedLogReaderServiceImpl>
Constructor and Description |
---|
ExtendedLogReaderServiceFactory() |
Modifier and Type | Method and Description |
---|---|
ExtendedLogReaderServiceImpl |
getService(Bundle bundle,
ServiceRegistration<ExtendedLogReaderServiceImpl> registration)
Creates a new service object.
|
static void |
setErrorStream(PrintStream ps) |
void |
ungetService(Bundle bundle,
ServiceRegistration<ExtendedLogReaderServiceImpl> registration,
ExtendedLogReaderServiceImpl service)
Releases a service object.
|
public static void setErrorStream(PrintStream ps)
public ExtendedLogReaderServiceImpl getService(Bundle bundle, ServiceRegistration<ExtendedLogReaderServiceImpl> registration)
ServiceFactory
The Framework invokes this method the first time the specified
bundle
requests a service object using the
BundleContext.getService(ServiceReference)
method. The service
factory can then return a specific service object for each bundle.
The Framework must check that the returned service object is valid. If
the returned service object is null
or is not an
instanceof
all the classes named when the service was registered,
a framework event of type FrameworkEvent.ERROR
is fired
containing a service exception of type
ServiceException.FACTORY_ERROR
and null
is returned to
the bundle. If this method throws an exception, a framework event of type
FrameworkEvent.ERROR
is fired containing a service exception of
type ServiceException.FACTORY_EXCEPTION
with the thrown exception
as the cause and null
is returned to the bundle. If this method
is recursively called for the specified bundle, a framework event of type
FrameworkEvent.ERROR
is fired containing a service exception of
type ServiceException.FACTORY_RECURSION
and null
is
returned to the bundle.
The Framework caches the valid service object and will return the same
service object on any future call to BundleContext.getService
for
the specified bundle. This means the Framework must not allow this method
to be concurrently called for the specified bundle.
getService
in interface ServiceFactory<ExtendedLogReaderServiceImpl>
bundle
- The bundle requesting the service.registration
- The ServiceRegistration
object for the
requested service.BundleContext.getService(ServiceReference)
public void ungetService(Bundle bundle, ServiceRegistration<ExtendedLogReaderServiceImpl> registration, ExtendedLogReaderServiceImpl service)
ServiceFactory
The Framework invokes this method when a service has been released by a bundle. The service object may then be destroyed.
If this method throws an exception, a framework event of type
FrameworkEvent.ERROR
is fired containing a service exception of
type ServiceException.FACTORY_EXCEPTION
with the thrown exception
as the cause.
ungetService
in interface ServiceFactory<ExtendedLogReaderServiceImpl>
bundle
- The bundle releasing the service.registration
- The ServiceRegistration
object for the
service being released.service
- The service object returned by a previous call to the
getService
method.BundleContext.ungetService(ServiceReference)
Copyright © 2007–2018 The Apache Software Foundation. All rights reserved.