com.byc.natures;

 org.eclipse.core.resources.IProject;

 org.eclipse.core.resources.IProjectNature;

 org.eclipse.core.runtime.CoreException;

/**
 * 
 * @author Bai Yucheng 2008-4-28
 * 
 */

{
 private IProject project;

 public void configure() throws CoreException {
  //do nothing
 }

 public void deconfigure() throws CoreException {
  //do nothing
 }

 public IProject getProject() {
  return project;
 }

 public void setProject(IProject iproject) {
  project = iproject;
 }

}

2. 添加扩展点：org.eclipse.core.resources.natures，设置class属性为我们的nature

<extension
      id="com.byc.MyProjectNature"
      name="Project Nature"
      point="org.eclipse.core.resources.natures">
   <runtime>
      <run
            class="com.byc.natures.MyProjectNature">
      </run>
   </runtime>
</extension>

3. 在新建工程的向导中添加我们的nature，添加方法为：

private void addProjectNature(IProject project) throws CoreException {
   if (!project.hasNature(PROJECT_NATURE)) {
   try {
    IProjectDescription description = project.getDescription();
    String[] natures = description.getNatureIds();
    String[] newNatures = new String[natures.length + 1];
    System.arraycopy(natures, 0, newNatures, 0, natures.length);
    newNatures[natures.length] = PROJECT_NATURE;
    description.setNatureIds(newNatures);
    project.setDescription(description, null);
   } catch (CoreException e) {
    e.printStackTrace();
   }
  }
 }

2. EMF生成的方法都带有“@generated”标签。EMF重新生成代码时不会覆盖用户添加的方法（不带有@generated）。

3. 关于URI（Uniform Resource Identifier）

在EMF 中是通过URI来标识package的，并且通过URI来唯一的确定resources。URI包括三个部分：a scheme, a scheme-specific part和an optional fragment。scheme主要决定了访问

资源的协议；比如：Platform:/resource/……中的platform。scheme-specific part包含一些authority, device和一些segments，如file:/c:/dir1/dir2/myfile.xml，file是协议，没有authority，c:是device,剩下的3个是segments。URI fragment 标识了resource内部的某个具体的内容。如：file:/c:/dir1/dir2/myfile.xml#loc中的#loc。 EMF通过带有fragment的URI来访问资源中的EObjects。

4. 关于URIConverter

URIConverter的作用是normalize一个输入URI，使之成为一个实际的针对某个resource的URI。它可以把namespace URIs（比如：http:///com/example/epo2.ecore）映射到物理文件的URIs, 或者重定向旧的（或别名）的URI参考到一个具体的实际的location。一个URIConverter维护一个URI到URI的映射集合。比如，把一个命名空间URI映射到物理文件：

URIConverter converter = new URIConverterImpl();

URI uri1 = URI.createURI("http:///somemodel.ecore");

URI uri2 =URI.createURI("platform:/resource/project/somemodel.ecore");

converter.getURIMap().put(uri1, uri2);

在如下面代码：

URI normalized = converter.normalize(uri1);

System.out.println(normalized);

打印的结果是：platform:/resource/project/somemodel.ecore

URIConverter.normalize()方法只是简单的通过映射的map把key替换成了相应的value。

URIConverter的最原始是应用在resource sets，用来定位resources.

5. 关于Resource和ResourceSet

Resource 表示一个持久化的EOjbects的容器；ResourceSet表示一组Resource的集合，集合中的Resource同时创建或加载。Resource中比较重要的就是save和load方法，还有通过URI fragments访问资源中的Object的机制，如：

Resource resource =…

Item item = (Item)resource.getEObject("//@orders.0/@items.2");

Item item =…

String fragment = resource.getURIFragment(item);

上面代码中的两个方法，getEObject通过带有fregment的URI获得一个EObject，与之相反的方法getURIFragment()通过EObject获得相应的fragment path。

ResourceSet中有些重要的方法：

createResource()创建一个空的Resource；

getResource()通过resource的URI来创建Resource；

getEObject()，通过URI中的fregment来获得具体的EObject对象。

6. 关于Resource.Factory

用来创建Resource，resource factory 要注册到Registry实例中。一个factory 可以通过多种方式的URIs来注册，包括URI scheme或者URI的extension。在插件方式的应用中，通过扩展点的方式在插件加载的时候注册descriptor。下面是Resource的源代码

public interface Resource extends Notifier

{

interface Factory

{

Resource createResource(URI uri);

interface Descriptor

{

Factory createFactory();

}

interface Registry

{

Factory getFactory(URI uri);

Map getProtocolToFactoryMap();

String DEFAULT_EXTENSION = "*";

Map getExtensionToFactoryMap();

Registry INSTANCE = new ResourceFactoryRegistryImpl

();

}

}

}

下面是Registry中的getFactory()方法的算法（引用原文）：

