Show TOC

/IWBEP/IF_MGW_CONV_SRV_RUNTIMELocate this document in the navigation structure

Use

This interface offers several convenience methods provided by the framework.

Methods

Method COPY_DATA_TO_REF

This is a convenience method to get a data reference of a type any variable.

Parameter

Description

IS_DATA

Variable of type any which has to be either a structure or an internal table.

CR_DATA

Data reference of the imported variable.

Method CHECK_IF_IS_NOT_MODIFIED
This method can be used to fill es_response_context-is_not_modified. It checks if data was not modified based on:
  • if-modified-since HTTP request header (time stamp)
  • last-modified time stamp provided by the application

In case last-modified is older than if-modified-since then the data is up-to-date. In this case the returning parameter rv_is_not_modified is set to 'X' (/iwbep/if_mgw_appl_types=>gcs_modification_status-is_not_modified) This method can be used to fill es_response_context-is_not_modified. In case es_response_context-is_not_modified is set to 'X' ( /iwbep/if_mgw_appl_types=>gcs_modification_status-is_not_modified) then an HTTP response 304 ‚Not Modified‘ shall be sent.

Table 1:
Parameter Description
IV_IF_MODIFIED_SINCE Variable of type TZNTSTMPS, the if-modified-since time stamp
IV_LAST_MODIFIED Variable of type TZNTSTMPS, the last-modified-since time stamp.
RV_IS_NOT_MODIFIED Variable of type /IWBEP/MGW_IS_NOT_MODIFIED.

Method SET_HEADER

This method adds the header parameters to the HTTP response in a key/value approach.

Parameter

Description

IS_HEADER

Name/value pair as header parameter of the HTTP response. By setting this parameter you can, for example, influence the caching behavior.

Method SET_ETAG

This method sets the HTTP ETag in the HTTP resonse header.

Note

This method is only needed in the OData Compatibility Mode for SP 02. The ETag needs to be set in the READ_ENTITY method with the value of the property which is marked as ETag. You do not have to set the ETag in the OData Standard Mode.

Parameter

Description

IV_VALUE

ETag value

Method GET_LOGGER

This method returns an instance of the OData Channel logger. It should be used by the DPC (data provider class) for logging purposes.

Parameter

Description

RO_LOGGER

Instance

Method GET_MESSAGE_CONTAINER

This method returns an instance of the OData Channel message container. It should be used by the DPC to pass messages back to the framework.

Parameter

Description

RO_MESSAGE_CONTAINER

Instance

Method GET_DP_FACADE

This method returns a facade which is reserved for future features supporting content development. Currently it does not contain any methods.

Parameter

Description

RO_DP_FACADE

To access special utility methods

Method INIT_DP_FOR_UNIT_TEST
This method is used to initialize a data provider instance for the usage in a unit test.
  1. An instance of the new request context (/IWBEP/CL_MGW_REQUEST_UNITTST) is created.
  2. The request values are assigned to the request context instance.
  3. Member variables of the /IWBEP/CL_MGW_ABS_DATA are initialized and set:
    • MO_CONTEXT
    • MR_REQUEST_DETAILS
    • MR_SERVICE_DOCUMENT_NAME
    • MR_SERVICE_VERSION
    • MR_SERVICE_NAMESPACE
  4. Logger and message container instances are retrieved
Table 2:
Parameter Description
IS_REQUEST_CONTEXT Structure containing the new request context for unit tests, TYPE /IWBEP/CL_MGW_REQUEST_UNITTST=>TY_S_MGW_REQUEST_CONTEXT_UNIT
RO_REQUEST_CONTEXT Request context object for further usage through the DPC. TYPE REF TO /IWBEP/CL_MGW_REQUEST_UNITTST