Class XmlObjectBase
- java.lang.Object
-
- org.apache.xmlbeans.impl.values.XmlObjectBase
-
- All Implemented Interfaces:
Serializable
,TypeStoreUser
,SimpleValue
,XmlObject
,XmlTokenSource
- Direct Known Subclasses:
JavaBase64Holder
,JavaBooleanHolder
,JavaDecimalHolder
,JavaDoubleHolder
,JavaFloatHolder
,JavaGDateHolderEx
,JavaGDurationHolderEx
,JavaHexBinaryHolder
,JavaIntegerHolder
,JavaIntHolder
,JavaLongHolder
,JavaQNameHolder
,JavaStringHolder
,JavaUriHolder
,XmlAnySimpleTypeImpl
,XmlComplexContentImpl
,XmlListImpl
,XmlUnionImpl
public abstract class XmlObjectBase extends Object implements TypeStoreUser, Serializable, XmlObject, SimpleValue
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface org.apache.xmlbeans.XmlObject
XmlObject.Factory
-
-
Field Summary
Fields Modifier and Type Field Description static ValidationContext
_voorVc
static short
KIND_SETTERHELPER_ARRAYITEM
static short
KIND_SETTERHELPER_SINGLETON
static short
MAJOR_VERSION_NUMBER
static short
MINOR_VERSION_NUMBER
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods Modifier and Type Method Description XmlObject
_copy()
Same as copy() but unsynchronized.XmlObject
_copy(XmlOptions xmlOptions)
Same as copy() but unsynchronized.XmlObject
_set(XmlObject src)
Same as set() but unsynchronized.void
attach_store(TypeStore store)
Called to initialize the TypeStore associated with this XmlObject implementation.BigDecimal
bigDecimalValue()
Deprecated.replaced withgetBigDecimalValue()
BigInteger
bigIntegerValue()
Deprecated.replaced withgetBigIntegerValue()
boolean
booleanValue()
Deprecated.replaced withgetBooleanValue()
boolean
build_nil()
A store will call back on build_nil after we've called invalidate_nil and it needs to know what the nil value is.String
build_text(NamespaceManager nsm)
Called by a TypeStore to pull out the most reasonable text value from us.byte[]
byteArrayValue()
Deprecated.replaced withgetByteArrayValue()
byte
byteValue()
Deprecated.replaced withgetByteValue()
Calendar
calendarValue()
Deprecated.replaced withgetCalendarValue()
XmlObject
changeType(SchemaType type)
Changes the schema type associated with this data and returns a new XmlObject instance whose schemaType is the new type.void
check_dated()
Called prior to every get operation, to ensure that the value being read is valid.int
compareTo(Object obj)
Implements Comparable.int
compareValue(XmlObject xmlobj)
This comparison method is similar to compareTo, but rather than throwing a ClassCastException when two values are incomparable, it returns the number 2.XmlObject
copy()
Returns a deep copy of this XmlObject.XmlObject
copy(XmlOptions options)
Returns a deep copy of this XmlObject.TypeStoreUser
create_attribute_user(QName attrName)
A typestore user can create a new TypeStoreUser instance for a given attribute child, based on the attribute name.TypeStoreUser
create_element_user(QName eltName, QName xsiType)
A typestore user can create a new TypeStoreUser instance for a given element child name as long as you also pass the qname contained by the xsi:type attribute, if any.Date
dateValue()
Deprecated.replaced withgetDateValue()
void
disconnect_store()
A store calls back here in order to force a disconnect.XmlDocumentProperties
documentProperties()
Returns the XmlDocumentProperties object for the document this token source is associated with.double
doubleValue()
Deprecated.replaced withgetDoubleValue()
void
dump()
Prints to stdout the state of the document in which this token source is positioned.StringEnumAbstractBase
enumValue()
Deprecated.replaced withgetEnumValue()
boolean
equals(Object obj)
XmlObject[]
execQuery(String path)
Executes a query.XmlObject[]
execQuery(String queryExpr, XmlOptions options)
Executes a query with options.float
floatValue()
Deprecated.replaced withgetFloatValue()
GDate
gDateValue()
Deprecated.replaced withgetGDateValue()
GDuration
gDurationValue()
Deprecated.replaced withgetGDurationValue()
XmlObject
generatedSetterHelperImpl(XmlObject src, QName propName, int index, short kindSetterHelper)
SchemaField
get_attribute_field(QName attrName)
Returns the schema field for an attributeSchemaType
get_attribute_type(QName attrName)
Return the SchemaType which an attribute of this name would be.int
get_attributeflags(QName attrName)
Returns the flags for the given attribute.String
get_default_attribute_text(QName attrName)
Returns the default attribute text for the attribute with the given name, or null if no default.String
get_default_element_text(QName eltName)
Returns the default element text, if it's consistent.QNameSet
get_element_ending_delimiters(QName eltname)
Inserting a new element is always unambiguous except in one situation: when adding an element after the last one with that name (or the first one if there are none).SchemaType
get_element_type(QName eltName, QName xsiType)
Return the SchemaType which a child element of this name and xsi:type would be.int
get_elementflags(QName eltName)
Returns the elementflags, if they're consistent.SchemaType
get_schema_type()
Returns the schema type of this userTypeStore
get_store()
Used by the ComplexTypeImpl subclass to get direct access to the store.String
get_wscanon_text()
Grabs the undelying litral representation, applying the implementation's wscanon rule.BigDecimal
getBigDecimalValue()
Returns the value as aBigDecimal
.BigInteger
getBigIntegerValue()
Returns the value as aBigInteger
.boolean
getBooleanValue()
Returns the value as a boolean.byte[]
getByteArrayValue()
Returns the value as a byte array.byte
getByteValue()
Returns the value as a byte.Calendar
getCalendarValue()
Returns the value as aCalendar
.Date
getDateValue()
Returns the value as aDate
.Node
getDomNode()
Returns a W3C DOM Node containing the XML represented by this source.double
getDoubleValue()
Returns the value as a double.StringEnumAbstractBase
getEnumValue()
Returns the value as aStringEnumAbstractBase
.float
getFloatValue()
Returns the value as a float.GDate
getGDateValue()
Returns the value as aGDate
.GDuration
getGDurationValue()
Returns the value as aGDuration
.int
getIntValue()
Returns the value as an int.List
getListValue()
Returns the value as aList
of friendly Java objects (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration).long
getLongValue()
Returns the value as a long.Object
getObjectValue()
Returns a union value as a its natural friendly Java object (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration).QName
getQNameValue()
Returns the value as aQName
.short
getShortValue()
Returns the value as a short.String
getStringValue()
Returns the value as aString
.XmlLocale
getXmlLocale()
int
hashCode()
void
init_flags(SchemaProperty prop)
SchemaType
instanceType()
The same as getSchemaType unless this is a union instance or nil value.int
intValue()
Deprecated.replaced withgetIntValue()
void
invalidate_element_order()
Called by a TypeStore to indicate that the element's default value, nillability, fixedness, etc, may have changed by virtue of the element order changing (and xsi:nil and the text may have changed too); so the store should be consulted next time any setter or getter is called.void
invalidate_nilvalue()
Called by a TypeStore to indicate that the xsi:nil attribute on the containing element (and possibly the text) has been invalidated and both should be consulted next time the value is needed.void
invalidate_value()
Called by a TypeStore to indicate that the text has been invalidated and should be fetched next time the value is needed.boolean
is_child_element_order_sensitive()
Returns false if child elements are insensitive to order; if it returns true, you're required to call invalidate_element_order on children to the right of any child order rearrangement.boolean
isDefault()
True if the value is currently defaulted.boolean
isDefaultable()
True if the value is currently defaulted.boolean
isFixed()
True if the value is fixed.boolean
isImmutable()
Is this instance an immutable value?boolean
isInstanceOf(SchemaType type)
boolean
isNil()
True if the value is nilled.boolean
isNillable()
True if the value is allowed to be nil.List
listValue()
Deprecated.replaced withgetListValue()
long
longValue()
Deprecated.replaced withgetLongValue()
Object
monitor()
Returns the synchronization object for the document.TypeStoreVisitor
new_visitor()
A typestore user can return a visitor that is used to compute default text and elementflags for an arbitrary element.XmlCursor
newCursor()
Returns a new XML cursor.XmlCursor
newCursorForce()
Node
newDomNode()
Returns a W3C DOM Node containing the XML represented by this source.Node
newDomNode(XmlOptions options)
Just like newDomNode() but with options.InputStream
newInputStream()
Returns a new stream containing standard XML text, encoded according to the given encoding.InputStream
newInputStream(XmlOptions options)
Just like newInputStream(String encoding) but with options.Reader
newReader()
Returns a new character reader containing XML text.Reader
newReader(XmlOptions options)
Just like newReader() but with options.XMLInputStream
newXMLInputStream()
Deprecated.XMLInputStream was deprecated by XMLStreamReader from STaX - jsr173 API.XMLInputStream
newXMLInputStream(XmlOptions options)
Deprecated.XMLInputStream was deprecated by XMLStreamReader from STaX - jsr173 API.XMLStreamReader
newXMLStreamReader()
Returns a new XMLStreamReader.XMLStreamReader
newXMLStreamReader(XmlOptions options)
Just like newXMLInputStream() but with options.void
objectSet(Object obj)
Deprecated.replaced withsetObjectValue(java.lang.Object)
Object
objectValue()
Deprecated.replaced withgetObjectValue()
QName
qNameValue()
Deprecated.replaced withgetQNameValue()
void
save(File file)
Writes the XML represented by this source to the given File.void
save(File file, XmlOptions options)
Writes the XML represented by this source to the given File.void
save(OutputStream os)
Writes the XML represented by this source to the given output stream.void
save(OutputStream os, XmlOptions options)
Writes the XML represented by this source to the given output stream.void
save(Writer w)
Writes the XML represented by this source to the given output.void
save(Writer w, XmlOptions options)
Writes the XML represented by this source to the given output.void
save(ContentHandler ch, LexicalHandler lh)
Writes the XML represented by this source to the given SAX content and lexical handlers.void
save(ContentHandler ch, LexicalHandler lh, XmlOptions options)
Writes the XML represented by this source to the given SAX content and lexical handlers.abstract SchemaType
schemaType()
XmlObject
selectAttribute(String attributeUri, String attributeLocalName)
Selects the content of the attribute with the given name.XmlObject
selectAttribute(QName attributeName)
Selects the content of the attribute with the given name.XmlObject[]
selectAttributes(QNameSet attributeNameSet)
Selects the contents of the attributes that are contained in the elementNameSet.XmlObject[]
selectChildren(String elementUri, String elementLocalName)
Selects the contents of the children elements with the given name.XmlObject[]
selectChildren(QName elementName)
Selects the contents of the children elements with the given name.XmlObject[]
selectChildren(QNameSet elementNameSet)
Selects the contents of the children elements that are contained in the elementNameSet.XmlObject[]
selectPath(String path)
Selects a path.XmlObject[]
selectPath(String path, XmlOptions options)
Selects a path, applying options.void
set(boolean v)
Deprecated.replaced withsetBooleanValue(boolean)
void
set(byte v)
Deprecated.replaced withsetByteValue(byte)
void
set(byte[] obj)
Deprecated.replaced withsetByteArrayValue(byte[])
void
set(double v)
Deprecated.replaced withsetDoubleValue(double)
void
set(float v)
Deprecated.replaced withsetFloatValue(float)
void
set(int v)
Deprecated.replaced withsetIntValue(int)
void
set(long v)
Deprecated.replaced withsetLongValue(long)
void
set(short v)
Deprecated.replaced withsetShortValue(short)
void
set(String obj)
Deprecated.replaced withsetStringValue(java.lang.String)
void
set(BigDecimal obj)
Deprecated.replaced withsetBigDecimalValue(java.math.BigDecimal)
void
set(BigInteger obj)
Deprecated.replaced withsetBigIntegerValue(java.math.BigInteger)
void
set(Calendar obj)
Deprecated.replaced withsetCalendarValue(java.util.Calendar)
void
set(Date obj)
Deprecated.replaced withsetDateValue(java.util.Date)
void
set(List obj)
Deprecated.replaced withsetListValue(java.util.List)
void
set(QName obj)
Deprecated.replaced withsetQNameValue(javax.xml.namespace.QName)
void
set(GDateSpecification obj)
Deprecated.replaced withsetGDateValue(org.apache.xmlbeans.GDate)
void
set(GDurationSpecification obj)
Deprecated.replaced withsetGDurationValue(org.apache.xmlbeans.GDuration)
void
set(StringEnumAbstractBase obj)
Deprecated.replaced withsetEnumValue(org.apache.xmlbeans.StringEnumAbstractBase)
XmlObject
set(XmlObject src)
Set the value/type of this XmlObject to be a copy of the source XmlObject.void
set_newValue(XmlObject obj)
void
setBigDecimalValue(BigDecimal obj)
Sets the value as aBigDecimal
.void
setBigIntegerValue(BigInteger obj)
Sets the value as aBigInteger
.void
setBooleanValue(boolean v)
Sets the value as a boolean.void
setByteArrayValue(byte[] obj)
Sets the value as a byte array.void
setByteValue(byte v)
Sets the value as a byte.void
setCalendarValue(Calendar obj)
Sets the value as aCalendar
.void
setDateValue(Date obj)
Sets the value as aDate
.void
setDoubleValue(double v)
Sets the value as a double.void
setEnumValue(StringEnumAbstractBase obj)
Sets the value as aStringEnumAbstractBase
.void
setFloatValue(float v)
Sets the value as a float.void
setGDateValue(GDate obj)
Sets the value as aGDate
.void
setGDateValue(GDateSpecification obj)
void
setGDurationValue(GDuration obj)
Sets the value as aGDuration
.void
setGDurationValue(GDurationSpecification obj)
void
setImmutable()
Used to make a free-standing xml simple value instance immutable.void
setIntValue(int v)
Sets the value as an int.void
setListValue(List obj)
Sets the value as aList
.void
setLongValue(long v)
Sets the value as a long.void
setNil()
Nils the value.void
setObjectValue(Object o)
Sets the value as an arbitraryObject
.void
setQNameValue(QName obj)
Sets the value as aQName
.void
setShortValue(short v)
Sets the value as a short.void
setStringValue(String obj)
Sets the value as aString
.void
setValidateOnSet()
short
shortValue()
Deprecated.replaced withgetShortValue()
String
stringValue()
Deprecated.replaced withgetStringValue()
XmlObject
substitute(QName name, SchemaType type)
Changes the schema type associated with this data using substitution groups and returns an XmlObject instance whose schemaType is the new type and container name is the new name.String
toString()
The string is pretty-printed.boolean
uses_invalidate_value()
A store can call uses_invalidate_value to know if calls to invalidate_value will be fruitful.boolean
validate()
Does a deep validation of the entire subtree under the object, but does not validate the parents or siblings of the object if the object is in the interior of an xml tree.boolean
validate(XmlOptions options)
Just like validate(), but with options.void
validate_now()
A store will call back on validate_now to force us to look at the text if we're in an invalid state.boolean
valueEquals(XmlObject xmlobj)
True if the xml values are equal.int
valueHashCode()
Object
writeReplace()
This method can writeReplace either an unwrapped XmlObjectBase or an XBean proxy.List
xgetListValue()
Returns the value as aList
of XmlAnySimpleType objects.List
xlistValue()
Deprecated.replaced withxgetListValue()
String
xmlText()
Returns standard XML text.String
xmlText(XmlOptions options)
Just like xmlText() but with options.
-
-
-
Field Detail
-
MAJOR_VERSION_NUMBER
public static final short MAJOR_VERSION_NUMBER
- See Also:
- Constant Field Values
-
MINOR_VERSION_NUMBER
public static final short MINOR_VERSION_NUMBER
- See Also:
- Constant Field Values
-
KIND_SETTERHELPER_SINGLETON
public static final short KIND_SETTERHELPER_SINGLETON
- See Also:
- Constant Field Values
-
KIND_SETTERHELPER_ARRAYITEM
public static final short KIND_SETTERHELPER_ARRAYITEM
- See Also:
- Constant Field Values
-
_voorVc
public static final ValidationContext _voorVc
-
-
Method Detail
-
monitor
public final Object monitor()
Description copied from interface:XmlTokenSource
Returns the synchronization object for the document. If concurrent multithreaded access to a document is required, the access should should be protected by synchronizing on this monitor() object. There is one monitor per XML document tree.- Specified by:
monitor
in interfaceXmlTokenSource
-
copy
public final XmlObject copy()
Description copied from interface:XmlObject
Returns a deep copy of this XmlObject. The returned object has the same type as the current object, and has all the content of the XML document underneath the current object. Note that any parts of the XML document above or outside this XmlObject are not copied. Note: The result object will be in the same synchronization domain as the source, and additional synchronization is required for concurent access. To use a different synchronization domain use setCopyUseNewSynchronizationDomain option with copy(XmlOptions) method.- Specified by:
copy
in interfaceXmlObject
- See Also:
XmlObject.copy(XmlOptions)
,XmlOptions.setCopyUseNewSynchronizationDomain(boolean)
-
copy
public final XmlObject copy(XmlOptions options)
Description copied from interface:XmlObject
Returns a deep copy of this XmlObject. The returned object has the same type as the current object, and has all the content of the XML document underneath the current object. Note that any parts of the XML document above or outside this XmlObject are not copied. Note: The result object will be in the same synchronization domain as the source, and additional synchronization is required for concurent access. To use a different synchronization domain use setCopyUseNewSynchronizationDomain option when creating the original XmlObject.- Specified by:
copy
in interfaceXmlObject
- See Also:
XmlOptions.setCopyUseNewSynchronizationDomain(boolean)
-
_copy
public final XmlObject _copy()
Same as copy() but unsynchronized. Warning: Using this method in mutithreaded environment can cause invalid states.
-
_copy
public final XmlObject _copy(XmlOptions xmlOptions)
Same as copy() but unsynchronized. If Locale.COPY_USE_NEW_LOCALE is set in the options, a new locale will be created for the copy. Warning: Using this method in mutithreaded environment can cause invalid states.
-
documentProperties
public XmlDocumentProperties documentProperties()
Description copied from interface:XmlTokenSource
Returns the XmlDocumentProperties object for the document this token source is associated with.- Specified by:
documentProperties
in interfaceXmlTokenSource
-
newXMLInputStream
public XMLInputStream newXMLInputStream()
Deprecated.XMLInputStream was deprecated by XMLStreamReader from STaX - jsr173 API.Description copied from interface:XmlTokenSource
Returns a new XmlInputStream. The stream starts at the current begin-tag or begin-document position and ends at the matching end-tag or end-document. This is a fail-fast stream, so if the underlying data is changed while the stream is being read, the stream throws a ConcurrentModificationException. Throws an IllegalStateException if the XmlTokenSource is not positioned at begin-tag or begin-document (e.g., if it is at an attribute).- Specified by:
newXMLInputStream
in interfaceXmlTokenSource
-
newXMLInputStream
public XMLInputStream newXMLInputStream(XmlOptions options)
Deprecated.XMLInputStream was deprecated by XMLStreamReader from STaX - jsr173 API.Description copied from interface:XmlTokenSource
Just like newXMLInputStream() but with any of a number of options. Use the options parameter to specify the following:
To specify this Use this method The character encoding to use when converting the character data in the XML to bytess. XmlOptions.setCharacterEncoding(java.lang.String)
Prefix-to-namespace mappings that should be assumed when saving this XML. This is useful when the resulting XML will be part of a larger XML document, ensuring that this inner document will take advantage of namespaces defined in the outer document. XmlOptions.setSaveImplicitNamespaces(java.util.Map)
Suggested namespace prefixes to use when saving. Used only when a namespace attribute needs to be synthesized. XmlOptions.setSaveSuggestedPrefixes(java.util.Map)
That namespace attributes should occur first in elements when the XML is saved. By default, they occur last. XmlOptions.setSaveNamespacesFirst()
The XML should be pretty printed when saved. Note that this should only be used for debugging. XmlOptions.setSavePrettyPrint()
The number of spaces to use when indenting for pretty printing. The default is 2. XmlOptions.setSavePrettyPrintIndent(int)
The additional number of spaces indented from the left for pretty printed XML. XmlOptions.setSavePrettyPrintOffset(int)
To minimize the number of namespace attributes generated for the saved XML. Note that this can reduce performance significantly. XmlOptions.setSaveAggresiveNamespaces()
To reduce the size of the saved document by allowing the use of the default namespace. Note that this can potentially change the semantic meaning of the XML if unprefixed QNames are present as the value of an attribute or element. XmlOptions.setUseDefaultNamespace()
To filter out processing instructions with the specified target name. XmlOptions.setSaveFilterProcinst(java.lang.String)
Change the QName of the synthesized root element when saving. This replaces "xml-fragment" with "fragment" in the namespace http://www.openuri.org/fragment XmlOptions.setSaveUseOpenFrag()
Saving should begin on the element's contents. XmlOptions.setSaveInner()
Saving should begin on the element, rather than its contents. XmlOptions.setSaveOuter()
To rename the document element, or to specify the document element for this XML. XmlOptions.setSaveSyntheticDocumentElement(javax.xml.namespace.QName)
- Specified by:
newXMLInputStream
in interfaceXmlTokenSource
- Parameters:
options
- Any of the described options.- Returns:
- A new validating XMLInputStream.
- See Also:
XmlOptions
-
newXMLStreamReader
public XMLStreamReader newXMLStreamReader()
Description copied from interface:XmlTokenSource
Returns a new XMLStreamReader. The stream starts at the current begin-tag or begin-document position and ends at the matching end-tag or end-document. This is a fail-fast stream, so if the underlying data is changed while the stream is being read, the stream throws a ConcurrentModificationException.- Specified by:
newXMLStreamReader
in interfaceXmlTokenSource
-
newXMLStreamReader
public XMLStreamReader newXMLStreamReader(XmlOptions options)
Description copied from interface:XmlTokenSource
Just like newXMLInputStream() but with options. Options map may be null.- Specified by:
newXMLStreamReader
in interfaceXmlTokenSource
- See Also:
XmlOptions
-
newInputStream
public InputStream newInputStream()
Description copied from interface:XmlTokenSource
Returns a new stream containing standard XML text, encoded according to the given encoding. The byte stream contains contents starting at the current begin-tag or begin-document and ending at the matching end-tag or end-document. The specified encoding is used and also emitted in a PI at the beginning of the stream. This is a fail-fast stream, so if the underlying data is changed while the stream is being read, the stream throws a ConcurrentModificationException. Throws an IllegalStateException if the XmlTokenSource is not positioned at begin-tag or begin-document (e.g., if it is at an attribute).- Specified by:
newInputStream
in interfaceXmlTokenSource
-
newInputStream
public InputStream newInputStream(XmlOptions options)
Description copied from interface:XmlTokenSource
Just like newInputStream(String encoding) but with options. Options map may be null.- Specified by:
newInputStream
in interfaceXmlTokenSource
- See Also:
XmlOptions
-
newReader
public Reader newReader()
Description copied from interface:XmlTokenSource
Returns a new character reader containing XML text. The contents of the reader represents the document contents starting at the current begin-tag or begin-document and ending at the matching end-tag or end-document. No encoding annotation will be made in the text itself. This is a fail-fast reader, so if the underlying data is changed while the reader is being read, the reader throws a ConcurrentModificationException. Throws an IllegalStateException if the XmlTokenSource is not positioned at begin-tag or begin-document (e.g., if it is at an attribute).- Specified by:
newReader
in interfaceXmlTokenSource
-
newReader
public Reader newReader(XmlOptions options)
Description copied from interface:XmlTokenSource
Just like newReader() but with options. Options map may be null.- Specified by:
newReader
in interfaceXmlTokenSource
- See Also:
XmlOptions
-
getDomNode
public Node getDomNode()
Description copied from interface:XmlTokenSource
Returns a W3C DOM Node containing the XML represented by this source. This is a live DOM node, not a copy. Any changes made through this node are immediately reflected in the document associated with this token source. Depending on the kind of token this XmlTokenSource represents, an appropriate node will be returned.- Specified by:
getDomNode
in interfaceXmlTokenSource
-
newDomNode
public Node newDomNode()
Description copied from interface:XmlTokenSource
Returns a W3C DOM Node containing the XML represented by this source. This is a copy of the XML, it is not a live with the underlying store of this token source. If this is the document node, then a Document is returned, else a DocumentFragment is returned.- Specified by:
newDomNode
in interfaceXmlTokenSource
-
newDomNode
public Node newDomNode(XmlOptions options)
Description copied from interface:XmlTokenSource
Just like newDomNode() but with options. Options map may be null.- Specified by:
newDomNode
in interfaceXmlTokenSource
- See Also:
XmlOptions
-
save
public void save(ContentHandler ch, LexicalHandler lh, XmlOptions options) throws SAXException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given SAX content and lexical handlers. Note that this method does not save the XML declaration, including the encoding information. To save the XML declaration with the XML, seeXmlTokenSource.save(OutputStream)
,XmlTokenSource.save(OutputStream, XmlOptions)
,XmlTokenSource.save(File)
orXmlTokenSource.save(File, XmlOptions)
.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
SAXException
-
save
public void save(File file, XmlOptions options) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given File. This method will save the XML declaration, including encoding information, with the XML.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
save
public void save(OutputStream os, XmlOptions options) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given output stream. This method will save the XML declaration, including encoding information, with the XML.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
save
public void save(Writer w, XmlOptions options) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given output. Note that this method does not save the XML declaration, including the encoding information. To save the XML declaration with the XML, seeXmlTokenSource.save(OutputStream)
,XmlTokenSource.save(OutputStream, XmlOptions)
,XmlTokenSource.save(File)
orXmlTokenSource.save(File, XmlOptions)
.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
save
public void save(ContentHandler ch, LexicalHandler lh) throws SAXException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given SAX content and lexical handlers. Note that this method does not save the XML declaration, including the encoding information. To save the XML declaration with the XML, seeXmlTokenSource.save(OutputStream)
,XmlTokenSource.save(OutputStream, XmlOptions)
,XmlTokenSource.save(File)
orXmlTokenSource.save(File, XmlOptions)
.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
SAXException
-
save
public void save(File file) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given File. This method will save the XML declaration, including encoding information, with the XML.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
save
public void save(OutputStream os) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given output stream. This method will save the XML declaration, including encoding information, with the XML.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
save
public void save(Writer w) throws IOException
Description copied from interface:XmlTokenSource
Writes the XML represented by this source to the given output. Note that this method does not save the XML declaration, including the encoding information. To save the XML declaration with the XML, seeXmlTokenSource.save(OutputStream)
,XmlTokenSource.save(OutputStream, XmlOptions)
,XmlTokenSource.save(File)
orXmlTokenSource.save(File, XmlOptions)
.- Specified by:
save
in interfaceXmlTokenSource
- Throws:
IOException
-
dump
public void dump()
Description copied from interface:XmlTokenSource
Prints to stdout the state of the document in which this token source is positioned. This is very implementation specific and may change at any time. Dump can be useful for debugging purposes. It is very different from the save methods which produce XML text which only approximates the actual state of the document.- Specified by:
dump
in interfaceXmlTokenSource
-
newCursorForce
public XmlCursor newCursorForce()
-
newCursor
public XmlCursor newCursor()
Description copied from interface:XmlTokenSource
Returns a new XML cursor. A cursor provides random access to all the tokens in the XML data, plus the ability to extract strongly-typed XmlObjects for the data. If the data is not read-only, the XML cursor also allows modifications to the data. Using a cursor for the first time typically forces the XML document into memory.- Specified by:
newCursor
in interfaceXmlTokenSource
-
schemaType
public abstract SchemaType schemaType()
- Specified by:
schemaType
in interfaceXmlObject
- Returns:
- The schema type for this instance. This is a permanent, unchanging property of the instance.
-
instanceType
public SchemaType instanceType()
Description copied from interface:SimpleValue
The same as getSchemaType unless this is a union instance or nil value.For unions, this returns the non-union consituent type of this instance. This type may change if setters are called that cause the instance to change to another constituent type of the union.
For nil values, this returns null.
- Specified by:
instanceType
in interfaceSimpleValue
-
validate
public boolean validate()
Description copied from interface:XmlObject
Does a deep validation of the entire subtree under the object, but does not validate the parents or siblings of the object if the object is in the interior of an xml tree.
-
validate
public boolean validate(XmlOptions options)
Description copied from interface:XmlObject
Just like validate(), but with options.
If you wish to collect error messages and locations while validating, use the
XmlOptions.setErrorListener(java.util.Collection)
method. With that method, you can specify an object in which to store messages related to validation. The following is a simple example.// Create an XmlOptions instance and set the error listener. XmlOptions validateOptions = new XmlOptions(); ArrayList errorList = new ArrayList(); validateOptions.setErrorListener(errorList); // Validate the XML. boolean isValid = newEmp.validate(validateOptions); // If the XML isn't valid, loop through the listener's contents, // printing contained messages. if (!isValid) { for (int i = 0; i < errorList.size(); i++) { XmlError error = (XmlError)errorList.get(i); System.out.println("\n"); System.out.println("Message: " + error.getMessage() + "\n"); System.out.println("Location of invalid XML: " + error.getCursorLocation().xmlText() + "\n"); } }
- Specified by:
validate
in interfaceXmlObject
- Parameters:
options
- An object that implements theCollection
interface.- Returns:
- true if the contents of this object are valid accoring to schemaType().
-
selectPath
public XmlObject[] selectPath(String path)
Description copied from interface:XmlObject
Selects a path. Path can be a string or precompiled path String.The path must be a relative path, where "." represents the element or attribute containg this XmlObject, and it must select only other elements or attributes. If a non-element or non-attribute is selected, an unchecked exception is thrown.
The array that is returned contains all the selected XmlObjects, within the same document, listed in document order. The actual array type of the result is inferred from the closest common base type of selected results.
Here is an example of usage. Suppose we have a global element definition for "owner" whose type is "person":
<schema targetNamespace="http://openuri.org/sample"> <element name="owner" type="person"/> <complexType name="person"> [...] </complexType> </schema>
and suppose "owner" tags can be scattered throughout the document. Then we can write the following code to find them all:import org.openuri.sample.Person; import org.apache.xmlbeans.*; [...] XmlObject xobj = XmlObject.Factory.parse(myFile); Person[] results; results = (Person[])xobj.selectPath( "declare namespace s='http://www.openuri.org/sample' " + ".//s:owner");
Notice the way in which namespace declarations are done in XPath 2.0. Since XPath can only navigate within an XML document - it cannot construct new XML - the resulting XmlObjects all reside in the same XML document as this XmlObject itself.- Specified by:
selectPath
in interfaceXmlObject
- Parameters:
path
- the xpath- Returns:
- an array of all selected XmlObjects
-
selectPath
public XmlObject[] selectPath(String path, XmlOptions options)
Description copied from interface:XmlObject
Selects a path, applying options.- Specified by:
selectPath
in interfaceXmlObject
- Parameters:
path
- the xpathoptions
- the options used to execute the xpath- Returns:
- an array of all selected XmlObjects
- See Also:
XmlObject.selectPath(String)
-
execQuery
public XmlObject[] execQuery(String path)
Description copied from interface:XmlObject
Executes a query. Query can be a string or precompiled query String.An XQuery is very similar to an XPath, except that it also permits construction of new XML. As a result, the XmlObjects that are returned from execQuery are in newly created documents, separate from the XmlObject on which the query is executed.
Syntax and usage is otherwise similar to selectPath.
- Specified by:
execQuery
in interfaceXmlObject
- Parameters:
path
- The XQuery expression- Returns:
- an array of all selected XmlObjects
- See Also:
XmlObject.selectPath(String)
-
execQuery
public XmlObject[] execQuery(String queryExpr, XmlOptions options)
Description copied from interface:XmlObject
Executes a query with options. Use the options parameter to specify the following:To specify this Use this method The document type for the root element. XmlOptions.setDocumentType(org.apache.xmlbeans.SchemaType)
To replace the document element with the specified QName when constructing the resulting document. XmlOptions.setLoadReplaceDocumentElement(javax.xml.namespace.QName)
To strip all insignificant whitespace when constructing a document. XmlOptions.setLoadStripWhitespace()
To strip all comments when constructing a document. XmlOptions.setLoadStripComments()
To strip all processing instructions when constructing a document. XmlOptions.setLoadStripProcinsts()
A map of namespace URI substitutions to use when constructing a document. XmlOptions.setLoadSubstituteNamespaces(java.util.Map)
Additional namespace mappings to be added when constructing a document. XmlOptions.setLoadAdditionalNamespaces(java.util.Map)
To trim the underlying XML text buffer immediately after constructing a document, resulting in a smaller memory footprint. XmlOptions.setLoadTrimTextBuffer()
Whether value facets should be checked as they are set. XmlOptions.setValidateOnSet()
- Specified by:
execQuery
in interfaceXmlObject
- Parameters:
queryExpr
- The XQuery expression.options
- Options as described.- Returns:
- an array of all selected XmlObjects
- See Also:
XmlObject.execQuery(String)
-
changeType
public XmlObject changeType(SchemaType type)
Description copied from interface:XmlObject
Changes the schema type associated with this data and returns a new XmlObject instance whose schemaType is the new type.Returns the new XmlObject if the type change was successful, the old XmlObject if no changes could be made.
Certain type changes may be prohibited in the interior of an xml tree due to schema type system constraints (that is, due to a parent container within which the newly specified type is not permissible), but there are no constraints at the roottype changes are never prohibited at the root of an xml tree.If the type change is allowed, then the new XmlObject should be used rather than the old one. The old XmlObject instance and any other XmlObject instances in the subtree are permanently invalidated and should not be used. (They will return XmlValueDisconnectedException if you try to use them.) If a type change is done on the interior of an Xml tree, then xsi:type attributes are updated as needed.
- Specified by:
changeType
in interfaceXmlObject
- Returns:
- a new XmlObject instance whose schemaType is the new type
-
substitute
public XmlObject substitute(QName name, SchemaType type)
Description copied from interface:XmlObject
Changes the schema type associated with this data using substitution groups and returns an XmlObject instance whose schemaType is the new type and container name is the new name.Returns the new XmlObject if the substitution was successful, the old XmlObject if no changes could be made.
In order for the operation to succeed, several conditions must hold:- the container of this type must be an element
- a global element with the name
newName
must exist and must be in the substition group of the containing element - the
newType
type must be consistent with the declared type of the new element
If the type change is allowed, then the new XmlObject should be used rather than the old one. The old XmlObject instance and any other XmlObject instances in the subtree are permanently invalidated and should not be used. (They will return XmlValueDisconnectedException if you try to use them.) If necessary, xsi:type attributes are updated.
- Specified by:
substitute
in interfaceXmlObject
- Parameters:
name
- the new nametype
- the new type- Returns:
- an XmlObject instance whose schemaType is the new type and container name is the new name
-
init_flags
public void init_flags(SchemaProperty prop)
-
setValidateOnSet
public void setValidateOnSet()
-
isNil
public final boolean isNil()
True if the value is nilled.
-
isFixed
public final boolean isFixed()
True if the value is fixed.
-
isNillable
public final boolean isNillable()
True if the value is allowed to be nil.
-
isDefaultable
public final boolean isDefaultable()
True if the value is currently defaulted.
-
isDefault
public final boolean isDefault()
True if the value is currently defaulted.
-
setImmutable
public void setImmutable()
Used to make a free-standing xml simple value instance immutable. This is a one-way street, and it is illegal to attempt to make a value that is embedded in an xml document immutable. Once a value is marked as immutable, it is illegal to call setters of any kind.
-
isImmutable
public boolean isImmutable()
Is this instance an immutable value?- Specified by:
isImmutable
in interfaceXmlObject
- Returns:
- true if the value is an immutable value.
-
attach_store
public final void attach_store(TypeStore store)
Called to initialize the TypeStore associated with this XmlObject implementation. If not called, this is a free-floating value holder. When a value is first attached, it is put in a completely invalidated state.- Specified by:
attach_store
in interfaceTypeStoreUser
-
invalidate_value
public final void invalidate_value()
Called by a TypeStore to indicate that the text has been invalidated and should be fetched next time the value is needed.- Specified by:
invalidate_value
in interfaceTypeStoreUser
-
uses_invalidate_value
public final boolean uses_invalidate_value()
Description copied from interface:TypeStoreUser
A store can call uses_invalidate_value to know if calls to invalidate_value will be fruitful. If uses_invalidate_value returns false, invalidate_value need never be called.- Specified by:
uses_invalidate_value
in interfaceTypeStoreUser
-
invalidate_nilvalue
public final void invalidate_nilvalue()
Called by a TypeStore to indicate that the xsi:nil attribute on the containing element (and possibly the text) has been invalidated and both should be consulted next time the value is needed.- Specified by:
invalidate_nilvalue
in interfaceTypeStoreUser
-
invalidate_element_order
public final void invalidate_element_order()
Called by a TypeStore to indicate that the element's default value, nillability, fixedness, etc, may have changed by virtue of the element order changing (and xsi:nil and the text may have changed too); so the store should be consulted next time any setter or getter is called.- Specified by:
invalidate_element_order
in interfaceTypeStoreUser
-
get_store
public final TypeStore get_store()
Used by the ComplexTypeImpl subclass to get direct access to the store.- Specified by:
get_store
in interfaceTypeStoreUser
-
getXmlLocale
public final XmlLocale getXmlLocale()
-
build_text
public final String build_text(NamespaceManager nsm)
Called by a TypeStore to pull out the most reasonable text value from us. This is done after we have invalidated the store (typically when our value has been set).- Specified by:
build_text
in interfaceTypeStoreUser
-
build_nil
public boolean build_nil()
A store will call back on build_nil after we've called invalidate_nil and it needs to know what the nil value is.- Specified by:
build_nil
in interfaceTypeStoreUser
-
validate_now
public void validate_now()
A store will call back on validate_now to force us to look at the text if we're in an invalid state. We're allowed to throw an exception if the text isn't valid for our type.- Specified by:
validate_now
in interfaceTypeStoreUser
-
disconnect_store
public void disconnect_store()
A store calls back here in order to force a disconnect. After this is done, the object should be considered invalid. Any attempt to access or set a value should result in an exception. Note that this is how we handle deletions and xsi:type changes.- Specified by:
disconnect_store
in interfaceTypeStoreUser
-
create_element_user
public TypeStoreUser create_element_user(QName eltName, QName xsiType)
A typestore user can create a new TypeStoreUser instance for a given element child name as long as you also pass the qname contained by the xsi:type attribute, if any. Note that we will ignore the xsiType if it turns out to be invalid. Returns null if there is no strongly typed information for that given element (which implies, recusively, no strongly typed information downwards).- Specified by:
create_element_user
in interfaceTypeStoreUser
-
create_attribute_user
public TypeStoreUser create_attribute_user(QName attrName)
A typestore user can create a new TypeStoreUser instance for a given attribute child, based on the attribute name. Returns null if there is no strongly typed information for that given attributes.- Specified by:
create_attribute_user
in interfaceTypeStoreUser
-
get_schema_type
public SchemaType get_schema_type()
Description copied from interface:TypeStoreUser
Returns the schema type of this user- Specified by:
get_schema_type
in interfaceTypeStoreUser
-
get_element_type
public SchemaType get_element_type(QName eltName, QName xsiType)
Description copied from interface:TypeStoreUser
Return the SchemaType which a child element of this name and xsi:type would be.- Specified by:
get_element_type
in interfaceTypeStoreUser
-
get_attribute_type
public SchemaType get_attribute_type(QName attrName)
Description copied from interface:TypeStoreUser
Return the SchemaType which an attribute of this name would be.- Specified by:
get_attribute_type
in interfaceTypeStoreUser
-
get_default_element_text
public String get_default_element_text(QName eltName)
Returns the default element text, if it's consistent. If it's not consistent, returns null, and requires a visitor walk. Also returns null if there is no default at all (although that can also be discovered via get_elementflags without doing a walk).- Specified by:
get_default_element_text
in interfaceTypeStoreUser
-
get_default_attribute_text
public String get_default_attribute_text(QName attrName)
Returns the default attribute text for the attribute with the given name, or null if no default.- Specified by:
get_default_attribute_text
in interfaceTypeStoreUser
-
get_elementflags
public int get_elementflags(QName eltName)
Returns the elementflags, if they're consistent. If they're not, returns -1, and requires a vistor walk.- Specified by:
get_elementflags
in interfaceTypeStoreUser
-
get_attributeflags
public int get_attributeflags(QName attrName)
Returns the flags for the given attribute.- Specified by:
get_attributeflags
in interfaceTypeStoreUser
-
is_child_element_order_sensitive
public boolean is_child_element_order_sensitive()
Returns false if child elements are insensitive to order; if it returns true, you're required to call invalidate_element_order on children to the right of any child order rearrangement.- Specified by:
is_child_element_order_sensitive
in interfaceTypeStoreUser
-
get_element_ending_delimiters
public final QNameSet get_element_ending_delimiters(QName eltname)
Inserting a new element is always unambiguous except in one situation: when adding an element after the last one with that name (or the first one if there are none). In that case, add the element at the first possible slot BEFORE any element whose qname is contained in the QNameSet given. (If the QNameSet is empty, that means add the new element at the very end.) If the returned QNameSet is null, treat it as if the QNameSet contained all QNames, i.e., add the new element at the very first position possible (adjacent to the last element of the same name, or at the very first slot if it is the first elt with that name).- Specified by:
get_element_ending_delimiters
in interfaceTypeStoreUser
-
new_visitor
public TypeStoreVisitor new_visitor()
A typestore user can return a visitor that is used to compute default text and elementflags for an arbitrary element.- Specified by:
new_visitor
in interfaceTypeStoreUser
-
get_attribute_field
public SchemaField get_attribute_field(QName attrName)
Description copied from interface:TypeStoreUser
Returns the schema field for an attribute- Specified by:
get_attribute_field
in interfaceTypeStoreUser
-
check_dated
public final void check_dated()
Called prior to every get operation, to ensure that the value being read is valid. If the value has been invalidated, it is re-read from the underlying text store, and this may cause an out of range exception. This method deals with nils, nillability, defaults, etc.
-
get_wscanon_text
public final String get_wscanon_text()
Grabs the undelying litral representation, applying the implementation's wscanon rule. Null if not simple content.
-
getFloatValue
public float getFloatValue()
Description copied from interface:SimpleValue
Returns the value as a float.- Specified by:
getFloatValue
in interfaceSimpleValue
-
getDoubleValue
public double getDoubleValue()
Description copied from interface:SimpleValue
Returns the value as a double.- Specified by:
getDoubleValue
in interfaceSimpleValue
-
getBigDecimalValue
public BigDecimal getBigDecimalValue()
Description copied from interface:SimpleValue
Returns the value as aBigDecimal
.- Specified by:
getBigDecimalValue
in interfaceSimpleValue
-
getBigIntegerValue
public BigInteger getBigIntegerValue()
Description copied from interface:SimpleValue
Returns the value as aBigInteger
.- Specified by:
getBigIntegerValue
in interfaceSimpleValue
-
getByteValue
public byte getByteValue()
Description copied from interface:SimpleValue
Returns the value as a byte.- Specified by:
getByteValue
in interfaceSimpleValue
-
getShortValue
public short getShortValue()
Description copied from interface:SimpleValue
Returns the value as a short.- Specified by:
getShortValue
in interfaceSimpleValue
-
getIntValue
public int getIntValue()
Description copied from interface:SimpleValue
Returns the value as an int.- Specified by:
getIntValue
in interfaceSimpleValue
-
getLongValue
public long getLongValue()
Description copied from interface:SimpleValue
Returns the value as a long.- Specified by:
getLongValue
in interfaceSimpleValue
-
toString
public final String toString()
Description copied from interface:XmlObject
The string is pretty-printed. If you want a non-pretty-printed string, or if you want to control options precisely, use the xmlText() methods.Note that when producing XML any object other than very root of the document, then you are guaranteed to be looking at only a fragment of XML, i.e., just the contents of an element or attribute, and and we will produce a string that starts with an
<xml-fragment>
tag. The XmlOptions.setSaveOuter() option on xmlText can be used to produce the actual element name above the object if you wish.
-
xmlText
public String xmlText()
Description copied from interface:XmlTokenSource
Returns standard XML text.The text returned represents the document contents starting at the current begin-tag or begin-document and ending at the matching end-tag or end-document. This is same content as newReader, but it is returned as a single string.
Throws an IllegalStateException if the XmlTokenSource is not positioned at begin-tag or begin-document (e.g., if it is at an attribute).
Note that this method does not produce XML with the XML declaration, including the encoding information. To save the XML declaration with the XML, see
XmlTokenSource.save(OutputStream)
orXmlTokenSource.save(OutputStream, XmlOptions)
.- Specified by:
xmlText
in interfaceXmlTokenSource
-
xmlText
public String xmlText(XmlOptions options)
Description copied from interface:XmlTokenSource
Just like xmlText() but with options. Options map may be null.Note that this method does not produce XML with the XML declaration, including the encoding information. To save the XML declaration with the XML, see
XmlTokenSource.save(OutputStream)
orXmlTokenSource.save(OutputStream, XmlOptions)
.- Specified by:
xmlText
in interfaceXmlTokenSource
- See Also:
XmlOptions
-
getEnumValue
public StringEnumAbstractBase getEnumValue()
Description copied from interface:SimpleValue
Returns the value as aStringEnumAbstractBase
.- Specified by:
getEnumValue
in interfaceSimpleValue
-
getStringValue
public String getStringValue()
Description copied from interface:SimpleValue
Returns the value as aString
.- Specified by:
getStringValue
in interfaceSimpleValue
-
stringValue
public String stringValue()
Deprecated.replaced withgetStringValue()
Description copied from interface:SimpleValue
Returns the value as aString
. *- Specified by:
stringValue
in interfaceSimpleValue
-
booleanValue
public boolean booleanValue()
Deprecated.replaced withgetBooleanValue()
Description copied from interface:SimpleValue
Returns the value as a boolean. *- Specified by:
booleanValue
in interfaceSimpleValue
-
byteValue
public byte byteValue()
Deprecated.replaced withgetByteValue()
Description copied from interface:SimpleValue
Returns the value as a byte. *- Specified by:
byteValue
in interfaceSimpleValue
-
shortValue
public short shortValue()
Deprecated.replaced withgetShortValue()
Description copied from interface:SimpleValue
Returns the value as a short. *- Specified by:
shortValue
in interfaceSimpleValue
-
intValue
public int intValue()
Deprecated.replaced withgetIntValue()
Description copied from interface:SimpleValue
Returns the value as an int. *- Specified by:
intValue
in interfaceSimpleValue
-
longValue
public long longValue()
Deprecated.replaced withgetLongValue()
Description copied from interface:SimpleValue
Returns the value as a long. *- Specified by:
longValue
in interfaceSimpleValue
-
bigIntegerValue
public BigInteger bigIntegerValue()
Deprecated.replaced withgetBigIntegerValue()
Description copied from interface:SimpleValue
Returns the value as aBigInteger
. *- Specified by:
bigIntegerValue
in interfaceSimpleValue
-
bigDecimalValue
public BigDecimal bigDecimalValue()
Deprecated.replaced withgetBigDecimalValue()
Description copied from interface:SimpleValue
Returns the value as aBigDecimal
. *- Specified by:
bigDecimalValue
in interfaceSimpleValue
-
floatValue
public float floatValue()
Deprecated.replaced withgetFloatValue()
Description copied from interface:SimpleValue
Returns the value as a float. *- Specified by:
floatValue
in interfaceSimpleValue
-
doubleValue
public double doubleValue()
Deprecated.replaced withgetDoubleValue()
Description copied from interface:SimpleValue
Returns the value as a double. *- Specified by:
doubleValue
in interfaceSimpleValue
-
byteArrayValue
public byte[] byteArrayValue()
Deprecated.replaced withgetByteArrayValue()
Description copied from interface:SimpleValue
Returns the value as a byte array. *- Specified by:
byteArrayValue
in interfaceSimpleValue
-
enumValue
public StringEnumAbstractBase enumValue()
Deprecated.replaced withgetEnumValue()
Description copied from interface:SimpleValue
Returns the value as aStringEnumAbstractBase
. *- Specified by:
enumValue
in interfaceSimpleValue
-
calendarValue
public Calendar calendarValue()
Deprecated.replaced withgetCalendarValue()
Description copied from interface:SimpleValue
Returns the value as aCalendar
. *- Specified by:
calendarValue
in interfaceSimpleValue
-
dateValue
public Date dateValue()
Deprecated.replaced withgetDateValue()
Description copied from interface:SimpleValue
Returns the value as aDate
. *- Specified by:
dateValue
in interfaceSimpleValue
-
gDateValue
public GDate gDateValue()
Deprecated.replaced withgetGDateValue()
Description copied from interface:SimpleValue
Returns the value as aGDate
. *- Specified by:
gDateValue
in interfaceSimpleValue
-
gDurationValue
public GDuration gDurationValue()
Deprecated.replaced withgetGDurationValue()
Description copied from interface:SimpleValue
Returns the value as aGDuration
. *- Specified by:
gDurationValue
in interfaceSimpleValue
-
qNameValue
public QName qNameValue()
Deprecated.replaced withgetQNameValue()
Description copied from interface:SimpleValue
Returns the value as aQName
. *- Specified by:
qNameValue
in interfaceSimpleValue
-
xlistValue
public List xlistValue()
Deprecated.replaced withxgetListValue()
Description copied from interface:SimpleValue
Returns the value as aList
of XmlAnySimpleType objects. *- Specified by:
xlistValue
in interfaceSimpleValue
-
listValue
public List listValue()
Deprecated.replaced withgetListValue()
Description copied from interface:SimpleValue
Returns the value as aList
of friendly Java objects (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration). *- Specified by:
listValue
in interfaceSimpleValue
-
objectValue
public Object objectValue()
Deprecated.replaced withgetObjectValue()
Description copied from interface:SimpleValue
Returns a union value as a its natural friendly Java object (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration). *- Specified by:
objectValue
in interfaceSimpleValue
-
set
public void set(String obj)
Deprecated.replaced withsetStringValue(java.lang.String)
Description copied from interface:SimpleValue
Sets the value as aString
. *- Specified by:
set
in interfaceSimpleValue
-
set
public void set(boolean v)
Deprecated.replaced withsetBooleanValue(boolean)
Description copied from interface:SimpleValue
Sets the value as a boolean. *- Specified by:
set
in interfaceSimpleValue
-
set
public void set(byte v)
Deprecated.replaced withsetByteValue(byte)
Description copied from interface:SimpleValue
Sets the value as a byte.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(short v)
Deprecated.replaced withsetShortValue(short)
Description copied from interface:SimpleValue
Sets the value as a short.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(int v)
Deprecated.replaced withsetIntValue(int)
Description copied from interface:SimpleValue
Sets the value as an int.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(long v)
Deprecated.replaced withsetLongValue(long)
Description copied from interface:SimpleValue
Sets the value as a long.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(BigInteger obj)
Deprecated.replaced withsetBigIntegerValue(java.math.BigInteger)
Description copied from interface:SimpleValue
Sets the value as aBigInteger
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(BigDecimal obj)
Deprecated.replaced withsetBigDecimalValue(java.math.BigDecimal)
Description copied from interface:SimpleValue
Sets the value as aBigDecimal
- Specified by:
set
in interfaceSimpleValue
-
set
public void set(float v)
Deprecated.replaced withsetFloatValue(float)
Description copied from interface:SimpleValue
Sets the value as a float.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(double v)
Deprecated.replaced withsetDoubleValue(double)
Description copied from interface:SimpleValue
Sets the value as a double.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(byte[] obj)
Deprecated.replaced withsetByteArrayValue(byte[])
Description copied from interface:SimpleValue
Sets the value as a byte array.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(StringEnumAbstractBase obj)
Deprecated.replaced withsetEnumValue(org.apache.xmlbeans.StringEnumAbstractBase)
Description copied from interface:SimpleValue
Sets the value as aStringEnumAbstractBase
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(Calendar obj)
Deprecated.replaced withsetCalendarValue(java.util.Calendar)
Description copied from interface:SimpleValue
Sets the value as aCalendar
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(Date obj)
Deprecated.replaced withsetDateValue(java.util.Date)
Description copied from interface:SimpleValue
Sets the value as aDate
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(GDateSpecification obj)
Deprecated.replaced withsetGDateValue(org.apache.xmlbeans.GDate)
Description copied from interface:SimpleValue
Sets the value as aGDate
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(GDurationSpecification obj)
Deprecated.replaced withsetGDurationValue(org.apache.xmlbeans.GDuration)
Description copied from interface:SimpleValue
Sets the value as aGDuration
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(QName obj)
Deprecated.replaced withsetQNameValue(javax.xml.namespace.QName)
Description copied from interface:SimpleValue
Sets the value as aQName
.- Specified by:
set
in interfaceSimpleValue
-
set
public void set(List obj)
Deprecated.replaced withsetListValue(java.util.List)
Description copied from interface:SimpleValue
Sets the value as aList
.- Specified by:
set
in interfaceSimpleValue
-
objectSet
public void objectSet(Object obj)
Deprecated.replaced withsetObjectValue(java.lang.Object)
Description copied from interface:SimpleValue
Sets the value as an arbitraryObject
.- Specified by:
objectSet
in interfaceSimpleValue
-
getByteArrayValue
public byte[] getByteArrayValue()
Description copied from interface:SimpleValue
Returns the value as a byte array.- Specified by:
getByteArrayValue
in interfaceSimpleValue
-
getBooleanValue
public boolean getBooleanValue()
Description copied from interface:SimpleValue
Returns the value as a boolean.- Specified by:
getBooleanValue
in interfaceSimpleValue
-
getGDateValue
public GDate getGDateValue()
Description copied from interface:SimpleValue
Returns the value as aGDate
.- Specified by:
getGDateValue
in interfaceSimpleValue
-
getDateValue
public Date getDateValue()
Description copied from interface:SimpleValue
Returns the value as aDate
.- Specified by:
getDateValue
in interfaceSimpleValue
-
getCalendarValue
public Calendar getCalendarValue()
Description copied from interface:SimpleValue
Returns the value as aCalendar
.- Specified by:
getCalendarValue
in interfaceSimpleValue
-
getGDurationValue
public GDuration getGDurationValue()
Description copied from interface:SimpleValue
Returns the value as aGDuration
.- Specified by:
getGDurationValue
in interfaceSimpleValue
-
getQNameValue
public QName getQNameValue()
Description copied from interface:SimpleValue
Returns the value as aQName
.- Specified by:
getQNameValue
in interfaceSimpleValue
-
getListValue
public List getListValue()
Description copied from interface:SimpleValue
Returns the value as aList
of friendly Java objects (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration).- Specified by:
getListValue
in interfaceSimpleValue
-
xgetListValue
public List xgetListValue()
Description copied from interface:SimpleValue
Returns the value as aList
of XmlAnySimpleType objects.- Specified by:
xgetListValue
in interfaceSimpleValue
-
getObjectValue
public Object getObjectValue()
Description copied from interface:SimpleValue
Returns a union value as a its natural friendly Java object (String, Integer, Byte, Short, Long, BigInteger, Decimal, Float, Double, byte[], Calendar, GDuration).- Specified by:
getObjectValue
in interfaceSimpleValue
-
setBooleanValue
public final void setBooleanValue(boolean v)
Description copied from interface:SimpleValue
Sets the value as a boolean.- Specified by:
setBooleanValue
in interfaceSimpleValue
-
setByteValue
public final void setByteValue(byte v)
Description copied from interface:SimpleValue
Sets the value as a byte.- Specified by:
setByteValue
in interfaceSimpleValue
-
setShortValue
public final void setShortValue(short v)
Description copied from interface:SimpleValue
Sets the value as a short.- Specified by:
setShortValue
in interfaceSimpleValue
-
setIntValue
public final void setIntValue(int v)
Description copied from interface:SimpleValue
Sets the value as an int.- Specified by:
setIntValue
in interfaceSimpleValue
-
setLongValue
public final void setLongValue(long v)
Description copied from interface:SimpleValue
Sets the value as a long.- Specified by:
setLongValue
in interfaceSimpleValue
-
setFloatValue
public final void setFloatValue(float v)
Description copied from interface:SimpleValue
Sets the value as a float.- Specified by:
setFloatValue
in interfaceSimpleValue
-
setDoubleValue
public final void setDoubleValue(double v)
Description copied from interface:SimpleValue
Sets the value as a double.- Specified by:
setDoubleValue
in interfaceSimpleValue
-
setByteArrayValue
public final void setByteArrayValue(byte[] obj)
Description copied from interface:SimpleValue
Sets the value as a byte array.- Specified by:
setByteArrayValue
in interfaceSimpleValue
-
setEnumValue
public final void setEnumValue(StringEnumAbstractBase obj)
Description copied from interface:SimpleValue
Sets the value as aStringEnumAbstractBase
.- Specified by:
setEnumValue
in interfaceSimpleValue
-
setBigIntegerValue
public final void setBigIntegerValue(BigInteger obj)
Description copied from interface:SimpleValue
Sets the value as aBigInteger
.- Specified by:
setBigIntegerValue
in interfaceSimpleValue
-
setBigDecimalValue
public final void setBigDecimalValue(BigDecimal obj)
Description copied from interface:SimpleValue
Sets the value as aBigDecimal
.- Specified by:
setBigDecimalValue
in interfaceSimpleValue
-
setCalendarValue
public final void setCalendarValue(Calendar obj)
Description copied from interface:SimpleValue
Sets the value as aCalendar
.- Specified by:
setCalendarValue
in interfaceSimpleValue
-
setDateValue
public final void setDateValue(Date obj)
Description copied from interface:SimpleValue
Sets the value as aDate
.- Specified by:
setDateValue
in interfaceSimpleValue
-
setGDateValue
public final void setGDateValue(GDate obj)
Description copied from interface:SimpleValue
Sets the value as aGDate
.- Specified by:
setGDateValue
in interfaceSimpleValue
-
setGDateValue
public final void setGDateValue(GDateSpecification obj)
-
setGDurationValue
public final void setGDurationValue(GDuration obj)
Description copied from interface:SimpleValue
Sets the value as aGDuration
.- Specified by:
setGDurationValue
in interfaceSimpleValue
-
setGDurationValue
public final void setGDurationValue(GDurationSpecification obj)
-
setQNameValue
public final void setQNameValue(QName obj)
Description copied from interface:SimpleValue
Sets the value as aQName
.- Specified by:
setQNameValue
in interfaceSimpleValue
-
setListValue
public final void setListValue(List obj)
Description copied from interface:SimpleValue
Sets the value as aList
.- Specified by:
setListValue
in interfaceSimpleValue
-
setStringValue
public final void setStringValue(String obj)
Description copied from interface:SimpleValue
Sets the value as aString
.- Specified by:
setStringValue
in interfaceSimpleValue
-
setObjectValue
public void setObjectValue(Object o)
Description copied from interface:SimpleValue
Sets the value as an arbitraryObject
.- Specified by:
setObjectValue
in interfaceSimpleValue
-
set_newValue
public final void set_newValue(XmlObject obj)
-
set
public final XmlObject set(XmlObject src)
Description copied from interface:XmlObject
Set the value/type of this XmlObject to be a copy of the source XmlObject. Because the type of the source may be different than this target, this XmlObject may become defunct. In this case the new XmlObject is returned. If no type change happens, the same this will be returned.
-
generatedSetterHelperImpl
public final XmlObject generatedSetterHelperImpl(XmlObject src, QName propName, int index, short kindSetterHelper)
-
_set
public final XmlObject _set(XmlObject src)
Same as set() but unsynchronized. Warning: Using this method in mutithreaded environment can cause invalid states.
-
valueEquals
public final boolean valueEquals(XmlObject xmlobj)
Description copied from interface:XmlObject
True if the xml values are equal. Two different objects (which are distinguished by equals(obj) == false) may of course have equal values (valueEquals(obj) == true).Usually this method can be treated as an ordinary equvalence relation, but actually it is not is not transitive. Here is a precise specification:
There are two categories of XML object: objects with a known instance type, and objects whose only known type is one of the ur-types (either AnyType or AnySimpleType). The first category is compared in terms of logical value spaces, and the second category is compared lexically.
Within each of these two categories, valueEquals is a well-behaved equivalence relation. However, when comparing an object of known type with an object with ur-type, the comparison is done by attempting to convert the lexical form of the ur-typed object into the other type, and then comparing the results. Ur-typed objects are therefore treated as lexical wildcards and may be equal to objects in different value spaces, even though the objects in different value spaces are not equal to each other.
For example, the anySimpleType value "1" will compare as an equalValue to the string "1", the float value "1.0", the double value "1.0", the decimal "1", and the GYear "1", even though all these objects will compare unequal to each other since they lie in different value spaces. Note: as of XMLBeans 2.2.1 only implemented for simple type values.
- Specified by:
valueEquals
in interfaceXmlObject
-
compareTo
public final int compareTo(Object obj)
Implements Comparable. This compareTo is inconsistent with equals unless isImmutable() is true.
-
compareValue
public final int compareValue(XmlObject xmlobj)
Description copied from interface:XmlObject
This comparison method is similar to compareTo, but rather than throwing a ClassCastException when two values are incomparable, it returns the number 2. The result codes are -1 if this object is less than obj, 1 if this object is greater than obj, zero if the objects are equal, and 2 if the objects are incomparable.- Specified by:
compareValue
in interfaceXmlObject
-
valueHashCode
public int valueHashCode()
- Specified by:
valueHashCode
in interfaceXmlObject
-
isInstanceOf
public boolean isInstanceOf(SchemaType type)
-
selectChildren
public XmlObject[] selectChildren(QName elementName)
Selects the contents of the children elements with the given name.- Specified by:
selectChildren
in interfaceXmlObject
- Parameters:
elementName
- The name of the elements to be selected.- Returns:
- Returns the contents of the selected elements.
-
selectChildren
public XmlObject[] selectChildren(String elementUri, String elementLocalName)
Selects the contents of the children elements with the given name.- Specified by:
selectChildren
in interfaceXmlObject
- Parameters:
elementUri
- The URI of the elements to be selected.elementLocalName
- The local name of the elements to be selected.- Returns:
- Returns the contents of the selected elements.
-
selectChildren
public XmlObject[] selectChildren(QNameSet elementNameSet)
Selects the contents of the children elements that are contained in the elementNameSet.- Specified by:
selectChildren
in interfaceXmlObject
- Parameters:
elementNameSet
- Set of element names to be selected.- Returns:
- Returns the contents of the selected elements.
- See Also:
SchemaType.qnameSetForWildcardElements()
,for creating sets of qnames
-
selectAttribute
public XmlObject selectAttribute(QName attributeName)
Selects the content of the attribute with the given name.- Specified by:
selectAttribute
in interfaceXmlObject
- Parameters:
attributeName
- The name of the attribute to be selected.- Returns:
- Returns the contents of the selected attribute.
-
selectAttribute
public XmlObject selectAttribute(String attributeUri, String attributeLocalName)
Selects the content of the attribute with the given name.- Specified by:
selectAttribute
in interfaceXmlObject
- Parameters:
attributeUri
- The URI of the attribute to be selected.attributeLocalName
- The local name of the attribute to be selected.- Returns:
- Returns the content of the selected attribute.
-
selectAttributes
public XmlObject[] selectAttributes(QNameSet attributeNameSet)
Selects the contents of the attributes that are contained in the elementNameSet.- Specified by:
selectAttributes
in interfaceXmlObject
- Parameters:
attributeNameSet
- Set of attribute names to be selected.- Returns:
- Returns the contents of the selected attributes.
- See Also:
SchemaType.qnameSetForWildcardAttributes()
,for creating sets of qnames
-
writeReplace
public Object writeReplace()
This method can writeReplace either an unwrapped XmlObjectBase or an XBean proxy. A "true" argument means unwrapped. The serialization strategy for XmlObjects is this: (1) Only the root XmlObject for a document actually gets fully serialized; it is serialized as a SerializedRootObject, which simply saves itself as XML text. (2) Interior XmlObjects get serialized as a reference to the root XmlObject for their document, plus an integer which indicates the position of the XmlObject within the owner document. This pair is stored as a SerializedInteriorObject. Both objects can be maked as wrapped or unwrapped. If wrapped, then the proxy is returned when deserializing; if unwrapped, then the proxy is stripped when deserializing.
-
-