commonj.connector.runtime
Interface InboundNativeDataRecord

All Superinterfaces:
Cloneable, Record, Serializable

public interface InboundNativeDataRecord
extends Record

The InboundNativeDataRecord is a holder of arguments and result exchanged with data binding when the resource adapter does not support InboundListener or MessageListener interfaces. In these cases, the runtime will provide the instance of this interface to the DataBinding.

When InboundNativeDataRecord is used to pass arguments of the listener interface method, it is a list of arguments that matches exactly, in types and order, the list of arguments of the listener interface method. It represents the native data passed by the adapter to the listener and converted to Data Object using RecordHolderDataBinding

When InboundNativeDataRecord used to pass result from the data binding to the listener, it is a one element array containing the result to be returned from the message listener interface. The type of the result matches the type of return type of the message listener interface.

Since:
1.0
See Also:
RecordHolderDataBinding

Method Summary
 Object[] getNativeData()
          Return the native representation of the data.
 void setNativeData(Object[] data)
          Set the data.
 
Methods inherited from interface javax.resource.cci.Record
clone, equals, getRecordName, getRecordShortDescription, hashCode, setRecordName, setRecordShortDescription
 

Method Detail

setNativeData

void setNativeData(Object[] data)
Set the data. The data depends on the usage of the interface, either to pass arguments from the listener to the DataBinding or to return result from the data bining to the listener.

Parameters:
data - An array containing the native representation of the data, either an array corresponding to the arguments of the message listener interface or a one element array containing the result, a return type of the method of the message listener interface. The value of the array may be null.

getNativeData

Object[] getNativeData()
Return the native representation of the data. The data depends on the usage of the interface, either to pass arguments from the listener to the DataBinding or to return result from the data binding to the listener.

Returns:
Object[] An array containing the native representation of the data, either an array corresponding to the arguments of the message listener interface or a one element array containing the result, a return type of the method of the message listener interface. The value of the array may be null.
See Also:
setNativeData(Object[])