CONSTRUCTORS

  $class->new($value)
  $class->new(%fields)

CONSTRUCTOR overriden from XML::Pastor::Type.

The new() constructor method instantiates a new XML::Pastor::SimpleType object. It is inheritable, and indeed inherited, by the generated decsendant classes. Normally, you do not call the new method on XML::Pastor::SimpleType. You rather call it on your generated subclasses.

Any -named- fields that are passed as parameters are initialized to those values within the newly created object. The only field that makes any sense at this time is the 'value' field. This is why it has been made easier to pass value as the one and only parameter.

The following two calls are equivalent:

  my $object = $class->new($value);
  my $object = $class->new(value => $value);

Stick with the first one, as the second one requires the knowledge of the internal organization of the object.

from_xml_dom()

        my $object = $class->from_xml_dom($node);

CONSTRUCTOR that should be called upon your generated class rather than XML::Pastor::ComplexType.

This method instatiates an object of the generated class from a DOM object passed as a parameter. Currently, the DOM object must be either of type XML::LibXML::Attr, XML::LibXML::Text or of type XML::LibXML::Element (with textContent).

Currently, the method is quite forgiving as to the actual contents of the DOM. No validation is performed during this call.

.

CLASS DATA ACCESSORS

  my $type = $class->XmlSchemaType()

CLASS METHOD, but may also be called directly on an OBJECT.

XML::Pastor::SimpleType defines (thanks to Class::Data::Inheritable) a class data acessor XmlSchemaType which returns undef.

This data accessor is set by each generated simple class to the meta information coming from your W3C Schema. This data is of class XML::Pastor::Schema::SimpleType.

You don't really need to know much about XmlSchemaType. It's used internally by Pastor's XML binding and validation methods as meta information about the generated class.

ACCESSORS

  $currentValue = $object->value();     # GET
  $object->value($newValue);            # SET

Gets and sets the value of the 'value' field, which is the actual SCALAR value of the object.

OTHER METHODS

  $bool = $object->is_xml_valid();

OBJECT METHOD, inherited from XML::Pastor::Type. Documented here for completeness.

'is_xml_valid' is similar to "xml_validate" except that it will not die on failure. Instead, it will just return FALSE (0).

The implementation of this method, inherited from XML::Pastor::Type, is very simple. Currently, it just calls "xml_validate" in an eval block and will return FALSE (0) if "xml_validate" dies. Otherwise, it will just return the same value as "xml_validate".

In case of failure, the contents of the special variable $@ will be left untouched in case you would like to access the error message that resulted from the death of "xml_validate".

.

xml_validate()

        $object->xml_validate();        # Will die on failure

OBJECT METHOD, overriden from XML::Pastor::Type.

'xml_validate' validates a Pastor XML object (of a generated class) with respect to the META information that had originally be extracted from your original W3C XSD Schema.

On sucess, xml_validate returns TRUE (1). On failure, it will die on you on validation errors.

The W3C recommendations have been observed as closely as possible for the implementation of this method. Neverthless, it remains somewhat more relaxed and easy compared to Castor for example.

The following properties of XML Simple Type declarations in the W3C schema are observed:

length

The string length of the value.

minLength, maxLength

The minimum and maximum string lengths for the value.

pattern

One ore more W3C regex patterns that the value must match. If more than one is present, any one match is considered sufficient for validity.

regex (not present in W3C schema)

Like 'pattern', but guaranteed to be a Perl regular expression even if the W3C 'pattern' diverges from this in the future. This is used internally for builtin types. Like 'pattern', one or more regexes can be present.

enumeration

A hash of enumeration values.

minInclusive, maxInclusive

Minimum and maximum inclusive values.

minExclusive, maxExclusive

Minimum and maximum exclusive values.

totalDigits, fractionDigits

The total and fraction digits (in a floating point number) respectively.

These properties are obtained from the schema type object returned from the "XmlSchemaType" class data accessor call.

The builtin types use these properties extensively to enforce vaildity. The 'regex' property is used heavily for builtin types.

After checking the conformity with these properties, xml_validate calls "xml_validate_further" to perform extra checks. For XML::Pastor::SimpleType this always returns TRUE, but some builtin types (like XML::Pastor::Builtin::date and XML::Pastor::Builtin::dateTime) actually perform some extra validation during this call.

Then, the xml_validate method is called on any capable ancestors in the ISA array. A failure in any one of these calls will result in the failure of xml_validate which will consequently die.

xml_validate_further()

        $object->xml_validate_further();        # Never called directly.

OBJECT METHOD, overriden from XML::Pastor::Type.

'xml_validate_further' should perform extra validation on a Pastor XML object (of a generated class).

It is called by "xml_validate" after performing rutine validations.

This method should return TRUE(1) on success, and die on failure with an error message.

For XML::Pastor::SimpleType, this method simple returns TRUE(1).

This method may be overriden by subclasses and it is indeed oevrriden by several builtin classes like like XML::Pastor::Builtin::date and XML::Pastor::Builtin::dateTime.