org.act.xservices.rt.metaset
接口 Metaset

所有已知实现类:
MetasetImpl

public interface Metaset

自从:
JDK1.5
版本:
1.0 2005-06-23, 1.1 2008-05-01
作者:
liujian [liujian@act.buaa.edu.cn], Lizq [lizq@act.buaa.edu.cn]

方法摘要
 boolean addAttribute(Attribute attribute)
          向此Metasest中添加一个属性值
 boolean addAttribute(java.lang.String pathExp, Attribute attribute)
          首先查找 匹配过滤路径的所有元素 然后向这些元素中添加属性attribute,如果有一个元素添加失败则返回false TODO 注意此类操作无法回滚,有待修改。
 boolean addChildren(Metaset child)
          向此Metaset中添加一个子元素
 boolean addChildren(java.lang.String pathExp, Metaset child)
          首先查找 匹配过滤路径的所有元素 然后向这些元素中添加子元素child,如果有一个元素添加失败则返回false TODO 注意此类操作无法回滚,有待修改。
 Metaset car()
          取此元素的第一个子元素,如果不存在则返回null
 Metaset cdr()
          取此元素除第一个子元素外的所有子元素,封装在一个空的Metaset中 如果不存在则返回null
 java.lang.Object clone()
          已过时。 
 Metaset copy()
          返回此元素的一个深度克隆
 boolean equals(java.lang.Object o)
           
 Metaset filter(java.lang.String pathExp)
          先根据 过滤路径表达式字符串 生成 过滤路径表达式expression, 然后在此 metaset 中选择 匹配 过滤路径表达式expression 的所有子Metaset.如果没有符合条件的元素,则返回null 例如:
