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. Anyway, those are internal objects 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.