概念︰自訂元素封裝

Java 類別註解

如果您想在不同的專案中重複使用自訂組合元素，請使用註解讓元素顯示在

調色盤

上。

為此，請在您建立 Java 類和 Spring 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

資料夾。有 2 個版本，16x16 和 24x24 像素。若要使用自訂圖示，請將 _16.png 和 _24.png 檔案取代為您自己的影像。

顯示自訂集合元素屬性

如果您的自訂 Java 代碼具有您希望使用者設定的屬性，您可以在自訂元素的「

屬性」

檢視的

Bean

分頁上顯示這些屬性。

為此，請提供遵循 Bean 模式的 getter 和 setter 方法。範例︰針對屬性

abc

，提供 getter 和 setter 方法，例如

getAbc

和

setAbc

。

然後新增

@Property

註解

set

或

get

方法該

name

值會在

「屬性」

檢視中定義屬性的標籤，而

toolTip

值可定義當您將滑鼠移至標籤上方時 Studio 顯示的文字。您可以使用順序值來控制屬性列出的順序。首先顯示較低的值。一個

editelement

值會指定在屬性輸入欄位旁邊顯示的按鈕類型，如下所示︰

// 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 會在包含正在編輯的 components.xml 檔案的專案的專案類別路徑中尋找自訂類別。要將您的自訂元件發布至多個組合專案，請將二進位格式的自訂項目打包為一個包含類別檔案和圖示影像的 JAR 檔案。其他使用者可將此 JAR 包含在專案的類別路徑中，以便在其組合編輯器中使用。

集合編輯器會在啟動時自動載入其在類別路徑中找到的任何自訂元件。在組合圖背景上按一下滑鼠右鍵，然後選取

重新整理自訂項目

，重新載入任何最近新增的自訂元件。