|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DestinationDataEventListener
The DestinationDataEventListener interface reacts on the events that a DestinationDataProvider could fire if the destination configuration was changed. Events allow to improve the performance and resource management in JCo destination management. If a destination data provider claims to support the events, JCo actually relies on them and does no longer check the properties for changes when accessing a destination, i.e. if there is no event JCo assumes that the properties for the destination haven't changed.
If the DestinationDataProvider implementation is not able to support the events, JCo retrieves the destination configuration each time it is requested although the JCo runtime already knows the destination configuration. Then the destination configuration will be compared with the cached one as if an update event had occurred. If the data retrieved from the DestinationDataProvider is different from the cached data, JCo replaces the cached data with the new configuration data.
Note: Implementation for this interface is provided by JCo runtime. If DestinationDataProvider returns true from supportsEvents(), JCo registers the implementation for this interface via setDestinationDataEventListener() API.
DestinationDataProvider
Method Summary | |
---|---|
void |
deleted(java.lang.String destinationName)
This event needs to be fired, if a destination was deleted from the destination repository. |
void |
updated(java.lang.String destinationName)
This event needs to be fired, if a destination configuration was updated. |
Method Detail |
---|
void deleted(java.lang.String destinationName)
destinationName
- name of the destination that has been deletedvoid updated(java.lang.String destinationName)
getDestinationProperties()
will already return the updated information.
If the destination data provider does adjust settings that change e.g. the
identification of the target system or the associated user, such as application server host, message server host,
SAP system ID, credentials, language and some more, a new destination instance will be created.
The outdated instance will be marked as invalid and is no longer usable. Any further attempt to use the old instance
(if you, for example, try to execute a function and pass such an invalid destination instance to the execute method)
will lead to an exception. Simply retrieve a new instance from the JCoDestinationManager in such a case.
Pool related settings can be adjusted without the destination instance being marked as invalid.
destinationName
- name of the destination that has been changedJCoDestination.isValid()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |