表达式 Builder中的远程函数

使用表达式 Builder，您可以创建对Data Dictionary或最终用户提供的数据值执行计算的表达式或条件。 Corresponce Management使用表达式评估的结果来选择文本、图像、列表和条件等资产，并根据需要将其插入通信中。

使用表达式 builder创建表达式和远程函数

表达式 Builder在内部使用JSP EL库，因此表达式符合JSPEL语法。 有关详细信息，请参阅示例表达式。

运算符

可在表达式中使用的运算符位于表达式生成器的顶栏中。

示例表达式

以下是几个常用的JSP EL示例，您可以在通信管理解决方案中使用它们：

• 要添加两个数字：$
• 要连接两个字符串：${str1} $
• 要比较两个数字：$

可以在JSP EL规范中找到更多信息。 客户端表达式管理器不支持JSP EL规范中的某些变量和函数，具体而言：

• 在客户端评估的表达式的变量名称中，不支持集合索引和映射键（使用[]符号）。

• 以下是表达式中使用的函数的参数类型或返回类型：

  • java.lang.String
  • java.lang.Character
  • 字符
  • java.lang.Boolean
  • 布尔型
  • java.lang.Integer
  • 整数
  • java.util.list
  • java.lang.Short
  • 短
  • java.lang.Byte
  • 字节
  • java.lang.Double
  • 双精度型
  • java.lang.Long
  • 长整型
  • java.lang.Float
  • 浮点数
  • java.util.Calendar
  • java.util.Date
  • java.util.List

远程函数

远程功能提供在表达式中使用自定义逻辑的功能。 您可以编写自定义逻辑以在表达式中使用，并将它作为Java中的方法，同一功能可以在表达式内使用。 可用的远程功能列在表达式编辑器左侧的“远程功能”选项卡下。

添加自定义远程函数

您可以创建自定义捆绑包，以导出您自己的远程功能并在表达式内使用。 要创建用于导出您自己的远程功能的自定义包，请执行以下任务。 它演示了如何编写一个自定义函数来使其输入字符串大写。

1. 为OSGi服务定义一个接口，其中包含正在导出以供表达式 Manager使用的方法。

2. 在接口A上声明方法，并用@ServiceMethod annotation(com.adobe.exm.expeval.ServiceMethod)对其进行注释。 表达式管理器会忽略任何未加注释的方法。 ServiceMethod注释具有以下可选属性，也可以指定这些属性：

   1. 已启用:确定是否启用此方法。表达式 Manager忽略禁用的方法。
   2. familyId:指定方法的族（组）。如果为空，则表达式管理器假定该方法属于默认系列。 没有从中选择函数的族的注册表（默认类除外）。 表达式 Manager通过合并由各个捆绑包导出的所有函数指定的所有系列ID来动态创建注册表。 请确保他们在此处指定的ID可读性合理，因为它也显示在表达式创作用户界面中。
   3. displayName:函数的可读名称。此名称用于创作用户界面中的显示目的。 如果为空，则表达式 Manager使用函数的前缀和local-name构造默认名称。
   4. 描述:函数的详细描述。此说明用于在创作用户界面中进行显示。 如果为空，则表达式 Manager使用函数的前缀和local-name构造默认描述。

   package mergeandfuse.com;
   import com.adobe.exm.expeval.ServiceMethod;
   
   public interface RemoteFunction {
    @ServiceMethod(enabled=true,displayName="Returns_all_caps",description="Function to convert to all CAPS", familyId="remote")
    public String toAllCaps(String name);
   
   }
   

   也可以选择使用@ServiceMethodParameter annotation(com.adobe.exm.expeval.ServiceMethodParameter)对方法的参数进行注释。 此注释仅用于指定在创作用户界面中使用的方法参数的可读名称和说明。 确保接口方法的参数和返回值属于以下类型之一：

   • java.lang.String
   • java.lang.Character
   • 字符
   • java.lang.Boolean
   • 布尔型
   • java.lang.Integer
   • 整数
   • java.lang.Short
   • 短
   • java.lang.Byte
   • 字节
   • java.lang.Double
   • 双精度型
   • java.lang.Long
   • 长整型
   • java.lang.Float
   • 浮点数
   • java.util.Calendar
   • java.util.Date
   • java.util.List

3. 定义接口的实现，将其配置为OSGI服务并定义以下服务属性：

@org.apache.felix.scr.annotations.Properties({
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker", boolValue = true),
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker.alias", value = "<service_id>"),
  @org.apache.felix.scr.annotations.Property(name = "exm.service", boolValue = true)})

exm.service=true条目指示表达式管理器，该服务包含适合在表达式中使用的远程函数。 <service_id>值必须是有效的Java标识符（字母数字、$、_，没有其他特殊字符）。 此值前缀为REMOTE_关键字，构成在表达式中使用的前缀。 例如，在使用REMOTE_foo:bar()的表达式中可以引用带有注释的方法bar()和服务属性中的服务ID foo的接口。

package mergeandfuse.com;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;

@Component(metatype = true, immediate = true, label = "RemoteFunctionImpl")
@Service(value = RemoteFunction.class)
@org.apache.felix.scr.annotations.Properties({
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker", boolValue = true),
  @org.apache.felix.scr.annotations.Property(name = "connectors.jsoninvoker.alias", value = "test1"),
  @org.apache.felix.scr.annotations.Property(name = "exm.service", boolValue = true)})
public class RemoteFuntionImpl implements RemoteFunction {

 @Override
 public String toAllCaps(String name) {
  System.out.println("######Got######"+name);
  
  return name.toUpperCase();
 }
 
}

以下是要使用的示例存档：

• GoodFunctions.jar.zip是包 含示例远程函数定义的jar文件。下载GoodFunctions.jar.zip文件并解压缩以获取jar文件。
• GoodFunctions.zip 是用于定义自定义远程函数和为其创建包的源代码包。

GoodFunctions.jar.zip

获取文件