com.bstek.dorado.config.xml

Class ObjectParser

java.lang.Object

com.bstek.dorado.config.xml.DispatchableXmlParser

com.bstek.dorado.config.xml.ConfigurableDispatchableXmlParser

com.bstek.dorado.config.xml.ObjectParser

All Implemented Interfaces:

Parser, XmlParser

Direct Known Subclasses:

CompositePropertyParser, GenericObjectParser

public class ObjectParser
extends ConfigurableDispatchableXmlParser

Since:

2009-12-30

Author:

Benny Bao (mailto:benny.bao@bstek.com)

Field Summary

Fields inherited from class com.bstek.dorado.config.xml.DispatchableXmlParser

SELF, SUB_PARSER_PATH_SEPERATOR, WILDCARD

Constructor Summary

Constructors

Constructor and Description
ObjectParser()

Method Summary

Methods

Modifier and Type	Method and Description
protected ObjectDefinition	createDefinition(org.w3c.dom.Element element, ParseContext context) 创建一个新的配置声明对象。
protected java.lang.Object	doParse(org.w3c.dom.Node node, ParseContext context)
java.lang.Class<?>	getAnnotationOwnerType()
protected Scope	getDefaultScope() 返回默认的最终对象作用范围。
java.lang.Class<? extends ObjectDefinition>	getDefinitionType()
java.lang.String	getImpl()
protected DefinitionReference<? extends Definition>[]	getParentDefinitionReferences(java.lang.String parentNameText, ParseContext context) 将parent属性中的配置信息转换成一组指向具体配置声明对象的引用。 例如根据parent="hr.Employee,hr.Manager"，可得到两个分别指向hr.Employee和hr.
protected void	initDefinition(ObjectDefinition definition, org.w3c.dom.Element element, ParseContext context) 初始化一个配置声明对象。
protected java.lang.Object	internalParse(org.w3c.dom.Node node, ParseContext context)
boolean	isInheritable()
boolean	isScopable()
void	setAnnotationOwnerType(java.lang.Class<?> annotationOwnerType)
void	setDefinitionType(java.lang.Class<? extends ObjectDefinition> definitionType)
void	setDefinitionType(java.lang.String definitionType) 设置要生成配置声明对象的实现类类型。例如:com.bstek.dorado.data.config.definition.
void	setImpl(java.lang.String impl) 设置配置声明对象生成的最终对象的实例化方式。 注意，有些配置声明对象并不支持复杂的实例化方式。如果将#setSupportsExpressionImpl(boolean) 属性设置为false， 那么此解析器将仅支持直接以Class名描述的实例化方式。
void	setInheritable(boolean inheritable) 设置是否允许用户通过XML节点中的parent属性来指定配置声明对象的继承关系。
void	setScopable(boolean scopable) 设置是否允许用户通过XML节点中的scope属性来指定最终对象的作用范围。

Methods inherited from class com.bstek.dorado.config.xml.ConfigurableDispatchableXmlParser

getExpressionHandler, setExpressionHandler, setPropertyParsers, setSubParsers

Methods inherited from class com.bstek.dorado.config.xml.DispatchableXmlParser

dispatchChildElements, dispatchElement, findPropertyParser, findSubParser, getPropertyParsers, getSubParsers, parse, parseProperties, parseProperty, registerPropertyParser, registerSubParser

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ObjectParser

public ObjectParser()

Method Detail

getAnnotationOwnerType

public java.lang.Class<?> getAnnotationOwnerType()

setAnnotationOwnerType

public void setAnnotationOwnerType(java.lang.Class<?> annotationOwnerType)

setDefinitionType

public void setDefinitionType(java.lang.String definitionType)
                       throws java.lang.ClassNotFoundException

设置要生成配置声明对象的实现类类型。例如:com.bstek.dorado.data.config.definition. DataTypeDefinition 。

Throws:

java.lang.ClassNotFoundException

setDefinitionType

public void setDefinitionType(java.lang.Class<? extends ObjectDefinition> definitionType)
                       throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

getDefinitionType

public java.lang.Class<? extends ObjectDefinition> getDefinitionType()

setImpl

public void setImpl(java.lang.String impl)

设置配置声明对象生成的最终对象的实例化方式。
注意，有些配置声明对象并不支持复杂的实例化方式。如果将#setSupportsExpressionImpl(boolean) 属性设置为false， 那么此解析器将仅支持直接以Class名描述的实例化方式。

See Also:

com.bstek.dorado.data.config.definition.ObjectDefinition#setImpl(String)

getImpl

public java.lang.String getImpl()

setScopable

public void setScopable(boolean scopable)

设置是否允许用户通过XML节点中的scope属性来指定最终对象的作用范围。

isScopable

public boolean isScopable()

setInheritable

public void setInheritable(boolean inheritable)

设置是否允许用户通过XML节点中的parent属性来指定配置声明对象的继承关系。

isInheritable

public boolean isInheritable()

getDefaultScope

protected Scope getDefaultScope()

返回默认的最终对象作用范围。

getParentDefinitionReferences

protected DefinitionReference<? extends Definition>[] getParentDefinitionReferences(java.lang.String parentNameText,
                                                                        ParseContext context)
                                                                             throws java.lang.Exception

将parent属性中的配置信息转换成一组指向具体配置声明对象的引用。
例如根据parent="hr.Employee,hr.Manager"，可得到两个分别指向hr.Employee和hr. Manager这两个配置声明对象的引用。

Parameters:

parentNameText - parent属性的配置信息

context - 解析上下文

Returns:

一组指向具体配置声明对象的引用。

Throws:

java.lang.Exception

createDefinition

protected ObjectDefinition createDefinition(org.w3c.dom.Element element,
                                ParseContext context)
                                     throws java.lang.Exception

创建一个新的配置声明对象。

Parameters:

element - 当前节点

context - 解析上下文

Returns:

新的配置声明对象

Throws:

java.lang.Exception

initDefinition

protected void initDefinition(ObjectDefinition definition,
                  org.w3c.dom.Element element,
                  ParseContext context)
                       throws java.lang.Exception

初始化一个配置声明对象。

Parameters:

definition - 配置声明对象

element - 当前节点

context - 解析上下文

Throws:

java.lang.Exception

internalParse

protected java.lang.Object internalParse(org.w3c.dom.Node node,
                             ParseContext context)
                                  throws java.lang.Exception

Throws:

java.lang.Exception

doParse

protected java.lang.Object doParse(org.w3c.dom.Node node,
                       ParseContext context)
                            throws java.lang.Exception

Overrides:

doParse in class DispatchableXmlParser

Throws:

java.lang.Exception