1. Check for a factory in the protocolToFactoryMap, using

the scheme of the URI.

2. If nothing was found, check the extensionToFactoryMap

using the file extension of the URI.

3. If still nothing was found, check the

extensionToFactoryMap using the DEFAULT_EXTENSION

(that is, the wildcard character "*").

4. If no extension match was found, call the

delegatedGetFactory() method. This allows you to supply

your own factory registry, with its own lookup

criteria.

5. If a descriptor was found, instead of an actual

factory, call the createFactory() method on the

descriptor to create the factory.

6. Finally, return the factory if one was found, or null.

tip：emf缺省的序列化方式是XMI。因此，如果没有找到相应注册的factory缺省的就会返回以*注册的缺省的factory，这个factory是针对XMI的factory，即XMIResourceFactoryImpl。如，对于XMIResourceFactoryImpl的扩展点声明:

<extension point = "org.eclipse.emf.ecore.extension_parser">

<parser type="*" class="org.eclipse.emf.ecore.xmi.impl.XMIResourceFactoryImpl"/>

</extension>

当非插件应用的时候，可以通过手工的方式来注册factory，如：

Resource.Factory.Registry.INSTANCE.getExtensionToFactoryMap().put

("*", new XMIResourceFactoryImpl());

7. Resource通过两种方式实现XML和XMI。

1) XML

实现Resource存储的重要方法是save, 只有在方法eIsSet()返回true时，相关的属性和引用才会被序列化到xml中。对于存储的xml文件的格式可以通过设置OPTION_XML_MAP属性来完成，如下面原文：

There are several reasons why you might want to use OPTION_XML_MAP when saving a resource:

1. You want to save your data so that it conforms to a particular XML Schema.

2. You have changed your model, and you want the resource to produce XML documents that will work with the old version of the model.

3. You want to design your own XML format without changing your model.

2) XMI

XMI和XML基本相同，XMIResourceImpl就是

XMLResourceImpl的简单继承，只是在引用objects时使用XMI IDs

Provides中判断添加Decorator的条件。最后就要注册我们的Provider了。添加扩展点：

下面看几个例子：
"^The"：表示所有以"The"开始的字符串（"There"，"The cat"等）；
"of despair$"：表示所以以"of despair"结尾的字符串；
"^abc$"：表示开始和结尾都是"abc"的字符串——呵呵，只有"abc"自己了；
"notice"：表示任何包含"notice"的字符串。

'*'，'+'和'?'这三个符号，表示一个或一序列字符重复出现的次数。它们分别表示“没有或
更多”，“一次或更多”还有“没有或一次”。下面是几个例子：

"ab*"：表示一个字符串有一个a后面跟着零个或若干个b。（"a", "ab", "abbb",……）；
"ab+"：表示一个字符串有一个a后面跟着至少一个b或者更多；
"ab?"：表示一个字符串有一个a后面跟着零个或者一个b；
"a?b+$"：表示在字符串的末尾有零个或一个a跟着一个或几个b。

也可以使用范围，用大括号括起，用以表示重复次数的范围。

"ab{2}"：表示一个字符串有一个a跟着2个b（"abb"）；
"ab{2,}"：表示一个字符串有一个a跟着至少2个b；
"ab{3,5}"：表示一个字符串有一个a跟着3到5个b。

请注意，你必须指定范围的下限（如："{0,2}"而不是"{,2}"）。还有，你可能注意到了，'*'，'+'和
'?'相当于"{0,}"，"{1,}"和"{0,1}"。
还有一个'¦'，表示“或”操作：

"hi¦hello"：表示一个字符串里有"hi"或者"hello"；
"(b¦cd)ef"：表示"bef"或"cdef"；
"(a¦b)*c"：表示一串"a""b"混合的字符串后面跟一个"c"；

'.'可以替代任何字符：

"a.[0-9]"：表示一个字符串有一个"a"后面跟着一个任意字符和一个数字；
"^.{3}$"：表示有任意三个字符的字符串（长度为3个字符）；

方括号表示某些字符允许在一个字符串中的某一特定位置出现：

"[ab]"：表示一个字符串有一个"a"或"b"（相当于"a¦b"）；
"[a-d]"：表示一个字符串包含小写的'a'到'd'中的一个（相当于"a¦b¦c¦d"或者"[abcd]"）；
"^[a-zA-Z]"：表示一个以字母开头的字符串；
"[0-9]%"：表示一个百分号前有一位的数字；
",[a-zA-Z0-9]$"：表示一个字符串以一个逗号后面跟着一个字母或数字结束。

你也可以在方括号里用'^'表示不希望出现的字符，'^'应在方括号里的第一位。（如："%[^a-zA-Z]%"表
示两个百分号中不应该出现字母）。

为了逐字表达，必须在"^.$()¦*+?{\"这些字符前加上转移字符'\'。

请注意在方括号中，不需要转义字符。