org.osgi.application
Class ApplicationServiceEvent
java.lang.Object
java.util.EventObject
org.osgi.framework.ServiceEvent
org.osgi.application.ApplicationServiceEvent
- All Implemented Interfaces:
- java.io.Serializable
public class ApplicationServiceEvent
- extends ServiceEvent
An event from the Framework describing a service lifecycle change.
ApplicationServiceEvent
objects are delivered to a
ApplicationServiceListener
objects when a change occurs in this
service's lifecycle. The delivery of an ApplicationServiceEvent
is
always triggered by a ServiceEvent
.
ApplicationServiceEvent
extends the content of ServiceEvent
with the service object the event is referring to as applications has no
means to find the corresponding service object for a
ServiceReference
. A type code is used to identify
the event type for future extendability. The available type codes are defined
in ServiceEvent
.
OSGi Alliance reserves the right to extend the set of types.
- See Also:
ServiceEvent
,
ApplicationServiceListener
,
Serialized Form
Fields inherited from class java.util.EventObject |
source |
Method Summary |
java.lang.Object |
getServiceObject()
This method returns the service object of this service bound to the
listener application instance. |
Methods inherited from class java.util.EventObject |
getSource |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ApplicationServiceEvent
public ApplicationServiceEvent(int type,
ServiceReference reference,
java.lang.Object serviceObject)
- Creates a new application service event object.
- Parameters:
type
- The event type. Available type codes are defines in
ServiceEvent
reference
- A ServiceReference
object to the service that
had a lifecycle change. This reference will be used as the
source
in the EventObject
baseclass,
therefore, it must not be null.serviceObject
- The service object bound to this application
instance. It can be null
if this application is not bound
to this service yet.
- Throws:
java.lang.IllegalArgumentException
- if the specified reference
is
null.
getServiceObject
public java.lang.Object getServiceObject()
- This method returns the service object of this service bound to the
listener application instance. A service object becomes bound to the
application when it first obtains a service object reference to that
service by calling the
ApplicationContext.locateService
or
locateServices
methods. If the application is not bound to the
service yet, this method returns null
.
- Returns:
- the service object bound to the listener application or
null
if it isn't bound to this service yet.
Copyright © OSGi Alliance (2000, 2013). All Rights Reserved. Licensed under the OSGi Specification License, Version 2.0