使用BeanShell巨集自行擴充功能

14 views
Skip to first unread message

pi1ot

unread,
Mar 29, 2009, 2:39:56 PM3/29/09
to jEdit中文用户组
jEdit提供了多種擴充機制(BeanShell、JPython等)讓使用者能自行增加功能,原本以為擴增的程序會很複雜,並且可能要使用不熟悉的
語法來撰寫,沒想到原來BeanShell根本就是Java的語法,如果你已經會Java了,那麼幾乎不用學習就能馬上用BeanShell寫擴充巨集
了。最快學會擴充巨集的方法,就是由閱讀其內建的巨集程式開始。

首先用jEdit開啟C:\Program Files\jEdit\Macros\Text\Insert_Date.bsh,我們看到的就像是一個
標準的Java程式,先是定義了一個函數insertDate( ),最後面再叫用此函數,百分之九十五的程式都是一看就懂,在第53~55行的地方才
是我們要注意的重點:

// inserting date and internet time to textarea
textArea.setSelectedText(Calendar.getInstance().getTime().toString
() + " @" + (int)swatch + " /Internet Time/");此段程式使用系統變數textArea的
setSelectedText( ) method把目前時間插入選取文字。

jEdit有幾個預設好了的系統變數,用來表示jEdit的各項主要元件,透過這些變數就能存取jEdit的各個設定並做需要的操作:

*textArea:代表的是編輯區的文字區域
*buffer:代表了目前編輯中的檔案緩衝區
*view:代表了目前編輯中的檢視物件,UI的輸出都要透過此物件
第58~61行出現了另一個jEdit的類別Macros:

if (buffer.isReadOnly()) Macros.error(view, "Buffer is read-
only.");else insertDate();buffer.isReadOnly( )判斷目前編輯檔案是否是唯讀狀態,如果是唯讀的檔案
則不能插入時間,而以Macros.error( )於當前的view顯示錯誤對話窗。Macros類別提供了許多放的method,按F1開啟
jEdit Help找到'jEdit API Reference'裡的org.gjt.sp.jedit package,其內有包含Macros
在內的許多系統類別;Macros有幾個method經常會使用到:

*Macros.error(view, "message"): 顯示錯誤訊息窗
*Macros.message(view, "message"); 顯示訊息窗
*Macros.input(view, "message", default-value); 顯示輸入對話窗

再來看另一個巨集:C:\Program Files\jEdit\Macros\Text\Insert_Tag.bsh,這個巨集將選取文字組成
HTML標籤。重點解說如下:
行號 程式碼片段 說明
29 caret = textArea.getCaretPosition(); 取得目前游標位置
30 tag = Macros.input(view, "Enter name of tag:"); 讓使用者輸入標籤名稱
32 text = textArea.getSelectedText(); 取得選取文字
38 textArea.setSelectedText(sb.toString()); 把組好的文字寫回選取文字
我們可以注意到caret、tag、text等變數都沒有宣告型別而能直接使用,這是BeanShell和Java的一個重大差異,在
BeanShell裡的變數可以不用事先宣告且能任意變型,這個特性當然能帶來方便性,但要小心日後的維護性。

Reply all
Reply to author
Forward
0 new messages