XSSimpleType

XSSimpleType is a class which instances represent XML Schema's simple type definitions.

Some of them are predefined, they correspond to built in datatypes. Others are constructed while loading XMLSchemata. Each derived XML type is modelled by a single instance of a class derived from the parent representation. All those are internal objects are mostly used by XMLMarshaller.stringify ().

The main method, stringify (value), maps an arbitrary non-nullish value into the corresponding string from the type's lexical space, or throws an error when the argument is unacceptable. In the base implementation, it simply calls toString(), but specific ancestor classes do some necessary validation and conversion.

Subclass	XML Types	Acceptable Values
XSSimpleTypeBoolean	boolean	true, false, 'true', 'false', 1, 0, '1', '0'
XSSimpleTypeDate	date	Date, String (ISO)
XSSimpleTypeDateTime	dateTime	Date, String (ISO)
XSSimpleTypeDecimal	decimal	! isNaN()
XSSimpleTypeInteger	integer	Number.isInteger()
XSSimpleTypeFloat	double, float	! isNaN()
XSSimpleTypeQName	QName	{localName, namespaceURI}
XSSimpleType	all other	non-nullish

Limitations

In general, the output is not guaranteed to be valid for any possible incoming value.

There is a certain functionality/performance trade-off here. The application developer is expected to supply some reasonable content.

For instance, XSSimpleTypeDateTime passes through any 10 char long string as is, without spending a CPU cycle on checking for YYYY-MM-DD format, month number, leap year etc. It's OK to supply a dateTime value for a date placeholder, the time part will be truncated, but xml-toolkit will never try to fix any random content.

Restriction Facets supported

fractionDigits

For simple types derived from decimal by applying restrictions, the bottom fractionDigits facet is used.

For instance, for a type restricted with

<fractionDigits value='1'/>

from some other that has

<fractionDigits value='3'/>

the output will be calculated with toFixed (1).

pattern

Each XSSimpleType instance keeps the list of RegExps mentioned in all pattern restricting facets up by the inheritance tree. The stringify (value) method scans through possible textual representations and returns the first one satisfying all restrictions.

For instance, the base XSSimpleTypeBoolean outputs true as true, but its ancestor generated for SOAP 1.1's mustUnderstand attribute

<xs:simpleType>
  <xs:restriction base="xs:boolean">
    <xs:pattern value="0|1"/>
  </xs:restriction>
</xs:simpleType>

prints 1 instead.