扩展点中的表达式总结

本文来自：http://www.ceclipse.org/read-cec-tid-28291.html

 

在扩展点中，我们进场能够看到一些表达式：

 

 

<enabledWhen>
            <with
                  variable="activeEditor">
               <test
                     property="org.gsbp.ide.common.ui.editor.dirty">
               </test>
            </with>
 </enabledWhen>

 如上就是一段用于判断菜单是否可用的表达式。

 

扩展点里面使用表达式的功能主要存在于org.eclips.core.expression插件中

 

如下是表达式中常见的逻辑：

not  用来对表达式运行结果取反  
and  用来在多个表达式之间进行与运算，只有多个表达式都为true的时候，才会返回true，否则返回false  
or  用来在多个表达式之间进行或运算，只有多个表达式都为false的时候，才会返回false，否则返回true  
instanceof  用来判断指定的对象是否是指定类或者接口的实例  
systemTest  用来比较System系统变量中的值是否与指定值相等  
iterate  用来处理java.util.Collection的所有子对象  
equals  用来判断指定对象与预先设置的数据是否相等  
count  用来处理java.util.Collection的集合大小  
with    
resolve    
adapt  用来将选中对象转成预先指定的对象，以便更灵活的处理  
test    基于最重要的人物总是最后出场的原则，将adapt和test放在最后进行说明。  

 

 

not
not本身并没有具体的信息，只是将其子表达式的结果进行取反。通常的配置如下:

<not>
   <instanceof value="org.eclipse.core.resources.IFile"/>
</not>  

 

如果选中的对象不是文件，会返回true，因为not将instanceof的结果取反。

 

 

and

与not功能相类似，and是将所有的子结点结果进行与运算

 

<and>
   <instanceof value="org.eclipse.core.resources.IFile"/>
   <test property="org.demo.matchesPattern" value="*.html"/>
</and>  

 只有选中的对象是文件，而且名称符合*.html才会返回true。 

 

 

 

or

与not功能相类似，and是将所有的子结点结果进行与运算

 

<or>
   <instanceof value="org.eclipse.core.resources.IFolder"/>
   <instanceof value="org.eclipse.core.resources.IProject"/>
</or> 

  只有选中的对象是目录或者是项目，就会返回true，如果是文件，就会返回false。  

 

 

instanceof

用来判断指定的对象是否是指定类或者接口的实例

 

<instanceof value="org.eclipse.core.resources.IFile"/>  

 只有选中的对象是文件的实例时，如org.eclipse.core.resource.internal.File时，才会返回true.  

 

 

 

systemTest

用来比较System系统变量中的值是否与指定值相等,它会调用System.getProperty("xxx")方法取得系统变量值，，并将该值与指定值进行比较。

 

 

<systemTest property="encoding" value="GB2312"/> 

 那么该配置只有当前JVM的默认编码为GB2312（即中文时），才会返回true. 

 

 

iterate

iterate是一个非常少用的属性，它主要用来处理java.util.Collection中子元素的内容。它会逐渐遍历集合的所有子元素，然后再将每个子元素放入子表达式中进行计算，其实operator有or和and两种可选，是用来支持子表达的或运算和与运算，与前面的or和and相似。

 

 

<iterate operator="or">
         <instanceof value="org.eclipse.core.resources.IFile"/>
</iterate>

 

 

equals

在配置文件中，其实只有一种字符串数据类型，而在Java中的数据类型丰富的多，因此Eclipse提供了一整套的转换机制，用来将字符串转成相应的Java类型，下面是相应的转换规则:1. 对于字符串"true"，将会转成Boolean.TRUE2. 对于字符串"false"，将会转成Boolean.FALSE3. 如果字符串中有小数点，将会转成浮点数Float4. 如果字符串中只有数字，就会转成整数Integer5. 如果以上的转换出现错误，或者不符合以上情况，就会转成字符串6. 如果希望使用字符串true，或者1.2之类的数据，而不被转成Boolean.True和相应的Float，就使用单绰号'，如"''true"，就会转成"true"，而不是Boolean.True

 

 

<equals value="100"/>  

 

 

count

用来验证一个java.util.Collection中的size是否符合要求，这个值可以有以下几种:v *，表示任意数量v ?，表示0或1个数量v +，表示至少一个数量v 数字，表示size要等于这个指定的数量

 

 

<count value="0" />

 这个属性虽然用的少，但是却不可少，以资源管理器为例，当一个工作区没有任何项目的时候，那么对应的size就为0，如果需要在这种情况出现一个菜单，那么就肯定需要这样一个表达式才能正确的处理。 

 

 

with

通过variable属性取得选中对象的相应数据，比如通过选中对象的getAffectedProjects方法得到一个java.util.Collection对象，再通过iterate和test来进行表达式处理。

 

<with variable="affectedProjects">
     <iterate operator="or">
         <test property="org.demo.projectNature" value="org.eclipse.jdt.core.javanature"/>
     </iterate>
</with>  

 

 

resolve

它和with属性基本一致，但是它多了一个args属性，从而有更高的灵活性，其它方面与with并无区别。

 

<resolve variable="pluginDescriptor" args="org.eclipse.core.runtime">
     <test property="org.demo.isActive"/> 
</resolve>

 

 

adapt

adapter是Eclipse架构的根本所在，它不仅仅解决了上下文环境的问题，对系统的扩展和灵活性都是一个非常好的解决方案，因此在表达式中也充分的利用这个特点。它可以将待处理的对象转换成指定的对象，这样也会有效的增加表达式的灵活性。

 

<adapt type="org.eclipse.core.resources.IResource">
    <test property="org.eclipse.core.resources.extension"         value="datasetx"/>
</adapt>

 

它表示会先将指定的对象通过adapter方式转成一个IResource的实例，如果转换成功，再判断其扩展名是否为datasetx，如果转换不成功，也会返回false。

 

 

test
以上提供了很多功能，但是可能对于开发人员，并不能完全满足他们相应的需求。所以Expression插件提供了test结点，这个结点允许用户通过一个扩展点来定义各种新的表达式处理功能，象org.eclipse.core.resources就提供了对扩展名等一系列的支持。在以后的文章将会详细的描述如何进行扩展。

 

<adapt type="org.eclipse.core.resources.IResource">
    <test property="org.eclipse.core.resources.extension"         value="datasetx"/>
</adapt>

 

这个例子会调用，org.eclipse.core.internal.propertytester.ResourcePropertyTester类来处理数据，从而获得更高的灵活性

 

注意：org.eclipse.core.resources.extension中的org.eclipse.core.resources是

org.eclipse.core.expressions.propertyTesters扩展中的命名空间，extension才是定义的属性。

 

 

最后关于test 的使用，涉及到另一个扩展点，org.eclipse.core.expressions.propertyTesters，自己定义的property

必须扩展一个PropertyTester来判断合法性。关于org.eclipse.core.expressions.propertyTesters扩展，

参考：http://salever.iteye.com/blog/944824