lumis.portal.monitor

Interface IMonitorValuesProvider

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractMonitorValuesProvider, BusinessContextMonitorValuesProvider, ClientOriginValuesProvider, MonitorEventValuesProvider, SimpleMonitorValuesProvider

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@StableMinor(version="12.0",
             sinceVersion="9.0")
 @FunctionalInterface
public interface IMonitorValuesProvider
extends Serializable

Interface that provides data to monitor framework when it needs.
For performance reasons, IMonitorValuesProvider implementations should guarantee that no unnecessary processing is performed (even more when it is costly) in its constructor. To be more efficient, any processing that can be postponed to getValues(SessionConfig, IMonitorField, ITransaction) should do so.

It is important to notice that getValues(SessionConfig, IMonitorField, ITransaction) may be called more than once for more than one field. Thus, implementations are highly advised to cache the results.

This interface is not considered to be thread-safe (it may be called from different threads concurrently). Implementations must guarantee thread-safety.

To ease development, AbstractMonitorValuesProvider can be used as a base implementation. It provides both, thread-safety and value caching.

Since:

9.0.0

Version:

$Revision: 23034 $ $Date: 2019-08-05 19:52:47 +0000 (Mon, 05 Aug 2019) $

Method Summary

Modifier and Type	Method and Description
List<? extends Serializable>	getValues(SessionConfig sessionConfig, IMonitorField field, ITransaction transaction) Returns the values for the given field. If this value does not provide values for the given field, it must throw a FieldNotProvidedException. Note that returning a null value is not the same as throwing a FieldNotProvidedException.

Method Detail

getValues

List<? extends Serializable> getValues(SessionConfig sessionConfig,
                                       IMonitorField field,
                                       ITransaction transaction)
                                throws FieldNotProvidedException,
                                       Exception

Returns the values for the given field.
If this value does not provide values for the given field, it must throw a FieldNotProvidedException.
Note that returning a null value is not the same as throwing a FieldNotProvidedException. When returning a null value, it is implied that the field has an explicit null value.

It is important to notice also that the given session config is not the session of the user that generated the monitoring event. Instead, it is a system user session.
As well as session config, the given transaction is not related to the transaction that generated the event (if any).

Parameters:

sessionConfig - the current session.

field - the desired field.

transaction - the current transaction.

Returns:

the values for the desired field.

Throws:

FieldNotProvidedException - if this provider does not provide values for the given field.

Exception - if any other error occur.

Since:

9.0.0