com.sap.aii.mapping.lookup

Class RfcAccessor

java.lang.Object

com.sap.aii.mapping.lookup.RfcAccessor

public final class RfcAccessor
extends Object

Accessor for calling remote function modules in SAP ABAP systems via the rfc adapter. You can get an instance with the help of LookupService.

After executing your communication calls, the accessor must be closed through the secure cleanup idiom. See the following example.

 
    // 1. Get a system accessor for a channel.
    RfcAccessor accessor = LookupService.getRfcAccessor(channel); 
    try{
    
      // 2. Create a xml input stream representing the function module request message.
      InputStream inputStream;
            ...
      // 3. Create xml payload.
      Payload payload = LookupService.getXmlPayload(inputStream); 
      // 4. Execute lookup.
      Payload result = accessor.call(payload);
       ...
      // Steps 2. to 4. can be executed several times. 
      ...
      
    }finally{
        
        // 4. Close the accessor in order to free resources.
        if (accessor!=null) accessor.close();
        
    }
 
 

Since:

SAP NetWeaver '04 SPS 13

Method Summary

Modifier and Type	Method and Description
XmlPayload	call(XmlPayload payload) Executes a remote function call.
void	close() Closes this accessor and releases any resources associated with the accessor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

call

public XmlPayload call(XmlPayload payload)
                throws LookupException

Executes a remote function call. The method does not support transactional behaviour. Therefore, it should not be used to change the state in the accessed system; writing data to the accessed system can lead to inconsistencies. The method should only be used to read data from the accessed system.

Parameters:

payload - input payload

Returns:

payload resulting payload of the lookup.

Throws:

LookupException - if an error occurs.

NullPointerException - if payload is null.

close

public void close()
           throws LookupException

Closes this accessor and releases any resources associated with the accessor. Especially the returned input stream of the result payload is closed. Therefore, the parsing of the stream must be done before this method is called. Invoking of the call method is not allowed after this method has been invoced.

Throws:

LookupException - if an error occurs.