Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xml::validate::xerces(3pm) [debian man page]

XML::Validate::Xerces(3pm)				User Contributed Perl Documentation				XML::Validate::Xerces(3pm)

NAME

       XML::Validate::Xerces - Interface to Xerces validator

SYNOPSIS

	       my $validator = new XML::Validate::Xerces(%options);
	       if ($doc = $validator->validate($xml)) {
		       ... Do stuff with $doc ...
	       } else {
		       print "Document is invalid
";
	       }

DESCRIPTION

       XML::Validate::Xerces is an interface to the Xerces parser which can be used with the XML::Validate module.

METHODS

       new(%options)
	   Returns a new XML::Validate::Xerces instance using the specified options. (See OPTIONS below.)

       validate($xml)
	   Returns a true value if $xml could be successfully parsed, undef otherwise.

       last_dom()
	   Returns the Xerces DOM object of the document last validated.

       last_error()
	   Returns the error from the last validate call. This is a hash ref with the following fields:

	   o   message

	   o   line

	   o   column

	   Note that the error gets cleared at the beginning of each "validate" call.

       version()
	   Returns the version of the XML::Xerces module that is installed

OPTIONS

       XML::Validate::Xerces takes the following options:

       strict_validation
	   If this boolean value is true, the document will be validated during parsing.  Otherwise it will only be checked for well-formedness.
	   Defaults to true.

       base_uri
	   Since the XML document is supplied as a string, the validator doesn't know the document's URI. If the document contains any components
	   referenced using relative URI's, you'll need to set this option to the document's URI so that the validator can retrieve them
	   correctly.

ERROR REPORTING

       When a call to validate fails to parse the document, the error may be retrieved using last_error.

       On errors not related to the XML parsing, these methods will throw exceptions.  Wrap calls with eval to catch them.

DEPENDENCIES

       XML::Xerces

BUGS

       XML::Xerces contains an INIT block that doesn't get run because we load the module in an eval. This causes a warning message to be printed.
       We then run the code in XML::Xerces ourselves, but this is fragile because XML::Xerces might change. We need to keep an eye on this.

       XML::Xerces reacts badly to code which does "use UNIVERSAL" (see <http://issues.apache.org/bugzilla/show_bug.cgi?id=25788>).
       XML::Validate::Xerces inherits this bug. Modules that are known to cause problems include Time::Piece and versions of XML::Twig prior to
       April 2005).

VERSION

       $Revision: 1.21 $ on $Date: 2005/09/06 11:05:09 $ by $Author: johna $

AUTHOR

       Nathan Carr, Colin Robertson

       <cpan _at_ bbc _dot_ co _dot_ uk>

COPYRIGHT

       (c) BBC 2005. This program is free software; you can redistribute it and/or modify it under the GNU GPL.  See the file COPYING in this
       distribution, or http://www.gnu.org/licenses/gpl.txt

perl v5.10.1							    2006-04-19						XML::Validate::Xerces(3pm)

Check Out this Related Man Page

XML::LibXML::RelaxNG(3) 				User Contributed Perl Documentation				   XML::LibXML::RelaxNG(3)

NAME

       XML::LibXML::RelaxNG - RelaxNG Schema Validation

SYNOPSIS

	 use XML::LibXML;
	 $doc = XML::LibXML->new->parse_file($url);

	 $rngschema = XML::LibXML::RelaxNG->new( location => $filename_or_url );
	 $rngschema = XML::LibXML::RelaxNG->new( string => $xmlschemastring );
	 $rngschema = XML::LibXML::RelaxNG->new( DOM => $doc );
	 eval { $rngschema->validate( $doc ); };

DESCRIPTION

       The XML::LibXML::RelaxNG class is a tiny frontend to libxml2's RelaxNG implementation. Currently it supports only schema parsing and
       document validation.

METHODS

       new
	     $rngschema = XML::LibXML::RelaxNG->new( location => $filename_or_url );
	     $rngschema = XML::LibXML::RelaxNG->new( string => $xmlschemastring );
	     $rngschema = XML::LibXML::RelaxNG->new( DOM => $doc );

	   The constructor of XML::LibXML::RelaxNG may get called with either one of three parameters. The parameter tells the class from which
	   source it should generate a validation schema. It is important, that each schema only have a single source.

	   The location parameter allows one to parse a schema from the filesystem or a URL.

	   The string parameter will parse the schema from the given XML string.

	   The DOM parameter allows one to parse the schema from a pre-parsed XML::LibXML::Document.

	   Note that the constructor will die() if the schema does not meed the constraints of the RelaxNG specification.

       validate
	     eval { $rngschema->validate( $doc ); };

	   This function allows one to validate a (parsed) document against the given RelaxNG schema. The argument of this function should be an
	   XML::LibXML::Document object. If this function succeeds, it will return 0, otherwise it will die() and report the errors found. Because
	   of this validate() should be always evaluated.

AUTHORS

       Matt Sergeant, Christian Glahn, Petr Pajas

VERSION

       2.0110

COPYRIGHT

       2001-2007, AxKit.com Ltd.

       2002-2006, Christian Glahn.

       2006-2009, Petr Pajas.

LICENSE

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.18.2							    2014-02-01						   XML::LibXML::RelaxNG(3)
Man Page