X-Git-Url: https://git.argeo.org/?a=blobdiff_plain;f=org.argeo.slc.repo%2Fsrc%2Forg%2Feclipse%2Faether%2Fresolution%2FVersionRangeResult.java;fp=org.argeo.slc.repo%2Fsrc%2Forg%2Feclipse%2Faether%2Fresolution%2FVersionRangeResult.java;h=fd233f1b20200023b7ad68d98f69b00ca5aa4a5b;hb=825d60c5348dbe3f5be25b0bccf7bdebfe694219;hp=0000000000000000000000000000000000000000;hpb=5e991fff5cba01858dcc5747a27e637325bc5c8e;p=gpl%2Fargeo-jcr.git diff --git a/org.argeo.slc.repo/src/org/eclipse/aether/resolution/VersionRangeResult.java b/org.argeo.slc.repo/src/org/eclipse/aether/resolution/VersionRangeResult.java new file mode 100644 index 0000000..fd233f1 --- /dev/null +++ b/org.argeo.slc.repo/src/org/eclipse/aether/resolution/VersionRangeResult.java @@ -0,0 +1,231 @@ +/******************************************************************************* + * Copyright (c) 2010, 2012 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.resolution; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.eclipse.aether.RepositorySystem; +import org.eclipse.aether.RepositorySystemSession; +import org.eclipse.aether.repository.ArtifactRepository; +import org.eclipse.aether.version.Version; +import org.eclipse.aether.version.VersionConstraint; + +/** + * The result of a version range resolution request. + * + * @see RepositorySystem#resolveVersionRange(RepositorySystemSession, VersionRangeRequest) + */ +public final class VersionRangeResult +{ + + private final VersionRangeRequest request; + + private List exceptions; + + private List versions; + + private Map repositories; + + private VersionConstraint versionConstraint; + + /** + * Creates a new result for the specified request. + * + * @param request The resolution request, must not be {@code null}. + */ + public VersionRangeResult( VersionRangeRequest request ) + { + if ( request == null ) + { + throw new IllegalArgumentException( "version range request has not been specified" ); + } + this.request = request; + exceptions = Collections.emptyList(); + versions = Collections.emptyList(); + repositories = Collections.emptyMap(); + } + + /** + * Gets the resolution request that was made. + * + * @return The resolution request, never {@code null}. + */ + public VersionRangeRequest getRequest() + { + return request; + } + + /** + * Gets the exceptions that occurred while resolving the version range. + * + * @return The exceptions that occurred, never {@code null}. + */ + public List getExceptions() + { + return exceptions; + } + + /** + * Records the specified exception while resolving the version range. + * + * @param exception The exception to record, may be {@code null}. + * @return This result for chaining, never {@code null}. + */ + public VersionRangeResult addException( Exception exception ) + { + if ( exception != null ) + { + if ( exceptions.isEmpty() ) + { + exceptions = new ArrayList(); + } + exceptions.add( exception ); + } + return this; + } + + /** + * Gets the versions (in ascending order) that matched the requested range. + * + * @return The matching versions (if any), never {@code null}. + */ + public List getVersions() + { + return versions; + } + + /** + * Adds the specified version to the result. Note that versions must be added in ascending order. + * + * @param version The version to add, must not be {@code null}. + * @return This result for chaining, never {@code null}. + */ + public VersionRangeResult addVersion( Version version ) + { + if ( versions.isEmpty() ) + { + versions = new ArrayList(); + } + versions.add( version ); + return this; + } + + /** + * Sets the versions (in ascending order) matching the requested range. + * + * @param versions The matching versions, may be empty or {@code null} if none. + * @return This result for chaining, never {@code null}. + */ + public VersionRangeResult setVersions( List versions ) + { + if ( versions == null ) + { + this.versions = Collections.emptyList(); + } + else + { + this.versions = versions; + } + return this; + } + + /** + * Gets the lowest version matching the requested range. + * + * @return The lowest matching version or {@code null} if no versions matched the requested range. + */ + public Version getLowestVersion() + { + if ( versions.isEmpty() ) + { + return null; + } + return versions.get( 0 ); + } + + /** + * Gets the highest version matching the requested range. + * + * @return The highest matching version or {@code null} if no versions matched the requested range. + */ + public Version getHighestVersion() + { + if ( versions.isEmpty() ) + { + return null; + } + return versions.get( versions.size() - 1 ); + } + + /** + * Gets the repository from which the specified version was resolved. + * + * @param version The version whose source repository should be retrieved, must not be {@code null}. + * @return The repository from which the version was resolved or {@code null} if unknown. + */ + public ArtifactRepository getRepository( Version version ) + { + return repositories.get( version ); + } + + /** + * Records the repository from which the specified version was resolved + * + * @param version The version whose source repository is to be recorded, must not be {@code null}. + * @param repository The repository from which the version was resolved, may be {@code null}. + * @return This result for chaining, never {@code null}. + */ + public VersionRangeResult setRepository( Version version, ArtifactRepository repository ) + { + if ( repository != null ) + { + if ( repositories.isEmpty() ) + { + repositories = new HashMap(); + } + repositories.put( version, repository ); + } + return this; + } + + /** + * Gets the version constraint that was parsed from the artifact's version string. + * + * @return The parsed version constraint or {@code null}. + */ + public VersionConstraint getVersionConstraint() + { + return versionConstraint; + } + + /** + * Sets the version constraint that was parsed from the artifact's version string. + * + * @param versionConstraint The parsed version constraint, may be {@code null}. + * @return This result for chaining, never {@code null}. + */ + public VersionRangeResult setVersionConstraint( VersionConstraint versionConstraint ) + { + this.versionConstraint = versionConstraint; + return this; + } + + @Override + public String toString() + { + return String.valueOf( repositories ); + } + +}