rcp（插件开发）资源管理二

IProject中的Builder与Nature

1.创建一个新的工程

如下是创建一个新的工程的代码，但是此时工程就是一个文件夹，没有任何特性

Java代码

1. publicvoid createProject(String projectName)throws CoreException{ 
2.         IWorkspace workspace = ResourcesPlugin.getWorkspace(); 
3.         IWorkspaceRoot root = workspace.getRoot(); 
4.          
5.         IProject project = root.getProject(projectName); 
6.         if(!project.exists()){ 
7.             project.create(null); 
8.             project.open(null); 
9.         } 
10.          
11.         ProjectUtil.addNature2Project(project, new String[]{LengProjectNature.ID},null); 
12.     } 

[java] view plain copy print ?

1. public void createProject(String projectName) throws CoreException{  
2.         IWorkspace workspace = ResourcesPlugin.getWorkspace();  
3.         IWorkspaceRoot root = workspace.getRoot();  
4.           
5.         IProject project = root.getProject(projectName);  
6.         if(!project.exists()){  
7.             project.create(null);  
8.             project.open(null);  
9.         }  
10.           
11.         ProjectUtil.addNature2Project(project, new String[]{LengProjectNature.ID}, null);  
12.     }  

2.为project扩展相应的nature

nature是工程特性的一种标识，eclipse中有如此多种类的project，系统是如何识别他们的。IProject对象本身没有什么特别的标识，所以区分各种不同的project，主要是nature来进行区分。例如，如果两种不同的project对象，如果有同样的一种nature特性，如果我们只需要考虑这种nature特性的时候，这两种project其实是可以等同的。可以借鉴equals方法来进行理解。

Java代码

1. <extension 
2.          id="com.leng.test.project.nature.LengProjectNature" 
3.          name="Leng Project Nature" 
4.          point="org.eclipse.core.resources.natures"> 
5.       <runtime> 
6.          <run 
7.                class="com.leng.test.project.nature.LengProjectNature"> 
8.          </run> 
9.       </runtime> 
10.       <builder 
11.             id="com.leng.test.project.nature.LengIncrementalProjectBuilder"> 
12.       </builder> 
13.    </extension> 

[java] view plain copy print ?

1. <extension  
2.          id="com.leng.test.project.nature.LengProjectNature"  
3.          name="Leng Project Nature"  
4.          point="org.eclipse.core.resources.natures">  
5.       <runtime>  
6.          <run  
7.                class="com.leng.test.project.nature.LengProjectNature">  
8.          </run>  
9.       </runtime>  
10.       <builder  
11.             id="com.leng.test.project.nature.LengIncrementalProjectBuilder">  
12.       </builder>  
13.    </extension>  

1）一个nature里面可以包含多个builder，并且用builder的id进行识别

注意：com.leng.test.project.nature.LengIncrementalProjectBuilder是builder所在的插件的id+.+builderId

2）实现一个IProjectNature类

Java代码

1. publicclass LengProjectNatureimplements IProjectNature { 
2.      
3.     private IProject project;   
4.      
5.     /**
6.      * nature的ID为plugin的ID加上nature扩展的ID
7.      */ 
8.     publicstaticfinal String ID ="com.leng.test.project.com.leng.test.project.nature.LengProjectNature";  
9.      
10.     @Override 
11.     publicvoid configure()throws CoreException { 
12.         ProjectUtil.addBuilderToProject(project,   
13.                 new String[] { LengIncrementalProjectBuilder.ID },null);   
14.     } 
15.  
16.     @Override 
17.     publicvoid deconfigure()throws CoreException { 
18.         ProjectUtil.removeBuilderFromProject(project,   
19.                 new String[] { LengIncrementalProjectBuilder.ID },null);   
20.     } 
21.  
22.     @Override 
23.     public IProject getProject() { 
24.         return project; 
25.     } 
26.  
27.     /**
28.      * setProject()和configure()的调用顺序是先调setProject()后调configure().
29.      */ 
30.     @Override 
31.     publicvoid setProject(IProject project) { 
32.         this.project = project; 
33.     } 
34.  
35. } 

[java] view plain copy print ?

1. public class LengProjectNature implements IProjectNature {  
2.       
3.     private IProject project;    
4.       
5.     /** 
6.      * nature的ID为plugin的ID加上nature扩展的ID 
7.      */  
8.     public static final String ID = "com.leng.test.project.com.leng.test.project.nature.LengProjectNature";   
9.       
10.     @Override  
11.     public void configure() throws CoreException {  
12.         ProjectUtil.addBuilderToProject(project,    
13.                 new String[] { LengIncrementalProjectBuilder.ID }, null);    
14.     }  
15.   
16.     @Override  
17.     public void deconfigure() throws CoreException {  
18.         ProjectUtil.removeBuilderFromProject(project,    
19.                 new String[] { LengIncrementalProjectBuilder.ID }, null);    
20.     }  
21.   
22.     @Override  
23.     public IProject getProject() {  
24.         return project;  
25.     }  
26.   
27.     /** 
28.      * setProject()和configure()的调用顺序是先调setProject()后调configure(). 
29.      */  
30.     @Override  
31.     public void setProject(IProject project) {  
32.         this.project = project;  
33.     }  
34.   
35. }  

3.nature的img扩展：

Java代码

