/*
* eXist Open Source Native XML Database
* Copyright (C) 2009 The eXist Project
* http://exist-db.org
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*
* $Id$
*/
package org.exist.xquery.functions.validation;
import java.io.InputStream;
import java.net.MalformedURLException;
import org.exist.dom.QName;
import org.exist.memtree.MemTreeBuilder;
import org.exist.memtree.NodeImpl;
import org.exist.storage.BrokerPool;
import org.exist.storage.io.ExistIOException;
import org.exist.validation.ValidationReport;
import org.exist.validation.Validator;
import org.exist.xquery.BasicFunction;
import org.exist.xquery.Cardinality;
import org.exist.xquery.FunctionSignature;
import org.exist.xquery.XPathException;
import org.exist.xquery.XQueryContext;
import org.exist.xquery.value.BooleanValue;
import org.exist.xquery.value.FunctionParameterSequenceType;
import org.exist.xquery.value.FunctionReturnSequenceType;
import org.exist.xquery.value.Sequence;
import org.exist.xquery.value.SequenceType;
import org.exist.xquery.value.Type;
import org.exist.xquery.value.ValueSequence;
/**
* XQuery function for validation of XML instance documents
* using grammars like XSDs and DTDs.
*
* @author Dannes Wessels (dizzzz@exist-db.org)
*/
public class Validation extends BasicFunction {
private static final String deprecated1="Use the validation:jaxp-parse(), " +
"validation:jaxv() or validation:jing() functions.";
private static final String deprecated2="Use the validation:jaxp-parse-report(), " +
"validation:jaxv-report() or validation:jing-report() functions.";
private static final String simpleFunctionTxt=
"Validate xml. " +
"The grammar files (DTD, XML Schema) are resolved using the global "+
"catalog file(s).";
private static final String extendedFunctionTxt=
"Validate document by using a specific grammar.";
private final Validator validator;
private final BrokerPool brokerPool;
// Setup function signature
public final static FunctionSignature deprecated[] = {
new FunctionSignature(
new QName("validate", ValidationModule.NAMESPACE_URI,
ValidationModule.PREFIX),
simpleFunctionTxt,
new SequenceType[]{
new FunctionParameterSequenceType("instance", Type.ITEM, Cardinality.EXACTLY_ONE,
"The document referenced as xs:anyURI or a node (element or returned by fn:doc())")
},
new FunctionReturnSequenceType(Type.BOOLEAN, Cardinality.EXACTLY_ONE,
Shared.simplereportText), deprecated1
),
new FunctionSignature(
new QName("validate", ValidationModule.NAMESPACE_URI,
ValidationModule.PREFIX),
extendedFunctionTxt,
new SequenceType[]{
new FunctionParameterSequenceType("instance", Type.ITEM, Cardinality.EXACTLY_ONE,
"The document referenced as xs:anyURI or a node (element or returned by fn:doc())"),
new FunctionParameterSequenceType("grammar", Type.ANY_URI, Cardinality.EXACTLY_ONE,
"The reference to an OASIS catalog file (.xml), "+
"a collection (path ends with '/') or a grammar document. "+
"Supported grammar documents extensions are \".dtd\" \".xsd\" "+
"\".rng\" \".rnc\" \".sch\" and \".nvdl\".")
},
new FunctionReturnSequenceType(Type.NODE, Cardinality.EXACTLY_ONE,
Shared.simplereportText), deprecated1
),
new FunctionSignature(
new QName("validate-report", ValidationModule.NAMESPACE_URI,
ValidationModule.PREFIX),
simpleFunctionTxt+" An xml report is returned.",
new SequenceType[]{
new FunctionParameterSequenceType("instance", Type.ITEM, Cardinality.EXACTLY_ONE,
"The document referenced as xs:anyURI or a node (element or returned by fn:doc())")
},
new FunctionReturnSequenceType(Type.NODE, Cardinality.EXACTLY_ONE,
Shared.xmlreportText), deprecated2
),
new FunctionSignature(
new QName("validate-report", ValidationModule.NAMESPACE_URI,
ValidationModule.PREFIX),
extendedFunctionTxt+" An xml report is returned.",
new SequenceType[]{
new FunctionParameterSequenceType("instance", Type.ITEM, Cardinality.EXACTLY_ONE,
"The document referenced as xs:anyURI or a node (element or returned by fn:doc())"),
new FunctionParameterSequenceType("grammar", Type.ANY_URI, Cardinality.EXACTLY_ONE,
"The reference to an OASIS catalog file (.xml), "+
"a collection (path ends with '/') or a grammar document. "+
"Supported grammar documents extensions are \".dtd\" \".xsd\" "+
"\".rng\" \".rnc\" \".sch\" and \".nvdl\".")
},
new FunctionReturnSequenceType(Type.NODE, Cardinality.EXACTLY_ONE,
Shared.xmlreportText), deprecated2
)
};
public Validation(XQueryContext context, FunctionSignature signature) {
super(context, signature);
brokerPool = context.getBroker().getBrokerPool();
validator = new Validator(brokerPool);
}
/**
* @throws org.exist.xquery.XPathException
* @see BasicFunction#eval(Sequence[], Sequence)
*/
public Sequence eval(Sequence[] args, Sequence contextSequence)
throws XPathException {
// Check input parameters
if (args.length != 1 && args.length != 2) {
return Sequence.EMPTY_SEQUENCE;
}
InputStream is = null;
ValidationReport report = new ValidationReport();
try { // args[0]
is = Shared.getInputStream(args[0].itemAt(0), context);
if(args.length == 1) {
// Validate using system catalog
report=validator.validate(is);
} else {
// Validate using resource specified in second parameter
String url=Shared.getUrl(args[1].itemAt(0));
report=validator.validate(is, url);
}
} catch (MalformedURLException ex) {
LOG.error(ex.getMessage());
report.setException(ex);
} catch (ExistIOException ex) {
LOG.error(ex.getCause());
report.setException(ex);
} catch (Throwable ex) {
LOG.error(ex);
report.setException(ex);
} finally {
// Force release stream
if(is != null){
try {
is.close();
} catch (Exception ex) {
LOG.debug("Attemted to close stream. ignore.", ex);
}
}
}
// Create response
if (isCalledAs("validate") || isCalledAs("jing")) {
Sequence result = new ValueSequence();
result.add(new BooleanValue(report.isValid()));
return result;
} else /* isCalledAs("validate-report") || isCalledAs("jing-report") */{
MemTreeBuilder builder = context.getDocumentBuilder();
NodeImpl result = Shared.writeReport(report, builder);
return result;
}
}
}