SAP PI/PO使用 Java Mapping示例进行 Base64 编码

 概述： 

    本文提供了一个 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 映射。

1. 创建数据类型、消息类型和入站/出站接口。
2. 在 Netweaver Developer Studio （NWDS） 中实现 Base64 编码器 Java 类。
3. 在 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。

       

       

测试 Base64 编码器 Java 映射：

通过 Operation Mapping 测试工具测试 Java Mapping 程序。

       

                                                  Test Java Class