概述:
本文提供了一个 Java 映射,它在 SAP PI/PO 中对 Base64 进行编码。我将实现一个简单的接 口来演示 Java 映射的使用。这是关于 Base64 编码和解码的系列文章的一部分,您可以在我的上一篇文章中查看 Base64 解码 Java 映射示例SAP PI/PO使用 Java Mapping示例进行 Base64 解码-CSDN博客Base64 解码 Java 映射示例。
同样,您还可以使用用户定义的函数 (UDF) 在 SAP PI/PO 中对 Base64 进行编码和解码
演示使用的 SAP 版本:
- SAP PO 7.5
Base64 编码 Java Mapping 场景:
源消息节点 'TextMessage' 包含应编码的字符串值。Base64 编码的字符串应映射到目标消息节点 'Base64EncodedString'。
字符串 'Welcome!' 在 Base64 架构中转换为 'V2VsY29tZSE='。
实现了系统详细信息示例:
此示例将在 SAP Process Integration (PI) 系统版本 7.50 单堆栈中实施。
Java Mapping的功能:
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 步:创建数据类型、消息类型和入站/出站服务接口:
创建发件人消息和目标消息 数据类型 和 消息类型.然后,创建入站和出站服务接口。
发件人消息、数据类型和消息类型
Sender message Data Type
Sender message Message Type
目标消息、数据类型和消息类型:
Receiver Data Type
Receiver Message Type
Inbound Service Interface:
Inbound Service Interface for target
Outbound Service Interface:
Output Service Interface for sender
步骤 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 步:创建导入的存档和操作映射 (OM):
将 Java 映射作为导入的存档 (.jar) 上传到 ESR。接下来,创建包括 Imported Archive 的操作映射。
使用 Java 类配置 Operation Mapping。
![](https://i-blog.csdnimg.cn/direct/814df86685b14d27aadd94eaea8483a1.png)
![](https://i-blog.csdnimg.cn/direct/f526c854f0d041e2a8481ccc95f65ead.png)
测试 Base64 编码器 Java 映射:
通过 Operation Mapping 测试工具测试 Java Mapping 程序。
Test Java Class