概念：自定义元素封装

Java 类注释

如果您想在不同的项目中重复使用某个自定义程序集元素，请使用注释使该元素显示在“Palette”

中。

要执行此操作，请在创建 Java 类和 Spingle bean 时选中

“注释 Java 类以出现在面板中”

复选框。Studio 添加了

@Component

在生成的 Java 类中添加“”注释，该类位于程序集项目的

src

文件夹中。示例：

import com.capeclear.assembly.annotation.Component;
import com.capeclear.assembly.annotation.ComponentMethod;
import com.capeclear.assembly.annotation.Property;
import static com.capeclear.assembly.annotation.Component.Type.*;



@Component(
        name = "TimeStamperCustomMediationStepImpl",
        type = mediation,
        toolTip = "This custom code step adds the current time on the first line of the message.",
        scope = "singleton",
        smallIconPath = "icons/TimeStamperCustomMediationStepImpl_16.png",
        largeIconPath = "icons/TimeStamperCustomMediationStepImpl_24.png"
        )

您可以手动编辑此信息。

请注意， Studio 会将自定义元素的图标存储在项目的

src/icons

文件夹。有 16x16 像素和 24x24 像素 2 个版本。要使用自定义图标，请将 _16.png 和 _24.png 文件替换为您自己的图片。

显示自定义的程序集元素属性

如果您的自定义 Java 代码包含您希望由用户设置的属性，则可以在自定义元素的“Properties”

视图的“Bean”

选项卡上显示这些属性。

为此，请提供遵循 bean 模式的 getter 和 setter 方法。示例：属性

abc

，提供 getter 和 setter 方法，例如

getAbc

与

setAbc

。

然后添加

@Property

为以下任一对象添加注释

set

或

get

方法。该

name

值定义属性在

“属性”

视图中的标签，

toolTip

该值定义当您将鼠标悬停在标签上时 Studio 显示的文本。您可以使用 order 值控制属性的列出顺序。值较小的优先显示。一个

editelement

value 指定在属性输入字段旁边显示的按钮类型，如下所示：

// Displays a text box with a Select button to enable you to select a Spring bean.
@Property(name="Text", edit=Edit.BEAN_REF)

// Displays a text box with a Select button to enable you to select a Java class.
@Property(name="Text", edit=Edit.CLASS)

// Displays a text box with a dialog box that enables you to specify a cron expression.
@Property(name="Text", edit=Edit.CRON)

// Displays a text box without a button.
@Property(name="Text", edit=Edit.DEFAULT)

// Displays a Browse button to enable you to specify a file.
@Property(name="Text", edit=Edit.FILE)

// Displays a Browse button to enable you to specify a folder.
@Property(name="Text", edit=Edit.FOLDER)

Studio 会在包含正在编辑的程序集.xml 文件的项目的项目类路径中查找自定义类。要将自定义构成分发给多个程序集项目，请将二进制形式的自定义封装为包含类文件和图标图片的 JAR 文件。其他用户可在项目的类路径中包含此 JAR 文件，以便在其自己的 Assembly Editor 中使用该文件。

Assembly Editor 会在启动时自动加载在其类路径中找到的任何自定义构成。右键单击程序集图背景，并选择“Refresh Customizations”

，以重新加载最近添加的所有自定义构成。