NAME¶

SOAP::WSDL::XSD::Typelib::Builtin - Built-in XML Schema datatypes

DESCRIPTION¶

The SOAP::WSDL::XSD::Typelib::Builtin hierarchy implements all builtin types from the XML schema specification.

All XML schema derived types inherit from SOAP::WSDL::XSD::Typelib::Builtin::anyType.

These basic type classes are most useful when used as element or simpleType base classes.

Using SOAP::WSDL::XSD::Typelib::Builtin uses all of the builtin datatype classes.

All builtin types feature common behaviour described below in "OVERLOADED OPERATORS"

EXAMPLES¶

 my $bool = SOAP::WSDL::XSD::Typelib::Builtin::bool->new({ value => 0} );
 print $bool;    # prints "true"
 # implements <simpleType name="MySimpleType">
 #               <list itemType="xsd:string" />
 #            </simpleType>
 package MySimpleType;
 use SOAP::WSDL::XSD::Typelib::Builtin;
 use SOAP::WSDL::XSD::Typelib::SimpleType;
 use base qw(SOAP::WSDL::XSD::Typelib::SimpleType
    SOAP::WSDL::XSD::Typelib::Builtin::list
    SOAP::WSDL::XSD::Typelib::Builtin::string
 );
 1;
 # somewhere else
 my $list = MySimpleType->new({ value => [ 'You', 'shall', 'overcome' ] });
 print $list;   # prints "You shall overcome"

CLASS HIERARCHY¶

This is the inheritance graph for builtin types.

Types with [] marker describe types derived via the item in [] in the XML Schema specs.

Derivation is implemented via multiple inheritance with the derivation method as first item in the base class list.

 anyType
 - anySimpleType
     - duration
     - dateTime
     - date
     - time
     - gYearMonth
     - gYear
     - gMonthDay
     - gDay
     - gMonth
     - boolean
     - base64Binary
     - hexBinary
     - float
     - decimal
         - integer
         - nonPositiveInteger
             - negativeInteger
         - nonNegativeInteger
             - positiveInteger
             - unsignedLong
             - unsignedInt
             - unsignedShort
             - unsignedByte
         - long
             - int
                 - short
                     - byte
     - double
     - anyURI
     - NOTATION
     - string
          - normalizedString
              - language
              - Name
                  - NCName
                      - ID
                      - IDREF
                          - IDREFS [list]
                      - ENTITY
              - token
                  - NMTOKEN
                      - NMTOKENS [list]

OVERLOADED OPERATORS¶

Overloading is implemented via Class::Std's trait mechanism.

The following behaviours apply:

• string context

  All classes use the "serialize" method for stringification.

• bool context

  All classes derived from anySimpleType return their value in bool context

• numeric context

  The boolean class returns 0 or 1 in numeric context.

  decimal, float and double (and derived classes) return their value in numeric context.

• arrayification (@{})

  When accessed as a list ref, objects of all classes return a list ref with the object itself as single element.

  This is most useful for writing loops without additional conversions, especially in mini-languages found in templating systems or the like, which may not natively support converting to list refs.

  Instead of writing something like

   my $value = $complexType->get_ELEMENT;
   $value = ref $value eq 'ARRAY' ? $value : [ $value ];
   for (@{ $value }) { ... }
      

  you can just write

   for (@{ $complexType->get_ELEMENT }) {...}
      

  Note that complexTypes with undef elements still return undef when accessing an undefined element, so when an element may be empty you still have to write something like:

   my $value = $complexType->get_ELEMENT();
   if (defined $value) {
       for (@{ $value }) {
           ...
       }
   }
      

Subclasses¶

 $obj->delete_value();

 YYYY-MM-DD+zz:zz

 YYYY-MM-DDThh:mm:ss.nnnnnnn+zz:zz

 hh:mm:ss.nnnnnnn+zz:zz
 hh:mm:ss+zz:zz

CAVEATS¶

•

set_value

In contrast to Class::Std-generated mutators (setters), set_value does not return the last value.

This is for speed reasons: SOAP::WSDL never needs to know the last value when calling set_calue, but calls it over and over again...

BUGS AND LIMITATIONS¶

• Thread safety

  SOAP::WSDL::XSD::Typelib::Builtin uses Class::Std::Fast::Storable which uses Class::Std. Class::Std is not thread safe, so SOAP::WSDL::XSD::Typelib::Builtin is neither.

• XML Schema facets

  No facets are implemented yet.

AUTHOR¶

Replace whitespace by @ in e-mail address.

 Martin Kutter E<gt>martin.kutter fen-net.deE<lt>

LICENSE AND COPYRIGHT¶

Copyright 2004-2007 Martin Kutter.

This file is part of SOAP-WSDL. You may distribute/modify it under the same terms as perl itself