#ifdef DEBUG
// DLOG takes a format argument (which must begin %s) and 0 or more args:
// DLOG(@"%s");
// DLOG(@"%s: %d", x);
#define DLog(fmt, ...) NSLog((@"%s [line:%d]" fmt), __PRETTY_FUNCTION__, __LINE__, ##__VA_ARGS__)
#else
#define Dlog(...)
#endif
NSDate *currentDate = [NSDate date];
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
[dateFormatter setDateFormat:@"HH:mm:ss"];
NSString *stringCurrentTime = [dateFormatter stringFromDate:currentDate];
NSLog(@"current time : %@", stringCurrentTime);
GEF 에디터에 ActionBarContributor를 정의하여 Delete 액션을 리타겟 하여 사용하다가 이 GEF에디터를 MultipateEditor로 옮겨야 하게 되었다.
문제는 GEF에디터를 그냥 쓸때는 plug-in.xml에서 에디터의 Contributor를 정의하여 사용하면 문제없이 Delete액션이 작동 하였지만 GEF에디터를 MultipageEditor에 추가하여 사용하면 GEF에디터에 설정해둔 ActionBarContributor는 작동하지 않는다는 것이었다.
이것을 어떻게 해결하느냐..
MultipageEditor에 해당하는 ActionBarContributor를 다시 지정해야 한다. MultipageEditor에 ActionBarContributor를 지정하려면 MultiPageEditorActionBarContributor를 상속한 클래스를 만들어 plug-in.xml에서 지정해주어야 한다. MultiPageEditorActionBarContributor는 abstract클래스로 setActivePage()메소드를 구현해야 하는데 setActivePage에서 activeEditor의 getAdapto메소드의 인자를 ActionRegistry.class를 넣어 호출 하여 활성화 된 에디터의 ActionRegistry를 가져온다.
가져온 registry를 이용하여 actionbar에 추가시킬 액션을 추가하면 문제는 해결된다.
@Override
public void setActivePage(IEditorPart activeEditor) {
if (activeEditor != null) {
ActionRegistry registry = (ActionRegistry) activeEditor.getAdapter(ActionRegistry.class);
if (registry != null) {
IActionBars bars = getActionBars();
for (int i = 0; i < globalActionKeys.size(); i++) {
String id = (String) globalActionKeys.get(i);
IAction action = registry.getAction(id);
bars.setGlobalActionHandler(id, action);
}
getActionBars().updateActionBars();
}
}
}
Plug-in 개발을 하다 보면 파일로부터 입력 받아야 경우가 발생할 것이다. 이때 파일에 접근하기 위하여 경로를 설정해야 하는데 제일 간단한 방법은 파일의 경로를 절대경로로 "c:\aaa\bbb.txt"식으로 접근하는 방법이다. 그러나 개발하고자 하는 플러그인이 어느 위치에 있을지 알 수 없다. 그러므로 경로가 유동적인 상대경로로 설정하는 것이 더 바람 직 할 것이다.
Java.io.File 같은 경우 상대 경로로 설정하기 위해서는 File file = new file(bbb.txt)과 같이 파일 이름만 생성자의 인자로 사용하거나 경로를 설정하면 프로젝트 경로를 기준으로 설정한 경로를 따라 간다.
Eclipse Plug-in에서는 이것보다 좀더 고급스러운 방법을 지원한다. Bundle과 BundleUtility를 사용하여 InputStream을 생성할 수 있고 이를 이용하여 파일로부터 입력을 받을 수 있다.
|
Bundle bundle = Platform.getBundle(Application.PLUGIN_ID); URL fileURL = BundleUtility.find(bundle, "folder/data.dat"); try{ InputStream iStream = fileURL.openStream(); }catch(IOException e){ e.printStackTrace(); } … |
위와 같이 InputStream을 생성하고 이 입력 스트림을 이용하여 파일로부터 내용을 읽어 들이면 된다.
BundleUtility.find()의 첫 번째 인자는 플러그인 에 해당하는 Bundle이고 두 번째 인자는 읽을 파일 경로이다. 경로는 플러그인 프로젝트 폴더를 루트 폴더로 기준을 잡고 하위 경로를 입력하면 된다.
이렇게 하면 프로젝트 폴더가 어디로 이동하더라도 해당 파일을 읽을 수 있다.
Wizard 작성시 Wizard에 여러개의 WizardPage를 추가하여 Wizard를 구성한다.
이때, 각 페이지 별로 페이지의 초기값을 할당해 주어야 할 때가 있다. 그리고 그 값은 이전 페이지에서 사용자가 입력한 내용을 바탕으로 지정해야 할 때가 있다.
내가 처음에 이 문제에 부디쳤을 때는 각 페이지는 사용자가 next버튼을 클릭해서 페이지가 활성화 될 때 페이지가 생성 될거라 생각하고 페이지의 생성자 부분에서 초기값을 할당해 주면 된다고 생각했다. 그러나 모든 Wizard에 올라가는 모든 페이지들은 Wizard가 생성되는 순간에 이미 모두 생성되에 Wizard를 구성하게되고 Wizard가 화면에 나타나게 되는것이다. 그러므로 페이지의 생성자는 사용자로 부터 입력 받기전에 이미 호출되기 때문에 우리가 원하는 초기화 작업을 할 수없다.
이를 해결하기 위해서는 DialogPage.setVisible(boolean visible)메소드를 이용하여야 한다. WizardPage는 DialogPage의 하위 클래스 이므로 WizardPage에서 setVisible을 재정의 해야한다. setVisible()메소드는 페이지가 생성되고 난 후 화면에 보여질때 호출 되는 메소드 이다. 이 메소드 내에서 페이지 내 각 컨트롤들의 초기화 작업을 할 수있는것이다.
사용 예)
public void setVisible(boolean visible){
NewProjectWizard wizard = (NewProjectWizard)getWizard();
InputProjectNamePage inputProjectNamePage = (InputProjectNamePage)wizard.getPreviousPage(this);
name.setText(inputProjectNamePage.getProjectName());
super.setVisible(visible);
}
이클립스 플러그인 및 이클립스RCP에서 IResource인터페이스를 이용하여 Eclipse Workspace상의 자원을 취급하는 방법에 대해서 알아 보자.
|
Eclipse의 모든 자원은 Workspace로 불리는 영역에 저장 된다. Workspace는 Eclipse Workbench에 대해서 하나만 존재하여, 폴더나 파일 등의 자원은 이 Workspace상에 맵핑 되지 않으면 Eclipse에서 취급할 수 없다. 또, Workspace에는 항상 하나의 Workspace Root만 존재 한다. 또한, Workspace Root에는 몇 개의 Project가 존재해, 그 Project내에 폴더나 파일이 존재 하게 된다.
또, Project나 폴더, 파일 이라고 하는 Resource는 실제의 파일 시스템에 맵핑 된다. Eclipse의 프로젝트, 폴더, 파일 등의 Resource는 파일시스템의 디렉토리나 파일에 대응한다. 하지만 이러한 Eclipse의 자원을 직접 파일시스템을 이용하여 취급하는 것은 좋지 않다. 반드시 각 자원 마다 할당할 수 있는 Resource의 인터페이스(IResource, IFolder, IFile등..)를 이용하여 취급해야만 한다.
|
위에서 설명한 대로 Resource의 조작은 Resource핸들을 이용해서 수행한다. 통상적으로 Resource의 핸들은 갑자기 작성할 수 없고, 임의의 Resource 핸들을 작성하기 위해서는, 그 Resource의 컨테이너가 되는 Resource의 핸들이 필요하다. 예를 들면, 파일의 Resource를 작성하기 위해서는, 프로젝트나 폴더의 핸들이 필요하다. 또, 폴더를 작성하기 위해서는, 프로젝트나 부모 폴더의 핸들이 필요하다. 또한, 프로젝트를 작성하기 위해서는 Workspace Root의 핸들이 필요하다.
그러면 Workspace Root의 핸들 작성은 어떻가 하는가 하면, Workspace Root는 항상 존재하는 것으로 생성하거나 복사, 이동 할 수없다. 또 Workspace Root의 핸들은 IWorkspaceRoot인터페이스롤 나타내져 플러그인의 코드 어디에서도 아래와 같은 방법으로 취득 할 수 있다.
|
IWorkspaceRoot root = ResourcesPlugin.getWorkspace().getRoot(); |
이IWorkspaceRoot 오브젝트는, 프로젝트의 컨테이너가 되는 자원의 핸들이기 때문에, IWorkspaceRoot를 취득하면, 프로젝트의 작성이 가능하게 된다. 또, 프로젝트의 핸들은 IProject인터레이스로 나타내지며 폴더와 파일은 각각 IFolder, IFile인터레이스로 나타낸다. 이러한 Resource를 나타내는 인터페이스는 모두 IResource의 하위 인터페이스 들이다.
|
우선, 위에서 취득했던 IWorkspaceRoot를 사용해 프로젝트를 작성해 보자.
|
IProgressMonitor monitor = …… IWorkspaceRoot root = ResourcePlugin.getWorkspace().getRoot(); //프로젝트 핸들의 작성 IProject project = root.getProject("My Project"); If(!project.exists()){ Project.create(monitor); //① 실제 프로젝트 작성 Project.open(monitor); //프로젝트 오픈 …… } |
①의 부분에 create()라는 이름의 말 그대로 무언가를 생성하는 메소드가 있다. 그 이전에 getProject()라고 하는 메소드가 있지만 이는 프로젝트의 핸들을 작성하는 메소드이다. 그 다음 create()메소드를 통하여 실제로 디렉토리를 작성하거나 Eclipse의 프로젝트를 작성한다. 즉 IWorkspaceRoot.getProject()메소드에서는 프로젝트의 핸들을 작성하는 것 만으로는 Workspace상에 도 파일시스템상에도 아무 영향이 없다. 또, IWorkspaceRoot.getProject()메소드에는 2종류가 있어서 다음과 같이 정의 되고 있다.
|
정 의 |
의 미 |
|
IProject getProject(String name) |
주로 프로젝트핸들의 작성에 사용된다. 인수 name에 프로젝트명을 지정한다. 이프로젝트명을 가지는 프로젝트가 워크스페이사항에 존재하고 있는 경우에는, 그 프롲게트의 핸들이 리턴되며 존재하지 않는 경우에는 그 프로젝트명을 가지는 프로젝트 핸들이 작성되어 리턴된다. 그러나 이 경우 리턴된 핸들은 이 단계에서는 Workspace상에 맵핑 되지는 않는다. |
|
IProject[] getProject() |
Workspace상에 존재하는 모든 프로젝트의 핸들의 배열을 리턴한다. |
여기서, getProject(String name)를 사용해서 프로젝트 핸들을 작성 한다고 해도, 실제 프로젝트는 워크스페이스나 파일시스템에 생성되지 않는다. 실제로 프로젝트를 작성 하기위해서는 IProject.create()메소드를 호출 해야 한다. 그리고 create()메소드를 호출하기 전에, getProject()메소드로 저정한 프롲게트명을 가지는 프로젝트가 Workspace상에 이미 존재하고 있을지를 체그할 필요도 있다.(이미 존재 하는 프로젝트 핸들로 create()메소드를 호출하면 예외가 발생한다.)
Create()메소드를 호출한 단계에서 getProject()로 작성한 프로젝트 핸들이 워크스페이스에 추가되어 프로젝트와 맵핑되는 디렉토리가 파일 시스템상에 생성 된다. 그러나 이 단계에도 작성한 프로젝트에 대해 어떠한 조작도 할 수없다. 작성한 프로젝트에 폴더나 파일을 추가하기 위해서는 프로젝트를 여는 작업을 해야 한다. 프로젝트를 열기 위해서는 IProject.open()메소드를 사용한다. 이후, 프로젝트에 Resource 추가 등의 조작이 가능하게 된다. 또, IProject의 create()/open()메소드는 모두 시간이 걸리는 처리 이므로 유저에게 조작의 진행 상황을 보고하는, IProgressMonitor형태의 오브젝트를 인수로 받는다. 이 인수에 null을 지정하면 진행상황은 보고되지 않는다.
이것으로 프롲게트의 작성은 완료 되었다. 프로젝트는 파일 및 폴더의 컨테이너이므로 IProject를 취득하면 폴더와 파일의 작성이 가능하게 된다.
|
IProject project = ... // 파일 작성 IFile file = project.getFile("MyFile.file"); // 파일 핸들 작성 file.create(new ByteArrayInputStream(new byte[0]),false,null); // 실제 파일 작성 IFolder folder = project.getFolder("MyFolder"); // 폴더 핸들 작성 folder.create(false,true,null); // 실제 폴더 작성 |
이러한 파일이나 폴더 역시 프로젝트의 경우와 마찬가지로 getFile(), getFolder()와 같은 메소드로 핸들을 작성한 후 create()메소드로 실제의 Resource를 작성하게 된다. 또, 파일을 작성하기 위한 메소드 IFile.create()의 정의는 아래와 같다.
|
public void create(InputStream source, boolean force, IProgressMonitor monitor) throw CoreException |
여기서 인수 source는 작성하고자 하는 파일의 내용을 지정한다. 이 인수에 null을 지정하면 파일은 로컬파일이 아닌 것으로 취급 된다. 이 파일이 Workspace상에 존재해도 로컬 파일시스템상에는 존재하지않는 것을 나타낸다. 따라서 로컬 파일시스템에 파일을 작성하는 경우에는 source에 null을 입력하는 것이 아니라 위와 같은 ByteArrayInputStream 오브젝트를 입력한다.
인수 force에는 이 Resource가 파일 시스템과 동기화가 이루어지지 않아도 수정 가능하도록 할지를 지정한다. 이것에 false를 입력하면 같은 이름의 파일이 로컬 파일시스템 상에 없을 경우에만 수정 할 수 있도록 한다. true를 입력하면 같은 이름의 파일이 로컬 파일 시스템에 존재하는 경우라도 soruce에 지정한 내용을 그 파일에 덮어 쓰게 된다.
인수 monitor에는 IProject.create()등의 메소드와 같이 작업의 진행 상황을 사용자에게 알리기 위한 IProgressMonitor를 지정한다. 이 인수에 null을 지정하면 진행상황은 표시되지 않는다.
폴더를 작성하기 위한 IFolder.create()메소드의 정의는 아래와 같다.
|
public void create(InputStream source, boolean local, IProgressMonitor monitor) throw CoreException |
인수 force와 monitor는 IFile의 경우와 같다. 또 인수 local에는 그 폴더를 로컬로 작성하는지 여부를 지정한다. 이 인수에 false를 지정하면 Workspace상에는 이 폴더가 작성되지만 로컬 파일 시스템 상에는 디렉토리가 생성 되지 않는다.(코드상에서 해당 자원이 로컬인지 확인하려면 IResource.isLocal()메소드를 사용한다.)
이와 같이 Workspace상의 자원이 반드시 로컬 파일 시스템과 동기화가 이루어 지는 것은 아니다. 좀더 구체적인 예를 들면, 패키지 익스플로어에 MyProject라는 프로젝트가 표시되고 있다고하면 이 MyProject라고 하는 Resource는 통상적으로 파일 시스템의 디렉토리에 맵핑되어(생성되어)있을 것이다. 그러나 패키지 익스플로어를 이용하지 않고 탐색기 등을 이용해서 해당 디렉토리를 삭제 했을 경우에 Workspace상에는 프로젝트 핸들이 존재하지만 로컬 파일 시스템에는 존재하지 않는다.
따라서 Resource 핸들을 사용해서 Workspace상의 Resource를 조작하는 경우 에는 create()나 move, delete등의 메소드를 호출하기 전에(이러한 메소드는 핸들에 맵핑된 로컬 파일 시스템의 Resource를 조작한다.)Resource 핸들에 맵핑된 실제의 로컬 파일 시스템상의 자원이 존재하는지 IResource.exists()메소드를 사용하여 체크해야 할 필요가 있다. 이와 비슷하게 IProject의 경우 에 프로젝트가 열려있지 않은경우(IProject.isOpen()==false)에는 그 프로젝트에 몇 개의 Resource가 있다고 해도 IResource.exists()메소드는 false를 리턴한다. 따라서 프로젝트 내의 Resource의 존재의 체크하기 전에IProject.open()메소드를 호출해야 한다.
2007-05-29
수정: 김상태
Eclipse의 에디터(JFace의 텍스트 문자 편집기)에서는 에디터로 편집하는 문서의 내용을 org.eclipse.jface.textIDocument의 추상 오브젝트로써 취급한다. IDocument 오브젝트는 문서 프로바이더에 의해 제공된다. XML Sample Editor에서는 XML DocumentProvider에 해당된다.
리스트3
|
XMLPartitionScanner는 문서의 의미적인 구역을 분할(Partitioning) 한다. 분할된 구역은 각각의 구문 하이라이팅이나 코드어시스트 기능을 설정하는 것이 가능하다. Java 에디터를 예로 하면, Javadoc부분에서는 Javadoc 태그의 어시스트, Java 코드 부분에서는 Java코드의 어시스트와 같이 해당 콘텍스트에 응한 기능을 제공할 수 있다.
XMLPartitionScanner에서는 코멘트(XML_COMMENT), 태그(XML_TAG)및 그 이외의 영역의 3개의 파티션으로 분할 한다.
리스트4
|
XMLpartitionScanner는 RuleBasedPartitionScanner를 상속 받아 구현 되고 있다. XML이나 프로그램의 소스코드 등, 룰에 근거한 문서를 분할 하는 경우는 org.eclipse.jface.text.rules.RuleBasedPartitonScanner를 사용하면 된다.
(1) 의 코멘트 구역의 룰은 org.eclipse.jface.text.rules.MultiLineRule로 정의 하고 있다. MultiLineRule은 시작 문자열과 종료 문자열을 지정해 매치되는 부분을 파티션으로 설정 하는 룰 이다. 또, (2) 의 태그구역의 룰을 TagRule로 정의하고 있다. 태그구역에 관해서도 코멘트 구역과 같이 new MultiLineRule(“<”, ”>”, token)으로 지정해도 좋을 것 같긴 하지만 이렇게 하면 코멘트나 XML태그 선언 모두 XML태그로 인식되기 때문에 TagRule을 리스트5와 같이 MultiLineRule을 상속 받아 독자적으로 매치의 판정을 실시하게 정의 하였다.
리스트5
|
이것에 의해서XML 문서는 그림5 와 같은 파티션으로 분할된다.
|
|
|
그림5. 분할 후의 파티션 |
SourceViewerConfiguration은 에디터의 동작을 커스터마이즈하기 위한 시작 포인트가 된다. 자동 생성된 샘플에서는 XMLConfiguration이 이에 해당한다.
Org.eclipse.jface.text.source.SourceViewerConfiguration을 상속받은 클래스가 사용되고 있다. 이와 같이 SourceViewerConfiguration의 각 메소드를 오버라이드하는 것으로, 다음과 같은 이디터의 동작을 커스터마이즈 할 수 있다.
l 코드 어시스트
l 문장 하이라이트
l 더블 클릭 시의 동작
l 자동 들여쓰기 기능
l 코드 포메터
템플릿으로 작성한 XML에디터는 코드 어시스트나 코드 포멧터의 기능은 가지고 있지 않다. 이번에는 코드 하이라이트와 더블클릭시의 동작, 특히 코드하이라이트의 구현 방법에 대해 자세히 알아보자.
리스트6
|
(1) 의 getConfiguredContentType()메소드에서는 에디터가 지원하는 파티션의 타입을 리턴 하도록 정의 한다. 또, (2) 의 getDoubleClickStrategy()메소드에서는 더블클릭시의 동작을 결정한다. Org.eclipse.jfacejface.text.ITextDoubleClickStrategy의 구현 클래스를 리턴 한다. XMLDoubleClickStrategy의 구현에 따라서 깊게 설명하지는 않겠지만, 더블 클릭 된 위치에 따라 더블 쿼츠로 둘러싸인 구역, 혹은 단어를 검출해서 해당 범위가 선택 되도록 구현 되어 있다. 그리고 (3)의 getPresentationReconciler()메소드로 에디터의 프레젠테이션(구문 하이라이팅)에 관한 설정을 구현한다.
구문 하이라이트는 org.eclipse.jface.text.prresentation.PresentationReconciler에 파티션마다 Damager와 Repairer를 설정하는 것으로 구현 된다. PregetntationReconciler는 텍스트의 변경을 검출하면 Damager를 호출하여 Damage(텍스트의 프레젠테이션을 갱신해야 하는 범위)을 산출한다. 그 다음 Repairer에 Damage를 통지하여 새로운 프레젠테이션을 취득한다.
이번 예에서는 XML_TAG구역, DEFAULT-CONTENT_TYPE구역에 각각 XMLTagScanner, XMLScanner가 org.eclipse.jface.text.rules.DefaultDamagerRepairer를 통하여 설정되어있다. XMLTagScanner의 구현은 리스트7과 같이 되어있다.
리스트7
|
이것은XML_TAG 구역을 더블쿼츠 혹은 싱글 쿼츠로 둘러싸인 영역으로 정의하고 IXMLColorConstants.STRING으로 정의된 색으로 하이라이트 한다.
XMLScanner의 구현도 유사하다. 이것은 DEFAULT-CONTENT_TYPE구역을 <? 과 ?>으로 둘러싸인 영역으로 정의하고 IXMLColorConstants.PROC_INSTR로 정의된 색으로 하이라이트 한다.
리스트8
|
파티션 내에서 룰에 정의 되지 않는 부분에 대해서는 setDefaultReturnToken()과 지정된 토큰이 적용 된다. 또, XML_COMMENT구역은 그 이상 분할할 필요는 없기 때문에 NonRuleBasedDamagerRepairer에 의해서 구역 전체를 IXMLColorConstant.XML_COMMENT로 정의된 색으로 하이라이트 한다.
텍스트 문자 편집기의 구현에는 많은 주제가 있다. 특히 중요한 것은 이번에 중심적으로 해설한 Partitioning이다. 본 고로 해설했던 대로 구문 하이라이트는 Partitioning된 구역에 대해서 설정하고, 코드 어시스트 기능 역시 파티션 마다 어시스트 프로세서를 설정하는 것으로 구현 된다.
Ps. 본 포스트는 http://www.atmarkit.co.jp/fjava/rensai3/eclipsepde03/eclipsepde03_2.html 의 문서를 Naver 인조이 제팬을 이용하여 번역한 문서 입니다.
이클립스에서 제공하는 Sample XML Editor는 내부에서 Document Provider로 FileDocumentProvider를 상속 받은 XMLDocumentProvider를 사용한다.
그런데 이 FileDocumentProvider는 org.eclipse.ui.ide에 의존하기 때문에 RCP에서는 상용할 수 없고 Plug-in에서만 사용할 수 있다.
그래서 Sample XML Editor를 RCP에서 사용하려면 DocumentProvider를 직접 구현해서 적용해야 한다.
DocumentProvider의 역할은 EditorInput으로 부터 Editor에 표시될 내용을 입력받아 IDocument를 생성해 주는 역할을 한다. 그래서 직접 구현할 부분중 핵심이 되는것이 DocumentProvider의 createDocument()메소드 이다.
AbstractDocumentProvider를 상속받아 자신만의 DocumentProvider를 만들고 상속받은 추상 메소드 들을 구현한다. 그중 createDocument()에서 IDocument의 인스턴스를 생성하여 리턴한다.
IDocument document = new Document() 로 빈 Document를 생성하여 Document의 내용을 채운후 리턴한다.
|
