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-2024 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.api.executorset;
import java.time.OffsetDateTime;
import java.util.Comparator;
import java.util.Map;
import java.util.Set;
import java.util.function.Predicate;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.GuardedBy;
import javax.annotation.concurrent.ThreadSafe;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.helger.commons.ValueEnforcer;
import com.helger.commons.annotation.ELockType;
import com.helger.commons.annotation.MustBeLocked;
import com.helger.commons.annotation.ReturnsMutableCopy;
import com.helger.commons.collection.CollectionHelper;
import com.helger.commons.collection.impl.CommonsHashMap;
import com.helger.commons.collection.impl.CommonsTreeMap;
import com.helger.commons.collection.impl.ICommonsList;
import com.helger.commons.collection.impl.ICommonsMap;
import com.helger.commons.collection.impl.ICommonsNavigableMap;
import com.helger.commons.concurrent.SimpleReadWriteLock;
import com.helger.commons.datetime.PDTFactory;
import com.helger.commons.state.EChange;
import com.helger.commons.string.StringHelper;
import com.helger.commons.string.ToStringGenerator;
import com.helger.diver.api.coord.DVRCoordinate;
import com.helger.diver.api.version.DVRPseudoVersionRegistry;
import com.helger.diver.api.version.DVRVersion;
import com.helger.diver.api.version.IDVRPseudoVersion;
import com.helger.phive.api.config.PhivePseudoVersionRegistrarSPIImpl;
import com.helger.phive.api.executor.IValidationExecutor;
import com.helger.phive.api.source.IValidationSource;
/**
* A registry for {@link IValidationExecutorSet} objects. This class is
* thread-safe and can therefore be used as a singleton.
* Initially all validation artefact providers need to register themselves via
* {@link #registerValidationExecutorSet(IValidationExecutorSet)}. This needs to
* be done only once upon initialization before usage.
* For applying validation of rules onto an XML document,
* {@link #getOfID(DVRCoordinate)} needs to be invoked to find a matching VES
* (Validation Executor Set - type `IValidationExecutorSet`). If the returned
* value is non-null than some rules are registered.
*
* @author Philip Helger
* @param
* The validation source type to be used.
*/
@ThreadSafe
public class ValidationExecutorSetRegistry implements
IValidationExecutorSetRegistry
{
public static final boolean DEFAULT_RESOLVE_PSEUDO_VERSIONS = true;
private static final Logger LOGGER = LoggerFactory.getLogger (ValidationExecutorSetRegistry.class);
protected final SimpleReadWriteLock m_aRWLock = new SimpleReadWriteLock ();
@GuardedBy ("m_aRWLock")
private final ICommonsMap > m_aMap = new CommonsHashMap <> ();
@GuardedBy ("m_aRWLock")
private boolean m_bResolvePseudoVersions = DEFAULT_RESOLVE_PSEUDO_VERSIONS;
public ValidationExecutorSetRegistry ()
{}
public final boolean isResolvePseudoVersions ()
{
return m_aRWLock.readLockedBoolean ( () -> m_bResolvePseudoVersions);
}
public final void setResolvePseudoVersions (final boolean b)
{
m_aRWLock.writeLocked ( () -> m_bResolvePseudoVersions = b);
}
/**
* @return the internal map. Never null. Must be locked properly.
*/
@Nonnull
@MustBeLocked (ELockType.DEPENDS)
protected final ICommonsMap > internalMap ()
{
return m_aMap;
}
public void registerValidationExecutorSet (@Nonnull final IValidationExecutorSet aVES)
{
ValueEnforcer.notNull (aVES, "VES");
final DVRCoordinate aKey = aVES.getID ();
m_aRWLock.writeLocked ( () -> {
if (m_aMap.containsKey (aKey))
throw new IllegalStateException ("Another validation executor set with the ID '" +
aKey.getAsSingleID () +
"' is already registered!");
m_aMap.put (aKey, aVES);
});
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Registered validation executor set '" +
aKey.getAsSingleID () +
"' of type " +
aVES.getClass ().getName () +
" with " +
aVES.getCount () +
" elements");
}
@Nonnull
public EChange unregisterValidationExecutorSet (@Nullable final DVRCoordinate aDVRCoordinate)
{
if (aDVRCoordinate == null)
return EChange.UNCHANGED;
final EChange ret = m_aRWLock.writeLockedGet ( () -> m_aMap.removeObject (aDVRCoordinate));
if (LOGGER.isDebugEnabled ())
LOGGER.debug ((ret.isChanged () ? "Successfully unregistered" : "Failed to unregister") +
" validation executor set '" +
aDVRCoordinate.getAsSingleID () +
"'");
return ret;
}
@Nonnull
@ReturnsMutableCopy
public ICommonsList > getAll ()
{
return m_aRWLock.readLockedGet (m_aMap::copyOfValues);
}
@Nonnull
@ReturnsMutableCopy
public ICommonsList > findAll (@Nonnull final Predicate > aFilter)
{
return m_aRWLock.readLockedGet ( () -> m_aMap.copyOfValues (aFilter));
}
@Nullable
public IValidationExecutorSet findFirst (@Nonnull final Predicate > aFilter)
{
return m_aRWLock.readLockedGet ( () -> m_aMap.findFirstValue (e -> aFilter.test (e.getValue ())));
}
@Nullable
private ICommonsNavigableMap > _getAllMatchingVES (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nonnull final Predicate aVersionsToAccept,
@Nullable final Comparator aComparator)
{
if (StringHelper.hasNoText (sGroupID))
return null;
if (StringHelper.hasNoText (sArtifactID))
return null;
// Sorted by key
final ICommonsNavigableMap > aMatching = new CommonsTreeMap <> (aComparator);
// Get all versions matching Group ID and Artifact ID only
m_aRWLock.readLocked ( () -> {
for (final Map.Entry > aEntry : m_aMap.entrySet ())
{
final DVRCoordinate aDVRCoordinate = aEntry.getKey ();
if (aDVRCoordinate.getGroupID ().equals (sGroupID) &&
aDVRCoordinate.getArtifactID ().equals (sArtifactID) &&
aVersionsToAccept.test (aDVRCoordinate.getVersionObj ()))
aMatching.put (aEntry);
}
});
return aMatching;
}
@Nullable
private IValidationExecutorSet _getOldestVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore,
final boolean bIncludeSnapshots)
{
// Sorted by key
final ICommonsNavigableMap > aMatching = _getAllMatchingVES (sGroupID,
sArtifactID,
DVRVersion.getStaticVersionAcceptor (aVersionsToIgnore,
bIncludeSnapshots),
Comparator.naturalOrder ());
if (aMatching != null && aMatching.isNotEmpty ())
{
// Now determine the one with the first version
final IValidationExecutorSet ret = aMatching.getFirstValue ();
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Resolved oldest version of '" +
sGroupID +
DVRCoordinate.PART_SEPARATOR +
sArtifactID +
"' to '" +
ret.getID ().getVersionString () +
"'");
return ret;
}
return null;
}
@Nullable
public IValidationExecutorSet getOldestVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore)
{
return _getOldestVersion (sGroupID, sArtifactID, aVersionsToIgnore, true);
}
@Nullable
public IValidationExecutorSet getOldestReleaseVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore)
{
return _getOldestVersion (sGroupID, sArtifactID, aVersionsToIgnore, false);
}
@Nullable
private IValidationExecutorSet _getLatestVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore,
final boolean bIncludeSnapshots)
{
// Sorted by key
final ICommonsNavigableMap > aMatching = _getAllMatchingVES (sGroupID,
sArtifactID,
DVRVersion.getStaticVersionAcceptor (aVersionsToIgnore,
bIncludeSnapshots),
Comparator.reverseOrder ());
if (aMatching != null && aMatching.isNotEmpty ())
{
// Now determine the one with the latest version
final IValidationExecutorSet ret = aMatching.getFirstValue ();
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Resolved latest version of '" +
sGroupID +
DVRCoordinate.PART_SEPARATOR +
sArtifactID +
"' to '" +
ret.getID ().getVersionString () +
"'");
return ret;
}
return null;
}
@Nullable
public IValidationExecutorSet getLatestVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore)
{
return _getLatestVersion (sGroupID, sArtifactID, aVersionsToIgnore, true);
}
@Nullable
public IValidationExecutorSet getLatestReleaseVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore)
{
return _getLatestVersion (sGroupID, sArtifactID, aVersionsToIgnore, false);
}
@Nullable
private IValidationExecutorSet _getLatestActiveVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore,
final boolean bIncludeSnapshots,
@Nullable final OffsetDateTime aCheckDateTime)
{
// Sorted by key
final ICommonsNavigableMap > aMatching = _getAllMatchingVES (sGroupID,
sArtifactID,
DVRVersion.getStaticVersionAcceptor (aVersionsToIgnore,
bIncludeSnapshots),
Comparator.reverseOrder ());
if (aMatching != null && aMatching.isNotEmpty ())
{
// Make sure we have a non-null check date time
final OffsetDateTime aRealCheckDateTime = aCheckDateTime != null ? aCheckDateTime : PDTFactory
.getCurrentOffsetDateTime ();
// Now determine the one with the latest active version
final IValidationExecutorSet ret = CollectionHelper.findFirst (aMatching.values (),
x -> x.getStatus ()
.isValidPer (aRealCheckDateTime));
if (ret != null)
{
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Resolved latest active version of '" +
sGroupID +
DVRCoordinate.PART_SEPARATOR +
sArtifactID +
"' to '" +
ret.getID ().getVersionString () +
"'");
return ret;
}
}
return null;
}
@Nullable
public IValidationExecutorSet getLatestActiveVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore,
@Nullable final OffsetDateTime aCheckDateTime)
{
return _getLatestActiveVersion (sGroupID, sArtifactID, aVersionsToIgnore, true, aCheckDateTime);
}
@Nullable
public IValidationExecutorSet getLatestReleaseActiveVersion (@Nullable final String sGroupID,
@Nullable final String sArtifactID,
@Nullable final Set aVersionsToIgnore,
@Nullable final OffsetDateTime aCheckDateTime)
{
return _getLatestActiveVersion (sGroupID, sArtifactID, aVersionsToIgnore, false, aCheckDateTime);
}
@Nullable
public IValidationExecutorSet getOfID (@Nullable final DVRCoordinate aDVRCoordinate)
{
return getOfID (aDVRCoordinate, (OffsetDateTime) null);
}
@Nullable
public IValidationExecutorSet getOfID (@Nullable final DVRCoordinate aDVRCoordinate,
@Nullable final OffsetDateTime aCheckDateTime)
{
if (aDVRCoordinate == null)
return null;
// Try exact match first
IValidationExecutorSet ret = m_aRWLock.readLockedGet ( () -> m_aMap.get (aDVRCoordinate));
// No exact match - check if it is a pseudo version
if (ret == null && aDVRCoordinate.getVersionObj ().isPseudoVersion ())
{
if (isResolvePseudoVersions ())
{
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Trying to resolve pseudo version latest of '" + aDVRCoordinate.getAsSingleID () + "'");
final IDVRPseudoVersion aPseudoVersion = aDVRCoordinate.getVersionObj ().getPseudoVersion ();
if (aPseudoVersion.equals (DVRPseudoVersionRegistry.OLDEST))
{
// Now determine the one with the oldest version
ret = getOldestVersion (aDVRCoordinate.getGroupID (), aDVRCoordinate.getArtifactID (), null);
}
else
if (aPseudoVersion.equals (DVRPseudoVersionRegistry.LATEST))
{
// Now determine the one with the latest version
ret = getLatestVersion (aDVRCoordinate.getGroupID (), aDVRCoordinate.getArtifactID (), null);
}
else
if (aPseudoVersion.equals (DVRPseudoVersionRegistry.LATEST_RELEASE))
{
// Now determine the one with the latest version
ret = getLatestReleaseVersion (aDVRCoordinate.getGroupID (), aDVRCoordinate.getArtifactID (), null);
}
else
if (aPseudoVersion.equals (PhivePseudoVersionRegistrarSPIImpl.LATEST_ACTIVE))
{
// Now determine the one with the latest active version
ret = getLatestActiveVersion (aDVRCoordinate.getGroupID (),
aDVRCoordinate.getArtifactID (),
null,
aCheckDateTime);
}
else
if (aPseudoVersion.equals (PhivePseudoVersionRegistrarSPIImpl.LATEST_RELEASE_ACTIVE))
{
// Now determine the one with the latest active version
ret = getLatestReleaseActiveVersion (aDVRCoordinate.getGroupID (),
aDVRCoordinate.getArtifactID (),
null,
aCheckDateTime);
}
else
LOGGER.warn ("The pseudo version " + aPseudoVersion + " is currently not supported.");
}
else
{
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("The pseudo version resolving is disabled.");
}
}
return ret;
}
/**
* This is a cleanup method that frees all resources when they are no longer
* needed. This may be helpful because some {@link IValidationExecutor}
* implementations contained in the {@link IValidationExecutorSet} contained
* in this registry might have strong references to {@link ClassLoader}
* instances. By calling this method, you can clear the contained map and
* invoke {@link ValidationExecutorSet#removeAllExecutors()} if applicable.
*
* @return {@link EChange}
* @see #removeAll(boolean)
*/
@Nonnull
public EChange removeAll ()
{
return removeAll (true);
}
/**
* This is a cleanup method that frees all resources when they are no longer
* needed. This removes all registered validators.
*
* @param bCleanVES
* This may be helpful because some {@link IValidationExecutor}
* implementations contained in the {@link IValidationExecutorSet}
* contained in this registry might have strong references to
* {@link ClassLoader} instances. By passing true,
* {@link ValidationExecutorSet#removeAllExecutors()} is invoked on all
* matching validation executor sets.
* @return {@link EChange}
* @since 6.0.1
*/
@Nonnull
public EChange removeAll (final boolean bCleanVES)
{
EChange ret = EChange.UNCHANGED;
m_aRWLock.writeLock ().lock ();
try
{
if (m_aMap.isNotEmpty ())
{
ret = EChange.CHANGED;
if (bCleanVES)
for (final IValidationExecutorSet aVES : m_aMap.values ())
if (aVES instanceof ValidationExecutorSet)
((ValidationExecutorSet ) aVES).removeAllExecutors ();
m_aMap.clear ();
}
}
finally
{
m_aRWLock.writeLock ().unlock ();
}
if (ret.isChanged ())
if (LOGGER.isDebugEnabled ())
LOGGER.debug ("Successfully removed all validatione executor sets" +
(bCleanVES ? " and cleaned all VES." : "."));
return ret;
}
@Override
public String toString ()
{
return new ToStringGenerator (this).append ("Map", m_aMap).getToString ();
}
}
