IBM ACE User Defined Node

1. 说明

   1. IBM ACE 前身为 IBM IIB 再之前为 WebSpere 的一部功能，版本 11 后称为 ACE (App Connect Enterprise)
   2. 图片来源 : https://iibdeveloper.home.blog/2020/01/01/appconnect-enterpriseace/
   3. 客户端需要在 MessageFlow 中加入客制化的 log 记录功，再写入资料库，使用 Java 开发 (User Defined Node 至少支持 Java 跟 C)
   4. 使用 IBM ACE toolkit (基于 Eclipse 的开发工具)
2. User-defined Node Project
   1. create a User-defined Node Project
   2. 可延伸自现有的 category 或是自建 category，本专项使用 Transformation category
   3. create a User-defined Node ()
   4. 这里有二个地方需要特别留意 “Name” 这必须与Implement 的Java code 名称相关联，且不能以 Node 结尾，需选取 "Implemented in Java/C"
      可以自定 Node icon 但需为 gif 格式
   5. settings properties
   6. 接下来就能设定对外部的 properties 部份，分二部分，Terminals
   7. 建立 properties

3. Implement
   1. 依一般 Eclipse Java Project 方式开发
   2. 需 import jplugin2.jar (位置 $ACE_PATH/server/classes) 与其他开发所需 jars
   3. 进入点为 “public class ScriptNode extends MbNode implements MbNodeInterface” 
   4. 须 extends MbNode, implements MbNodeInterface 重点来了, class name 必须与先前的 User-defined Node 中的 Name  相同再加上 Node, ex: ScriptNode
4. deploy
   1. User-defned Node Project 使用 package-> Plug-in jars 方式打包
   2. 再将 jar file 放于 toolkit 下的 dropins 目录下
   3. Java Project (Implement 的项目) 使用 PAR
   4. PAR 为一 jar 档，包含 classes、lib 二个目录，classes 为 Java Project “bin” 下的 classes ，lib 为 Java Project 中所需的 lib
   5. 最后将其打包 "jar cvf LoggingPrj.par classes lib"
   6. 放置于 $ACE_PATH/server/jplugins

    

5. Reference
   1. ace user defined node sample code : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=extensions-sample-node-files
   2. ava user-defined message processing nodes life cycle: https://www.ibm.com/docs/en/app-connect/11.0.0?topic=udmpn-java-user-defined-message-processing-nodes-life-cycle
   3. Planning user-defined message processing nodes: https://www.ibm.com/docs/en/app-connect/11.0.0?topic=nodes-planning-user-defined-message-processing
   4. Creating a message processing or output node in Java : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=java-creating-message-processing-output-node-in
   5. Interacting with databases by using the JavaCompute node : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=java-interacting-databases-by-using-javacompute-node
   6. Handling exceptions : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=java-extending-capability-message-processing-output-node
   7. Compiling a Java user-defined node : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=java-compiling-user-defined-node
   8. Installing user-defined extension runtime files on an integration node : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=pdude-installing-user-defined-extension-runtime-files-integration-node
   9. Packaging a Java user-defined node : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=extensions-packaging-java-user-defined-node
   10. User-defined nodes class loading search paths : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=node-user-defined-class-loading
   11. Testing a user-defined node : https://www.ibm.com/docs/en/app-connect/11.0.0?topic=nodes-testing-user-defined-node
   12. MbService : https://www.ibm.com/docs/en/integration-bus/10.0?topic=SSMKHH_10.0.0/com.ibm.etools.mft.plugin.doc/com/ibm/broker/plugin/MbService.html