1. <extension 
2.          point="org.eclipse.ui.ide.projectNatureImages"> 
3.       <image 
4.             icon="com.leng.test.project.image1" 
5.             id="com.leng.test.project.image1" 
6.             natureId="com.leng.test.project.image1"> 
7.       </image> 
8.    </extension> 

[java] view plain copy print ?

1. <extension  
2.          point="org.eclipse.ui.ide.projectNatureImages">  
3.       <image  
4.             icon="com.leng.test.project.image1"  
5.             id="com.leng.test.project.image1"  
6.             natureId="com.leng.test.project.image1">  
7.       </image>  
8.    </extension>  

依赖插件org.eclipse.ui.ide，此扩展点为特点的nature项目提供特点的图像标记，如java工程中的文件中“J”。

4.为nature扩展相应的builder

刚才说到nature是用来标识project的特性的，但是特性不能当饭吃。new一个工程里面那么多东西，而且算不是new，是其他改变工程里面资源的操作。如果说nature只是标识，那么builder就是实实在在的构建了。

当然，构建器本身是独立的，出来跟nature绑定使用，还可以直接添加到project中

Java代码

1. <extension 
2.          id="com.leng.test.project.nature.LengIncrementalProjectBuilder" 
3.          point="org.eclipse.core.resources.builders"> 
4.       <builder 
5.             callOnEmptyDelta="false" 
6.             hasNature="true" 
7.             isConfigurable="true"> 
8.          <run 
9.                class="com.leng.test.project.nature.LengIncrementalProjectBuilder"> 
10.          </run> 
11.       </builder> 
12.    </extension> 

[java] view plain copy print ?

1. <extension  
2.          id="com.leng.test.project.nature.LengIncrementalProjectBuilder"  
3.          point="org.eclipse.core.resources.builders">  
4.       <builder  
5.             callOnEmptyDelta="false"  
6.             hasNature="true"  
7.             isConfigurable="true">  
8.          <run  
9.                class="com.leng.test.project.nature.LengIncrementalProjectBuilder">  
10.          </run>  
11.       </builder>  
12.    </extension>  

hasNature：该构建器是否跟nature关联，默认为false，如果为true则必须nature存在才会触发构建

isConfigurable：设定构建器是否可以通过特定的构建触发器运行，如果为true，则可以通过ICommand.setBuilding

callOnEmptyDelta：当增量构建的增量为null时，如果设置此属性为true则始终构建，不会关构建内容是否为null。

Java代码

1. publicclass LengIncrementalProjectBuilderextends IncrementalProjectBuilder { 
2.  
3.     publicstaticfinal String ID ="com.leng.test.project.nature.LengIncrementalProjectBuilder"; 
4.      
5.     public LengIncrementalProjectBuilder() { 
6.     } 
7.  
8.     @Override 
9.     protected IProject[] build(int kind, Map args, IProgressMonitor monitor) 
10.             throws CoreException { 
11.         getCommand(); 
12.         getDelta(getProject()); 
13.          
14.         switch (kind) {   
15.         case FULL_BUILD:   
16. //          processFullBuild(monitor);  
17.             break;   
18.         case CLEAN_BUILD: 
19.             break; 
20.         default:   
21.             IResourceDelta delta = getDelta(getProject());    
22.             break;   
23.         }   
24.         returnnull; 
25.     } 
26.  
27.      
28.     @Override 
29.     protectedvoid startupOnInitialize() { 
30.         super.startupOnInitialize(); 
31.     } 
32.  
33.     /**
34.      * 清除一些保留且无用的东西
35.      */ 
36.     @Override 
37.     protectedvoid clean(IProgressMonitor monitor)throws CoreException { 
38.         super.clean(monitor); 
39.     } 
40. } 

[java] view plain copy print ?

1. public class LengIncrementalProjectBuilder extends IncrementalProjectBuilder {  
2.   
3.     public static final String ID = "com.leng.test.project.nature.LengIncrementalProjectBuilder";  
4.       
5.     public LengIncrementalProjectBuilder() {  
6.     }  
7.   
8.     @Override  
9.     protected IProject[] build(int kind, Map args, IProgressMonitor monitor)  
10.             throws CoreException {  
11.         getCommand();  
12.         getDelta(getProject());  
13.           
14.         switch (kind) {    
15.         case FULL_BUILD:    
16. //          processFullBuild(monitor);    
17.             break;    
18.         case CLEAN_BUILD:  
19.             break;  
20.         default:    
21.             IResourceDelta delta = getDelta(getProject());     
22.             break;    
23.         }    
24.         return null;  
25.     }  
26.   
27.       
28.     @Override  
29.     protected void startupOnInitialize() {  
30.         super.startupOnInitialize();  
31.     }  
32.   
33.     /** 
34.      * 清除一些保留且无用的东西 
35.      */  
36.     @Override  
37.     protected void clean(IProgressMonitor monitor) throws CoreException {  
38.         super.clean(monitor);  
39.     }  
40. }  

kind：构建类型，FULL_BUILD（全量构建），INCREMENTAL_BUILD（增量构建），

AUTO_BUILD（自动构建，也是增量的），CLEAN_BUILD（在调用build方法前调用clean方法）

getDelta：获取指定工程里面增量改变的资源内容

派生资源：派生资源就是完全由build构建出来的资源，由某一种源派生出来。

5.构建器的触发

构建器的触发有两种方式：一种是自动触发，系统资源改变时，由eclipse自动增量构建。另一种是手动构建，IWorkspace和IProject里面都有构建方法，只要获取到相关对象就可以进行构建。