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.     } 

public void createProject(String projectName) throws CoreException{
		IWorkspace workspace = ResourcesPlugin.getWorkspace();
		IWorkspaceRoot root = workspace.getRoot();
		
		IProject project = root.getProject(projectName);
		if(!project.exists()){
			project.create(null);
			project.open(null);
		}
		
		ProjectUtil.addNature2Project(project, new String[]{LengProjectNature.ID}, null);
	}

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> 

<extension
         id="com.leng.test.project.nature.LengProjectNature"
         name="Leng Project Nature"
         point="org.eclipse.core.resources.natures">
      <runtime>
         <run
               class="com.leng.test.project.nature.LengProjectNature">
         </run>
      </runtime>
      <builder
            id="com.leng.test.project.nature.LengIncrementalProjectBuilder">
      </builder>
   </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. } 

public class LengProjectNature implements IProjectNature {
	
	private IProject project;  
	
	/**
	 * nature的ID为plugin的ID加上nature扩展的ID
	 */
	public static final String ID = "com.leng.test.project.com.leng.test.project.nature.LengProjectNature"; 
	
	@Override
	public void configure() throws CoreException {
	    ProjectUtil.addBuilderToProject(project,  
	            new String[] { LengIncrementalProjectBuilder.ID }, null);  
	}

	@Override
	public void deconfigure() throws CoreException {
	    ProjectUtil.removeBuilderFromProject(project,  
	            new String[] { LengIncrementalProjectBuilder.ID }, null);  
	}

	@Override
	public IProject getProject() {
		return project;
	}

	/**
	 * setProject()和configure()的调用顺序是先调setProject()后调configure().
	 */
	@Override
	public void setProject(IProject project) {
		this.project = project;
	}

}

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> 

<extension
         point="org.eclipse.ui.ide.projectNatureImages">
      <image
            icon="com.leng.test.project.image1"
            id="com.leng.test.project.image1"
            natureId="com.leng.test.project.image1">
      </image>
   </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> 

<extension
         id="com.leng.test.project.nature.LengIncrementalProjectBuilder"
         point="org.eclipse.core.resources.builders">
      <builder
            callOnEmptyDelta="false"
            hasNature="true"
            isConfigurable="true">
         <run
               class="com.leng.test.project.nature.LengIncrementalProjectBuilder">
         </run>
      </builder>
   </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. } 

public class LengIncrementalProjectBuilder extends IncrementalProjectBuilder {

	public static final String ID = "com.leng.test.project.nature.LengIncrementalProjectBuilder";
	
	public LengIncrementalProjectBuilder() {
	}

	@Override
	protected IProject[] build(int kind, Map args, IProgressMonitor monitor)
			throws CoreException {
		getCommand();
		getDelta(getProject());
		
		switch (kind) {  
	    case FULL_BUILD:  
//	        processFullBuild(monitor);  
	        break;  
	    case CLEAN_BUILD:
	    	break;
	    default:  
	        IResourceDelta delta = getDelta(getProject());   
	        break;  
	    }  
		return null;
	}

	
	@Override
	protected void startupOnInitialize() {
		super.startupOnInitialize();
	}

	/**
	 * 清除一些保留且无用的东西
	 */
	@Override
	protected void clean(IProgressMonitor monitor) throws CoreException {
		super.clean(monitor);
	}
}

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

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

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

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

5.构建器的触发

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