Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2014-2021 Philip Helger (www.helger.com)
* philip[at]helger[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.helger.phive.engine.xsd;
import java.util.List;
import java.util.Locale;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.xml.validation.Schema;
import javax.xml.xpath.XPathConstants;
import javax.xml.xpath.XPathExpressionException;
import org.w3c.dom.NodeList;
import org.xml.sax.SAXParseException;
import com.helger.commons.ValueEnforcer;
import com.helger.commons.annotation.Nonempty;
import com.helger.commons.error.SingleError;
import com.helger.commons.error.level.EErrorLevel;
import com.helger.commons.error.list.ErrorList;
import com.helger.commons.functional.ISupplier;
import com.helger.commons.io.resource.IReadableResource;
import com.helger.commons.string.ToStringGenerator;
import com.helger.jaxb.builder.IJAXBDocumentType;
import com.helger.phive.api.EValidationType;
import com.helger.phive.api.artefact.IValidationArtefact;
import com.helger.phive.api.artefact.ValidationArtefact;
import com.helger.phive.api.execute.AbstractValidationExecutor;
import com.helger.phive.api.execute.IValidationExecutor;
import com.helger.phive.api.result.ValidationResult;
import com.helger.phive.engine.source.IValidationSourceXML;
import com.helger.phive.engine.source.ValidationSourceXML;
import com.helger.xml.sax.AbstractSAXErrorHandler;
import com.helger.xml.schema.XMLSchemaCache;
import com.helger.xml.schema.XMLSchemaValidationHelper;
/**
* Implementation of {@link IValidationExecutor} for XML Schema validation of
* parts of a source document.
*
* @author Philip Helger
*/
public class ValidationExecutorXSDPartial extends AbstractValidationExecutor
{
private final ISupplier m_aSchemaProvider;
private final XSDPartialContext m_aPartialContext;
/**
* Constructor
*
* @param aValidationArtefact
* The validation artefact to use
* @param aPartialContext
* The partial context that defines the rules for finding the correct
* nodes to validate. May not be null.
* @deprecated Since 6.0.4. Use
* {@link #ValidationExecutorXSDPartial(IValidationArtefact, ISupplier, XSDPartialContext)}
* instead
*/
@Deprecated
public ValidationExecutorXSDPartial (@Nonnull final IValidationArtefact aValidationArtefact,
@Nonnull final XSDPartialContext aPartialContext)
{
this (aValidationArtefact, () -> XMLSchemaCache.getInstance ().getSchema (aValidationArtefact.getRuleResource ()), aPartialContext);
}
/**
* Constructor
*
* @param aValidationArtefact
* The validation artefact to use. May not be null.
* @param aSchemaProvider
* The XML Schema provider to use. May not be null.
* @param aPartialContext
* The partial context that defines the rules for finding the correct
* nodes to validate. May not be null.
* @since 6.0.4
*/
public ValidationExecutorXSDPartial (@Nonnull final IValidationArtefact aValidationArtefact,
@Nonnull final ISupplier aSchemaProvider,
@Nonnull final XSDPartialContext aPartialContext)
{
super (aValidationArtefact);
ValueEnforcer.isTrue (aValidationArtefact.getValidationArtefactType ().isXSD (), "Artifact is not an XSD");
ValueEnforcer.notNull (aSchemaProvider, "SchemaProvider");
ValueEnforcer.notNull (aPartialContext, "PartialContext");
m_aSchemaProvider = aSchemaProvider;
m_aPartialContext = aPartialContext;
}
/**
* @return The partial execution context as provided in the constructor. May
* not be null.
*/
@Nonnull
public final XSDPartialContext getContext ()
{
return m_aPartialContext;
}
@Nonnull
public ValidationResult applyValidation (@Nonnull final IValidationSourceXML aSource, @Nullable final Locale aLocale)
{
ValueEnforcer.notNull (aSource, "Source");
final IValidationArtefact aVA = getValidationArtefact ();
NodeList aNodeSet;
try
{
aNodeSet = (NodeList) m_aPartialContext.getXPathExpression ().evaluate (aSource.getNode (), XPathConstants.NODESET);
}
catch (final XPathExpressionException ex)
{
throw new IllegalStateException (ex);
}
final ErrorList aErrorList = new ErrorList ();
final int nMatchingNodes = aNodeSet.getLength ();
if (m_aPartialContext.hasMinNodeCount ())
if (nMatchingNodes < m_aPartialContext.getMinNodeCount ())
{
// Too little matches found
aErrorList.add (SingleError.builderFatalError ()
.setErrorLocation (aVA.getRuleResourcePath ())
.setErrorText ("The minimum number of result nodes (" +
m_aPartialContext.getMinNodeCount () +
") is not met")
.build ());
}
if (m_aPartialContext.hasMaxNodeCount ())
if (nMatchingNodes > m_aPartialContext.getMaxNodeCount ())
{
// Too little matches found
aErrorList.add (SingleError.builderFatalError ()
.setErrorLocation (aVA.getRuleResourcePath ())
.setErrorText ("The maximum number of result nodes (" +
m_aPartialContext.getMaxNodeCount () +
") is not met")
.build ());
}
if (nMatchingNodes == 0)
{
// No match found - nothing to do
return new ValidationResult (aVA, aErrorList);
}
// Find the XML schema required for validation
// as we don't have a node, we need to trust the implementation class
final Schema aSchema = m_aSchemaProvider.get ();
assert aSchema != null;
for (int i = 0; i < aNodeSet.getLength (); ++i)
{
// Build a partial source
final IValidationSourceXML aRealSource = new ValidationSourceXML (aSource.getSystemID (), aNodeSet.item (i), true);
try
{
// Apply the XML schema validation
XMLSchemaValidationHelper.validate (aSchema, aRealSource.getAsTransformSource (), aErrorList, aLocale);
}
catch (final IllegalArgumentException ex)
{
// Happens when non-XML document is trying to be parsed
if (ex.getCause () instanceof SAXParseException)
{
aErrorList.add (AbstractSAXErrorHandler.getSaxParseError (EErrorLevel.FATAL_ERROR, (SAXParseException) ex.getCause ()));
}
else
{
aErrorList.add (SingleError.builderFatalError ()
.setErrorLocation (aVA.getRuleResourcePath ())
.setErrorFieldName ("Context[" + i + "]")
.setErrorText ("The document to be validated is not an XML document")
.setLinkedException (ex)
.build ());
}
}
}
// Build result object
return new ValidationResult (aVA, aErrorList.getAllFailures ());
}
@Override
public boolean equals (final Object o)
{
if (o == this)
return true;
return super.equals (o);
}
@Override
public int hashCode ()
{
return super.hashCode ();
}
@Override
public String toString ()
{
return ToStringGenerator.getDerived (super.toString ())
.append ("SchemaProvider", m_aSchemaProvider)
.append ("PartialContext", m_aPartialContext)
.getToString ();
}
/**
* Create a new instance based on the {@link IJAXBDocumentType} description
*
* @param aDocType
* The document type. May not be null.
* @param aPartialContext
* The partial context that defines the rules for finding the correct
* nodes to validate. May not be null.
* @return A new validator that uses the last resource for the filename and
* and the {@link IJAXBDocumentType#getSchema()} method for XML Schema
* resolution.
* @since 6.0.4
*/
@Nonnull
public static ValidationExecutorXSDPartial create (@Nonnull final IJAXBDocumentType aDocType,
@Nonnull final XSDPartialContext aPartialContext)
{
ValueEnforcer.notNull (aDocType, "DocType");
// The last one is the important one for the name
return new ValidationExecutorXSDPartial (new ValidationArtefact (EValidationType.XSD, aDocType.getAllXSDResources ().getLast ()),
aDocType::getSchema,
aPartialContext);
}
/**
* Create a new instance based on a single standalone XSD
*
* @param aXSDRes
* The XSD resource to use. May not be null.
* @param aPartialContext
* The partial context that defines the rules for finding the correct
* nodes to validate. May not be null.
* @return A new validator that uses the supplied resource for the filename
* and uses {@link XMLSchemaCache} to resolve the XML Schema object.
* @since 6.0.4
*/
@Nonnull
public static ValidationExecutorXSDPartial create (@Nonnull final IReadableResource aXSDRes,
@Nonnull final XSDPartialContext aPartialContext)
{
ValueEnforcer.notNull (aXSDRes, "XSDRes");
return new ValidationExecutorXSDPartial (new ValidationArtefact (EValidationType.XSD, aXSDRes),
() -> XMLSchemaCache.getInstance ().getSchema (aXSDRes),
aPartialContext);
}
/**
* Create a new instance based on one or more XSDs
*
* @param aXSDRes
* The XSD resources to use. May neither be null nor
* empty.
* @param aPartialContext
* The partial context that defines the rules for finding the correct
* nodes to validate. May not be null.
* @return A new validator that uses the last resource for the filename uses
* {@link XMLSchemaCache} to resolve the XML Schema object.
* @since 6.0.4
*/
@Nonnull
public static ValidationExecutorXSDPartial create (@Nonnull @Nonempty final List aXSDRes,
@Nonnull final XSDPartialContext aPartialContext)
{
ValueEnforcer.notEmptyNoNullValue (aXSDRes, "XSDRes");
// The last one is the important one for the name
return new ValidationExecutorXSDPartial (new ValidationArtefact (EValidationType.XSD, aXSDRes.get (aXSDRes.size () - 1)),
() -> XMLSchemaCache.getInstance ().getSchema (aXSDRes),
aPartialContext);
}
}
