X-Git-Url: https://git.argeo.org/?a=blobdiff_plain;f=org.argeo.slc.repo%2Fsrc%2Forg%2Feclipse%2Faether%2Fcollection%2FDependencyManager.java;fp=org.argeo.slc.repo%2Fsrc%2Forg%2Feclipse%2Faether%2Fcollection%2FDependencyManager.java;h=e214f6610de66f6622aea607fb5a994603bc10d5;hb=825d60c5348dbe3f5be25b0bccf7bdebfe694219;hp=0000000000000000000000000000000000000000;hpb=5e991fff5cba01858dcc5747a27e637325bc5c8e;p=gpl%2Fargeo-jcr.git diff --git a/org.argeo.slc.repo/src/org/eclipse/aether/collection/DependencyManager.java b/org.argeo.slc.repo/src/org/eclipse/aether/collection/DependencyManager.java new file mode 100644 index 0000000..e214f66 --- /dev/null +++ b/org.argeo.slc.repo/src/org/eclipse/aether/collection/DependencyManager.java @@ -0,0 +1,48 @@ +/******************************************************************************* + * Copyright (c) 2010, 2014 Sonatype, Inc. + * All rights reserved. This program and the accompanying materials + * are made available under the terms of the Eclipse Public License v1.0 + * which accompanies this distribution, and is available at + * http://www.eclipse.org/legal/epl-v10.html + * + * Contributors: + * Sonatype, Inc. - initial API and implementation + *******************************************************************************/ +package org.eclipse.aether.collection; + +import org.eclipse.aether.graph.Dependency; + +/** + * Applies dependency management to the dependencies of a dependency node. + *

+ * Note: Implementations must be stateless. + *

+ * Warning: This hook is called from a hot spot and therefore implementations should pay attention to + * performance. Among others, implementations should provide a semantic {@link Object#equals(Object) equals()} method. + * + * @see org.eclipse.aether.RepositorySystemSession#getDependencyManager() + * @see org.eclipse.aether.RepositorySystem#collectDependencies(org.eclipse.aether.RepositorySystemSession, + * CollectRequest) + */ +public interface DependencyManager +{ + + /** + * Applies dependency management to the specified dependency. + * + * @param dependency The dependency to manage, must not be {@code null}. + * @return The management update to apply to the dependency or {@code null} if the dependency is not managed at all. + */ + DependencyManagement manageDependency( Dependency dependency ); + + /** + * Derives a dependency manager for the specified collection context. When calculating the child manager, + * implementors are strongly advised to simply return the current instance if nothing changed to help save memory. + * + * @param context The dependency collection context, must not be {@code null}. + * @return The dependency manager for the dependencies of the target node or {@code null} if dependency management + * should no longer be applied. + */ + DependencyManager deriveChildManager( DependencyCollectionContext context ); + +}