概述
本文提供了一个示例 Java 映射代码,用于解码 SAP PI/PO 中的 Base64 字符串。您可以使用用户定义的函数 (UDF)、Java 映射和适配器模块在 SAP PI/PO 中解码 Base64 字符串。在此示例中,我们将讨论如何使用 Java 映射实现 Base64 转换。
此外,我还实现了一个具有 Base64 编码 java 映射的示例接口。
演示中使用的 SAP PO版本:
SAP PO 7.5
Base64 编码 Java Mapping场景:
源消息节点 'TextMessage' 包含应编码的字符串值。Base64 编码的字符串应映射到目标消息节点 'Base64EncodedString'。
示例概述和预期结果
字符串 'Welcome!' 在 Base64 架构中转换为 'V2VsY29tZSE='。
实现了系统详细信息示例:
此示例将在 SAP Process Integration (PI) 系统版本 7.50 单堆栈中实施。
Java 映射的功能:
Java 映射的第一个功能是在 Base64 架构中对文本进行编码。发送方消息节点“TextMessage”中的字符串值应进行编码,并包含在目标消息元素“Base64EncodedString”中。
然后,Java 映射应创建一个包含其他元素、命名空间等的完整目标消息 xml。
如果目标系统是 SAP 系统,则可以使用 ABAP 函数模块 (FM) 或 ABAP 类CL_HTTP_UTILITY解码 Base64 字符串。您可以在我之前的帖子中阅读有关如何在 SAP 中编码或解码 Base64 的更多信息。
输入消息:
<?xml version="1.0" encoding="UTF-8"?> <ns0:TextMessage xmlns:ns0="urn:Source_System:TextMessage"> <TextMessage>Welcome!</TextMessage> </ns0:TextMessage>
输出消息:
<?xml version="1.0" encoding="UTF-8"?> <ns1:Base64EncodedString xmlns:ns1="urn:Target_System:Base64EncodedString"> <Base64EncodedString>V2VsY29tZSE=</Base64EncodedString> </ns1:Base64EncodedString>
如何在 Enterprise Resource Repository (ESR) 中实现 Java 映射:
按照以下步骤实施 Base64 编码 Java 映射。
- 创建数据类型、消息类型和入站/出站接口。
- 在 Netweaver Developer Studio (NWDS) 中实现 Base64 编码器 Java 类。
- 在 ESR 中定义导入的存档和操作映射 (OM)。
第 1 步:创建数据类型、消息类型和入站/出站接口:
创建发件人消息和目标消息 数据类型 和 消息类型.然后,创建入站和出站服务接口。
发送方消息、数据类型和消息类型:
发件方消息数据类型
发件方消息消息类型
目标系统数据类型和消息类型:
接收数据类型
接收消息类型
接收方接口:
接收接口
发送方接口:
发送接口
步骤 2:在 NWDS 中实现 Base64 编码器 Java 类:
我们将使用 java.util.Base64 类来实现这个映射程序。
在 NWDS 中创建 Encoder Java 映射类。将实现的 Java 类导出为 .jar 文件。
package Base64Encoder; import java.io.InputStream; import java.io.OutputStream; import com.sap.aii.mapping.api.AbstractTransformation; import com.sap.aii.mapping.api.StreamTransformationException; import com.sap.aii.mapping.api.TransformationInput; import com.sap.aii.mapping.api.TransformationOutput; import javax.xml.parsers.DocumentBuilder; import javax.xml.parsers.DocumentBuilderFactory; import org.w3c.dom.Document; import org.w3c.dom.Node; import java.util.Base64; public class Encoder extends AbstractTransformation { @Override public void transform(TransformationInput in, TransformationOutput out) throws StreamTransformationException { String textMessage = null; String encodedString = null; Node textMessageNode; try { //Read input and output payloads. InputStream inputStream = in.getInputPayload().getInputStream(); OutputStream outputStream = out.getOutputPayload().getOutputStream(); //Creates new instance of DOM tree builder factory DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); //Creates new instance to obtain DOM document from xml. DocumentBuilder builder = factory.newDocumentBuilder(); //Obtain new DOM document from inputStream xml. Document doc = builder.parse(inputStream); //Obtain the XML node 'TextMessage' of source message. textMessageNode = doc.getElementsByTagName("TextMessage").item(0); //Get the value of the xml element 'TextMessage' from source message. textMessage = textMessageNode.getFirstChild().getNodeValue(); //Encode text to base64 string. byte[] bytes = textMessage.getBytes(); encodedString = Base64.getEncoder().encodeToString(bytes); //Derive output(target) xml message. outputStream.write(("<?xml version=\"1.0\" encoding=\"UTF-8\"?><ns1:Base64EncodedString xmlns:ns1=\"urn:Target_System:Base64EncodedString\"><Base64EncodedString>"+encodedString+"</Base64EncodedString></ns1:Base64EncodedString>").getBytes()); } catch (Exception exception) { getTrace().addDebugMessage(exception.getMessage()); throw new StreamTransformationException(exception.toString()); } } }
第 3 步:创建 Imported Archive and Operation Mapping:
将 Java 映射作为导入的存档 (.jar) 上传到 ESR。接下来,创建包括 Imported Archive 的操作映射。
导入Base64 jar 包
使用 Java 类配置 Operation Mapping。
Imported Archive and Operation Mapping
测试 Base64 编码器 Java 映射:
通过 Operation Mapping 测试工具测试 Java Mapping 程序。
测试 Java 类