「JDT 基核」外掛程式提供一個 API,可讓您以程式化的方式建立、 刪除和修改 Java 元素。如需「JDT 基核」提供的 API 簡介, 請參閱運用 Java 程式碼。
Java 模型中的重要概念就是使用記憶體中的編譯單元副本, 稱為「工作副本」(IWorkingCopy)。 使用工作副本可讓您在確定基礎資源的變更之前,先以程式化的方式變更編譯單元。
在 Java 使用者介面中,並行概念就是可讓使用者在向檔案系統確定工作副本之前, 廣泛地編輯資源。您的 UI 實作方式可以藉由使用副本,讓使用者能夠將 Java 編輯器中的內容儲存到磁碟中, 或回復成原來的內容。
IWorkingCopyManager 管理在編輯器內使用之 Java 編譯單元的工作副本。 當您想要在編輯器中修改編譯單元時,您應該將編輯器的輸入元素連接至工作副本管理程式, 來取得工作副本。編輯是在工作副本上執行。
底下是程式碼片段,用以示範如何利用編譯單元編輯器,來使用工作副本:
void modifyCompilationUnit(ICompilationUnit cunit) throws PartInitException, CoreException { IEditorPart editor= JavaUI.openInEditor(cunit); IEditorInput input= editor.getEditorInput(); IWorkingCopyManager manager= JavaUI.getWorkingCopyManager(); manager.connect(input); try { ICompilationUnit workingCopy= manager.getWorkingCopy(input); // 使用一般 JDT Core API 來修改 workingCopy。 } finally { manager.disconnect(input); } // 讓編輯器維持在已用過狀態,或使用 editor.doSave(IProgressMonitor monitor) // 來儲存程式設計上的變更。 }