element.filter(".
 Metaset filter(java.lang.String path, java.lang.String attrName)
          已过时。 
 Metaset filter(java.lang.String path, java.lang.String attrName, java.lang.String attrValue)
          已过时。 
 java.util.List<Attribute> getAttributes()
          获得此Metaset的属性列表
 java.util.List<Metaset> getChildrens()
          获得此Metaset的子元素列表
 java.lang.String getEncoding()
          获得此Metaset所表示XML的编码方式
 Metaset getFather()
          获得此Metaset的父元素
 java.lang.String getFullStringName()
          获得此Metaset元素的QName的字符串形式 如: "{" + Namespace URI + "}" + local part
 int getHeight()
          返回此Metaset所表示树形结构的深度
 int getLeafCount()
          返回此Metaset所表示树形结构的叶子节点数
 java.lang.String getLocalPart()
          获得此Metaset的LocalPart Name
 int getMetasetPosition(Metaset childMetaset)
          获得所给子元素的位置
 java.lang.String getNamespaceURI()
          获得此Metaset的 QName 的 NamespaceURI
 java.lang.String getPrefix()
          获得此Metaset的QName的Prefix
 javax.xml.namespace.QName getQName()
          获得此Metaset的QName
 java.lang.String getQualifiedName()
          获得此Metaset元素的限定名称的字符串形式 如: “prefix:localpart”
 java.lang.String getTargetNamespace()
          获得此元素所在的 TargetNamespace URI
 java.lang.String getValue()
          获得此Metaset的元素值
 void insert(Metaset child, int position)
          在子元素序列的位置 position 上插入所给元素
 boolean isEmpty()
          判断此Metaset是否有子元素
 boolean removeAttribute(Attribute attribute)
          删除所给的属性
 boolean removeAttribute(java.lang.String pathExp, Attribute attribute)
          首先查找 匹配过滤路径的所有元素 然后在这些元素中 删除属性attribute,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。
 boolean removeAttributeByPath(java.lang.String pathExp, java.lang.String attrName)
          首先查找 匹配过滤路径的所有元素 然后在这些元素中删除属性名为attrName的属性,如果有一个属性删除失败则返回false TODO 注意此类操作无法回滚,有待修改。
 boolean removeAttributeByPath(java.lang.String pathExp, java.lang.String attrName, java.lang.String attrValue)
          首先查找 匹配过滤路径的所有元素 然后在这些元素中删除 属性名为attrName且属性值为attrValue 的属性,如果有一个属性删除失败则返回false TODO 注意此类操作无法回滚,有待修改。
 boolean removeChildren(Metaset childElement)
          在子元素序列中删除所给的子元素
 boolean removeChildren(java.lang.String pathExp, Metaset child)
          首先查找 匹配过滤路径的所有元素 然后在这些元素中 删除子元素child ,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。
 boolean removeElements(java.lang.String pathExp)
          将匹配 过滤路径 的所有元素从此Metaset中删除,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。
 java.lang.String selectorAttributeValue(java.lang.String pathExp, java.lang.String attrLocalName)
          首先查找 匹配过滤路径的第一个元素 然后返回此元素中属性名为attrLocalName的属性的属性值,如果不存在则返回null
 javax.xml.namespace.QName selectorElementName(java.lang.String pathExp)
          返回匹配过滤路径的第一个元素的元素名称,如果不存在则返回null 例如:
element.selector(".\\*); 将返回当前元素的第一个子元素的元素名
 java.util.List<java.lang.String> selectorsAttributeValue(java.lang.String pathExp, java.lang.String attrLocalName)
          首先查找 匹配过滤路径的所有元素 然后以 List 的形式返回这些元素中 属性名为attrLocalName的属性的属性值,如果不存在则返回null
 java.util.List<javax.xml.namespace.QName> selectorsElementName(java.lang.String pathExp)
          返回匹配过滤路径的所有元素的元素名称,如果不存在则返回null 例如:
element.selectors(".\\*"); 将返回当前元素的所有子元素的元素名
 void setEncoding(java.lang.String encoding)
          设置此Metaset所表示XML的编码方式
 void setFather(Metaset father)
          设置此Metaset的父元素
 void setQName(javax.xml.namespace.QName name)
          设置此Metaset的QName
 void setTargetNamespace(java.lang.String targetNamespace)
          设置此元素的 targetNamespace 属性
 void setValue(java.lang.String value)
          设置此Metaset的元素值
 java.lang.String toDocument()
           
 java.lang.String toFormatXML()
          返回添加换行后的XML形式,便于查看
 java.lang.String toXML()
          返回此Metaset的XML文本字符串
 

方法详细信息

getNamespaceURI

java.lang.String getNamespaceURI()
获得此Metaset的 QName 的 NamespaceURI

返回:

getPrefix

java.lang.String getPrefix()
获得此Metaset的QName的Prefix

返回:

getLocalPart

java.lang.String getLocalPart()
获得此Metaset的LocalPart Name

返回:

getFullStringName

java.lang.String getFullStringName()
获得此Metaset元素的QName的字符串形式 如: "{" + Namespace URI + "}" + local part

返回:

getQualifiedName

java.lang.String getQualifiedName()
获得此Metaset元素的限定名称的字符串形式 如: “prefix:localpart”

返回:

getQName

javax.xml.namespace.QName getQName()
获得此Metaset的QName

返回:

setQName

void setQName(javax.xml.namespace.QName name)
设置此Metaset的QName

参数:
name -

setValue

void setValue(java.lang.String value)
设置此Metaset的元素值

参数:
value -

getValue

java.lang.String getValue()
获得此Metaset的元素值

返回:

setFather

void setFather(Metaset father)
设置此Metaset的父元素

参数:
father -

getFather

Metaset getFather()
获得此Metaset的父元素

返回:

getEncoding

java.lang.String getEncoding()
获得此Metaset所表示XML的编码方式

返回:

setEncoding

void setEncoding(java.lang.String encoding)
设置此Metaset所表示XML的编码方式

参数:
encoding -

getAttributes

java.util.List<Attribute> getAttributes()
获得此Metaset的属性列表

返回:

getChildrens

java.util.List<Metaset> getChildrens()
获得此Metaset的子元素列表

返回:

toXML

java.lang.String toXML()
返回此Metaset的XML文本字符串

返回:

toFormatXML

java.lang.String toFormatXML()
返回添加换行后的XML形式,便于查看

返回:

toDocument

java.lang.String toDocument()
返回:

filter

Metaset filter(java.lang.String pathExp)
先根据 过滤路径表达式字符串 生成 过滤路径表达式expression, 然后在此 metaset 中选择 匹配 过滤路径表达式expression 的所有子Metaset.如果没有符合条件的元素,则返回null 例如:
element.filter(".\\abc"); 将选择当前Metaset的子Metaset中名为abc的所有Metaset
element.filter("abc\\abc"); 将选择当前Metaset的子Metaset中名为abc的所有Metaset
element.filter(".\\*); 将选择当前Metaset的所有子Metaset
注意:所有选择出的满足条件的Metaset将作为名字为空的Metaset的子Metaset。

参数:
path -
返回:

filter

@Deprecated
Metaset filter(java.lang.String path,
                          java.lang.String attrName)
已过时。 

推荐构造完整的路径表达式,使用方法 filter(String pathExp)。 从当前的Metaset中选择其过滤路径为path且包含属性attrName的子Metaset。
element.filter(".\\abc", "name"); 将选择当前Metaset的子Metaset中名为abc且包含属性name的所有Metaset
element.filter("abc\\abc", "name"); 将选择当前Metaset的子Metaset中名为abc且包含属性的所有Metaset
element.filter(".\\*", "name"); 将选择当前Metaset的所有包含属性name的子Metaset
注意:所有选择出的满足条件的Metaset将作为名字为空的Metaset的子Metaset。

参数:
path -
attrName -
返回:

filter

@Deprecated
Metaset filter(java.lang.String path,
                          java.lang.String attrName,
                          java.lang.String attrValue)
已过时。 

推荐构造完整的路径表达式,使用方法 filter(String pathExp)。 从当前的Metaset中选择其过滤路径为path且包含属性attrName且其属性值为attrValue的子Metaset。

参数:
path -
attrName -
attrValue -
返回:

selectorElementName

javax.xml.namespace.QName selectorElementName(java.lang.String pathExp)
返回匹配过滤路径的第一个元素的元素名称,如果不存在则返回null 例如:
element.selector(".\\*); 将返回当前元素的第一个子元素的元素名

参数:
pathExp -
返回:

selectorsElementName

java.util.List<javax.xml.namespace.QName> selectorsElementName(java.lang.String pathExp)
返回匹配过滤路径的所有元素的元素名称,如果不存在则返回null 例如:
element.selectors(".\\*"); 将返回当前元素的所有子元素的元素名

参数:
pathExp -
返回:

selectorAttributeValue

java.lang.String selectorAttributeValue(java.lang.String pathExp,
                                        java.lang.String attrLocalName)
首先查找 匹配过滤路径的第一个元素 然后返回此元素中属性名为attrLocalName的属性的属性值,如果不存在则返回null

参数:
pathExp -
attrLocalName -
返回:

selectorsAttributeValue

java.util.List<java.lang.String> selectorsAttributeValue(java.lang.String pathExp,
                                                         java.lang.String attrLocalName)
首先查找 匹配过滤路径的所有元素 然后以 List 的形式返回这些元素中 属性名为attrLocalName的属性的属性值,如果不存在则返回null

参数:
pathExp -
attrLocalName -
返回:

addAttribute

boolean addAttribute(Attribute attribute)
向此Metasest中添加一个属性值

参数:
attribute -
返回:

addChildren

boolean addChildren(Metaset child)
向此Metaset中添加一个子元素

参数:
child -
返回:

addAttribute

boolean addAttribute(java.lang.String pathExp,
                     Attribute attribute)
首先查找 匹配过滤路径的所有元素 然后向这些元素中添加属性attribute,如果有一个元素添加失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
attribute -
返回:

addChildren

boolean addChildren(java.lang.String pathExp,
                    Metaset child)
首先查找 匹配过滤路径的所有元素 然后向这些元素中添加子元素child,如果有一个元素添加失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
child -
返回:

removeAttribute

boolean removeAttribute(Attribute attribute)
删除所给的属性

参数:
attribute -
返回:

removeChildren

boolean removeChildren(Metaset childElement)
在子元素序列中删除所给的子元素

参数:
childElement -
返回:

removeAttribute

boolean removeAttribute(java.lang.String pathExp,
                        Attribute attribute)
首先查找 匹配过滤路径的所有元素 然后在这些元素中 删除属性attribute,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
attribute -
返回:

removeChildren

boolean removeChildren(java.lang.String pathExp,
                       Metaset child)
首先查找 匹配过滤路径的所有元素 然后在这些元素中 删除子元素child ,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
child -
返回:
另请参见:
removeChildren(java.lang.String, org.act.xservices.rt.metaset.Metaset)

removeElements

boolean removeElements(java.lang.String pathExp)
将匹配 过滤路径 的所有元素从此Metaset中删除,如果有一个元素删除失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
返回:

removeAttributeByPath

boolean removeAttributeByPath(java.lang.String pathExp,
                              java.lang.String attrName)
首先查找 匹配过滤路径的所有元素 然后在这些元素中删除属性名为attrName的属性,如果有一个属性删除失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
attrName -
返回:

removeAttributeByPath

boolean removeAttributeByPath(java.lang.String pathExp,
                              java.lang.String attrName,
                              java.lang.String attrValue)
首先查找 匹配过滤路径的所有元素 然后在这些元素中删除 属性名为attrName且属性值为attrValue 的属性,如果有一个属性删除失败则返回false TODO 注意此类操作无法回滚,有待修改。 add by lizq 20080509

参数:
pathExp -
attrName -
attrValue -
返回:

clone

@Deprecated
java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException
已过时。 

如果希望获得深度克隆,可使用copy()方法

返回:
抛出:
java.lang.CloneNotSupportedException

copy

Metaset copy()
             throws java.io.IOException,
                    java.lang.ClassNotFoundException
返回此元素的一个深度克隆

返回:
抛出:
java.io.IOException
java.lang.ClassNotFoundException
另请参见:
copy()

car

Metaset car()
取此元素的第一个子元素,如果不存在则返回null

返回:

cdr

Metaset cdr()
取此元素除第一个子元素外的所有子元素,封装在一个空的Metaset中 如果不存在则返回null

返回:

getHeight

int getHeight()
返回此Metaset所表示树形结构的深度

返回:

getLeafCount

int getLeafCount()
返回此Metaset所表示树形结构的叶子节点数

返回:

equals

boolean equals(java.lang.Object o)
覆盖:
java.lang.Object 中的 equals
参数:
o -
返回:

isEmpty

boolean isEmpty()
判断此Metaset是否有子元素

返回:

getMetasetPosition

int getMetasetPosition(Metaset childMetaset)
获得所给子元素的位置

参数:
childMetaset -
返回:

insert

void insert(Metaset child,
            int position)
在子元素序列的位置 position 上插入所给元素

参数:
child -
position -

getTargetNamespace

java.lang.String getTargetNamespace()
获得此元素所在的 TargetNamespace URI

返回:

setTargetNamespace

void setTargetNamespace(java.lang.String targetNamespace)
设置此元素的 targetNamespace 属性

参数:
targetNamespace -