.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SOAP::WSDL::XSD::Typelib::SimpleType 3pm"
.TH SOAP::WSDL::XSD::Typelib::SimpleType 3pm "2022-10-14" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
SOAP::WSDL::XSD::Typelib::SimpleType \- simpleType base class
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This module implements a base class for designing simple type classes
modelling \s-1XML\s0 Schema simpleType definitions.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 10
\& # example simpleType derived by restriction
\& # XSD would be:
\& #
\& #
\& #
\& package MySimpleType;
\& use Class::Std::Fast::Storable constructor => \*(Aqnone\*(Aq;
\& # restriction base implemented via inheritance
\& use SOAP::WSDL::XSD::Typelib::Builtin;
\& use SOAP::WSDL::XSD::Typelib::SimpleType;
\& use base qw(
\& # derive by restriction
\& \*(AqSOAP::WSDL::XSD::Typelib::SimpleType::restriction\*(Aq,
\& # restriction base
\& \*(AqSOAP::WSDL::XSD::Typelib::Builtin::string\*(Aq
\& );
\&
\& # example simpleType derived by list.
\& # XSD would be:
\& #
\& #
\& #
\& package MySimpleListType;
\& use Class::Std::Fast::Storable constructor => \*(Aqnone\*(Aq;
\& # restriction base implemented via inheritance
\& use SOAP::WSDL::XSD::Typelib::Builtin;
\& use base (\*(AqSOAP::WSDL::XSD::Typelib::SimpleType\*(Aq,
\& \*(AqSOAP::WSDL::XSD::Typelib::Builtin::list\*(Aq, # derive by list
\& \*(AqSOAP::WSDL::XSD::Typelib::Builtin::string\*(Aq # list itemType
\& );
.Ve
.SH "How to write your own simple type"
.IX Header "How to write your own simple type"
Writing a simple type class is easy \- all you have to do is setting up the
base classes correctly.
.PP
The following rules apply:
.IP "\(bu" 4
simpleType derived via list
.Sp
simpleType classes derived via list must inherit from these classes in
exactly this order:
.Sp
.Vb 3
\& SOAP::WSDL::XSD::Typelib::SimpleType
\& SOAP::WSDL::XSD::Typelib::Builtin::list # derive by list
\& The::List::ItemType::Class # list itemType
.Ve
.Sp
The::List::ItemType::Class can either be a builtin class (see
SOAP::WSDL::XSD::Builtin) or another simpleType class (any other class
implementing the right methods is supported too, but not for the
faint of heart).
.IP "\(bu" 4
simpleType derived via restriction
.Sp
simpleType classes derived via restriction must inherit from these classes in
exactly this order:
.Sp
.Vb 3
\& SOAP::WSDL::XSD::Typelib::SimpleType # you may leave this out
\& SOAP::WSDL::XSD::Typelib::SimpleType::restriction # derive by restriction
\& The::Restriction::Base::Class # restriction base
.Ve
.Sp
The::Restriction::Base::Class can either be a builtin class (see
SOAP::WSDL::XSD::Builtin) or another simpleType class.
.Sp
The slight inconsistency between the these variants is caused by the
restriction element, which has different meanings for simpleType and
complexType definitions.
.SH "BUGS AND LIMITATIONS"
.IX Header "BUGS AND LIMITATIONS"
.IP "\(bu" 4
Thread safety
.Sp
SOAP::WSDL::XSD::Typelib::SimpleType uses Class::Std::Fast::Storable which uses
Class::Std. Class::Std is not thread safe, so
SOAP::WSDL::XSD::Typelib::SimpleType is neither.
.IP "\(bu" 4
union
.Sp
union simple types are not supported yet.
.IP "\(bu" 4
\&\s-1XML\s0 Schema facets
.Sp
No facets are implemented yet.
.SH "LICENSE AND COPYRIGHT"
.IX Header "LICENSE AND COPYRIGHT"
Copyright 2004\-2007 Martin Kutter.
.PP
This file is part of SOAP-WSDL. You may distribute/modify it under the same
terms as perl itself
.SH "AUTHOR"
.IX Header "AUTHOR"
Martin Kutter
.SH "REPOSITORY INFORMATION"
.IX Header "REPOSITORY INFORMATION"
.Vb 4
\& $Rev: 851 $
\& $LastChangedBy: kutterma $
\& $Id: SimpleType.pm 851 2009\-05\-15 22:45:18Z kutterma $
\& $HeadURL: https://soap\-wsdl.svn.sourceforge.net/svnroot/soap\-wsdl/SOAP\-WSDL/trunk/lib/SOAP/WSDL/XSD/Typelib/SimpleType.pm $
.Ve