首页 > 代码库 > Expression

Expression

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

1.<enabledWhen>  2.            <with  3.                  variable="activeEditor">  4.               <test  5.                     property="org.gsbp.ide.common.ui.editor.dirty">  6.               </test>  7.            </with>  8. </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="http://www.mamicode.com/org.eclipse.core.resources.IFile"/></not>  

  

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

 and

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

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

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

 

or

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

<or>   <instanceof value="http://www.mamicode.com/org.eclipse.core.resources.IFolder"/>   <instanceof value="http://www.mamicode.com/org.eclipse.core.resources.IProject"/></or> 

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

 

instanceof

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

<instanceof value="http://www.mamicode.com/org.eclipse.core.resources.IFile"/>  

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

systemTest

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

<systemTest property="encoding" value="http://www.mamicode.com/GB2312"/> 

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

 

iterate

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

<iterate operator="or">         <instanceof value="http://www.mamicode.com/org.eclipse.core.resources.IFile"/></iterate>

equals

在配置文件中,其实只有一种字符串数据类型,而在Java中的数据类型丰富的多,因此Eclipse提供了一整套的转换机制,用来将字符串转成相应的Java类型,下面是相应的转换规则:

1. 对于字符串"true",将会转成Boolean.TRUE

2. 对于字符串"false",将会转成Boolean.FALSE

3. 如果字符串中有小数点,将会转成浮点数Float

4. 如果字符串中只有数字,就会转成整数Integer

5. 如果以上的转换出现错误,或者不符合以上情况,就会转成字符串

6. 如果希望使用字符串true,或者1.2之类的数据,而不被转成Boolean.True和相应的Float,就使用单引号‘,如"‘true‘",就会转成"true",而不是Boolean.True

<equals value="http://www.mamicode.com/100"/>  

  

count

用来验证一个java.util.Collection中的size是否符合要求,这个值可以有以下几种:

v *,表示任意数量

v ?,表示0或1个数量

v +,表示至少一个数量

v 数字,表示size要等于这个指定的数量

<count value="http://www.mamicode.com/0" />

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

  

with

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

<with variable="affectedProjects">     <iterate operator="or">         <test property="org.demo.projectNature" value="http://www.mamicode.com/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="http://www.mamicode.com/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="http://www.mamicode.com/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

Expression