com.sap.aii.af.service.administration.api.monitoring

Interface NativePayloadAccessCallback

All Superinterfaces:

AdapterCallback

public interface NativePayloadAccessCallback
extends AdapterCallback

The NativePayloadDisplayCallback defines two callback methods:

getNativeMessagePayload

getNativePayloadFileName

These methods should be implemented by adapters in order to return the persisted payload and facilitates in the native payload download. The native payload is persisted by the adapter while message processing. The callback methods will be triggered when the payload download is requested from the download UI.

The native payload is only persisted in case of an error.

There can be multiple payloads for a message. They need to be reported individually.

The implementing class of the callback needs to be registered by calling AdapterRegistry.registerAdapter.

See Also:

AdapterRegistry, AdapterRegistryFactory

Method Summary

Modifier and Type	Method and Description
InputStream	getNativeMessagePayload(String nativePayloadId) This callback method notifies the NativePayloadDisplayCallback implementation to return the native payload that is identified by the nativePayloadId The implementation is supposed to return the native payload as a binary stream.
String	getNativePayloadFileName(String nativePayloadId) This callback method,getNativePayloadFileName notifies the NativePayloadDisplayCallback implementation to return the name of the file under which the native payload was stored.

Method Detail

getNativeMessagePayload

InputStream getNativeMessagePayload(String nativePayloadId)

This callback method notifies the NativePayloadDisplayCallback implementation to return the native payload that is identified by the nativePayloadId The implementation is supposed to return the native payload as a binary stream.

Parameters:

nativePayloadId - the string that uniquely identifies a persisted native payload

Returns:

a InputStream representing the native payload

getNativePayloadFileName

String getNativePayloadFileName(String nativePayloadId)

This callback method,getNativePayloadFileName notifies the NativePayloadDisplayCallback implementation to return the name of the file under which the native payload was stored. This helps the download UI to enable the download of the payload in an appropriate manner. The implementation is supposed to return the file name as a String. If the native payload needs to be displayed as a plain text, the implementation should return <filename>.txt. In case nothing is returned, <payloadId>.txt shall be considered in all cases.

Parameters:

nativePayloadId - the string that uniquely identifies a persisted native payload

Returns:

a String, the name of the file that stored the persisted native payload