getConfigProperties();
/**
* Gets the mirror selector to use for repositories discovered in artifact descriptors. Note that this selector is
* not used for remote repositories which are passed as request parameters to the repository system, those
* repositories are supposed to denote the effective repositories.
*
* @return The mirror selector to use, never {@code null}.
*/
MirrorSelector getMirrorSelector();
/**
* Gets the proxy selector to use for repositories discovered in artifact descriptors. Note that this selector is
* not used for remote repositories which are passed as request parameters to the repository system, those
* repositories are supposed to have their proxy (if any) already set.
*
* @return The proxy selector to use, never {@code null}.
* @see org.sonatype.aether.repository.RemoteRepository#getProxy()
*/
ProxySelector getProxySelector();
/**
* Gets the authentication selector to use for repositories discovered in artifact descriptors. Note that this
* selector is not used for remote repositories which are passed as request parameters to the repository system,
* those repositories are supposed to have their authentication (if any) already set.
*
* @return The authentication selector to use, never {@code null}.
* @see org.sonatype.aether.repository.RemoteRepository#getAuthentication()
*/
AuthenticationSelector getAuthenticationSelector();
/**
* Gets the registry of artifact types recognized by this session.
*
* @return The artifact type registry, never {@code null}.
*/
ArtifactTypeRegistry getArtifactTypeRegistry();
/**
* Gets the dependency traverser to use for building dependency graphs.
*
* @return The dependency traverser to use for building dependency graphs, never {@code null}.
*/
DependencyTraverser getDependencyTraverser();
/**
* Gets the dependency manager to use for building dependency graphs.
*
* @return The dependency manager to use for building dependency graphs, never {@code null}.
*/
DependencyManager getDependencyManager();
/**
* Gets the dependency selector to use for building dependency graphs.
*
* @return The dependency selector to use for building dependency graphs, never {@code null}.
*/
DependencySelector getDependencySelector();
/**
* Gets the dependency graph transformer to use for building dependency graphs.
*
* @return The dependency graph transformer to use for building dependency graphs, never {@code null}.
*/
DependencyGraphTransformer getDependencyGraphTransformer();
/**
* Gets the custom data associated with this session.
*
* @return The session data, never {@code null}.
*/
SessionData getData();
/**
* Gets the cache the repository system may use to save data for future reuse during the session.
*
* @return The repository cache or {@code null} if none.
*/
RepositoryCache getCache();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/RequestTrace.java 0000664 0000000 0000000 00000003635 11670505567 0026716 0 ustar 00root root 0000000 0000000 package org.sonatype.aether;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A trace of nested requests that are performed by the repository system. This trace information can be used to
* correlate repository events with higher level operations in the application code that eventually caused the events. A
* single trace can carry an arbitrary object as data which is meant to describe a request/operation that is currently
* executed. For call hierarchies within the repository system itself, this data will usually be the {@code *Request}
* object that is currently processed. When invoking methods on the repository system, client code may provide a request
* trace that has been prepopulated with whatever data is useful for the application to indicate its state for later
* evaluation when processing the repository events.
*
* @author Benjamin Bentmann
* @see RepositoryEvent#getTrace()
*/
public interface RequestTrace
{
/**
* Gets the data associated with this trace.
*
* @return The data associated with this trace or {@code null}.
*/
Object getData();
/**
* Gets the parent of this trace.
*
* @return The parent of this trace or {@code null} if this is the root of the trace stack.
*/
RequestTrace getParent();
/**
* Creates a new child of this trace.
*
* @param data The data to associate with the child, may be {@code null}.
* @return The child trace, never {@code null}.
*/
RequestTrace newChild( Object data );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/SessionData.java 0000664 0000000 0000000 00000004661 11670505567 0026524 0 ustar 00root root 0000000 0000000 package org.sonatype.aether;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A container for data that is specific to a repository system session. Both components within the repository system
* and clients of the system may use this storage to associate arbitrary data with a session. Unlike a cache, this
* session data is not subject to purging. For this same reason, session data should also not be abused as a cache (i.e.
* for storing values that can be re-calculated) to avoid memory exhaustion. Note: Actual
* implementations must be thread-safe.
*
* @author Benjamin Bentmann
* @see RepositorySystemSession#getData()
*/
public interface SessionData
{
/**
* Associates the specified session data with the given key.
*
* @param key The key under which to store the session data, must not be {@code null}.
* @param value The data to associate with the key, may be {@code null} to remove the mapping.
*/
void set( Object key, Object value );
/**
* Associates the specified session data with the given key if the key is currently mapped to the given value. This
* method provides an atomic compare-and-update of some key's value.
*
* @param key The key under which to store the session data, must not be {@code null}.
* @param oldValue The expected data currently associated with the key, may be {@code null}.
* @param newValue The data to associate with the key, may be {@code null} to remove the mapping.
* @return {@code true} if the key mapping was updated to the specified value, {@code false} if the current key
* mapping didn't match the expected value and was not updated.
*/
boolean set( Object key, Object oldValue, Object newValue );
/**
* Gets the session data associated with the specified key.
*
* @param key The key for which to retrieve the session data, must not be {@code null}.
* @return The session data associated with the key or {@code null} if none.
*/
Object get( Object key );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/SyncContext.java 0000664 0000000 0000000 00000005322 11670505567 0026563 0 ustar 00root root 0000000 0000000 package org.sonatype.aether;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
/**
* A synchronization context used to coordinate concurrent access to artifacts or metadatas. The typical usage of a
* synchronization context looks like this:
*
*
* SyncContext syncContext = repositorySystem.newSyncContext( ... );
* try {
* syncContext.acquire( artifacts, metadatas );
* // work with the artifacts and metadatas
* } finally {
* syncContext.release();
* }
*
*
* Within one thread, synchronization contexts may be nested which can naturally happen in a hierarchy of method calls.
* The nested synchronization contexts may also acquire overlapping sets of artifacts/metadatas as long as the following
* conditions are met. If the outer-most context holding a particular resource is exclusive, that resource can be
* reacquired in any nested context. If however the outer-most context is shared, the resource may only be reacquired by
* nested contexts if these are also shared.
*
* A synchronization context is meant to be utilized by only one thread and as such is not thread-safe.
*
* Note that the level of actual synchronization is subject to the implementation and might range from OS-wide to none.
*/
public interface SyncContext
{
/**
* Acquires synchronized access to the specified artifacts and metadatas. The invocation will potentially block
* until all requested resources can be acquired by the calling thread. Acquiring resources that are already
* acquired by this synchronization context has no effect. Please also see the class-level documentation for
* information regarding reentrancy.
*
* @param artifacts The artifacts to acquire, may be {@code null} or empty if none.
* @param metadatas The metadatas to acquire, may be {@code null} or empty if none.
*/
void acquire( Collection artifacts, Collection metadatas );
/**
* Releases all previously acquired artifacts/metadatas. If no resources have been acquired before, this method does
* nothing. This synchronization context may be reused to acquire other resources in the future.
*/
void release();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/artifact/ 0000775 0000000 0000000 00000000000 11670505567 0025232 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/artifact/Artifact.java 0000664 0000000 0000000 00000011525 11670505567 0027636 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.artifact;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import java.util.Map;
/**
* A specific artifact. Note: Artifact instances are supposed to be immutable, e.g. any exposed mutator method
* returns a new artifact instance and leaves the original instance unchanged. Implementors are strongly advised to obey
* this contract.
*
* @author Benjamin Bentmann
*/
public interface Artifact
{
/**
* Gets the group identifier of this artifact, for example "org.apache.maven".
*
* @return The group identifier, never {@code null}.
*/
String getGroupId();
/**
* Gets the artifact identifier of this artifact, for example "maven-model".
*
* @return The artifact identifier, never {@code null}.
*/
String getArtifactId();
/**
* Gets the version of this artifact, for example "1.0-20100529-1213". Note that in case of meta versions like
* "1.0-SNAPSHOT", the artifact's version depends on the state of the artifact. Artifacts that have been resolved or
* deployed will have the meta version expanded.
*
* @return The version, never {@code null}.
*/
String getVersion();
/**
* Sets the version of this artifact.
*
* @param version The version of this artifact, may be {@code null} or empty.
* @return The new artifact, never {@code null}.
*/
Artifact setVersion( String version );
/**
* Gets the base version of this artifact, for example "1.0-SNAPSHOT". In contrast to the {@link #getVersion()}, the
* base version will always refer to the unresolved meta version.
*
* @return The base version, never {@code null}.
*/
String getBaseVersion();
/**
* Determines whether this artifact uses a snapshot version.
*
* @return {@code true} if the artifact is a snapshot, {@code false} otherwise.
*/
boolean isSnapshot();
/**
* Gets the classifier of this artifact, for example "sources".
*
* @return The classifier or an empty string if none, never {@code null}.
*/
String getClassifier();
/**
* Gets the (file) extension of this artifact, for example "jar".
*
* @return The file extension, never {@code null}.
*/
String getExtension();
/**
* Gets the file of this artifact. Note that only resolved artifacts have a file associated with them.
*
* @return The file or {@code null} if the artifact isn't resolved.
*/
File getFile();
/**
* Sets the file of the artifact.
*
* @param file The file of the artifact, may be {@code null}
* @return The new artifact, never {@code null}.
*/
Artifact setFile( File file );
/**
* Gets the specified property.
*
* @param key The name of the property, must not be {@code null}.
* @param defaultValue The default value to return in case the property is not set, may be {@code null}.
*/
String getProperty( String key, String defaultValue );
/**
* Gets the properties of this artifact. While the exact set of available properties is undefined, the following
* properties are considered to be common:
*
* - type
* - A high-level characterization of the artifact, e.g. "maven-plugin" or "test-jar".
* - language
* - The programming language this artifact is relevant for, e.g. "java" or "none".
* - includesDependencies
* - A boolean flag indicating whether the artifact presents some kind of bundle that physically includes its
* dependencies, e.g. a fat WAR.
* - constitutesBuildPath
* - A boolean flag indicating whether the artifact is meant to be used for the compile/runtime/test build path of
* a consumer project.
* - localPath
* - The (expected) path to the artifact on the local filesystem. An artifact which has this property set is
* assumed to be not present in any regular repository and likewise has no artifact descriptor.
*
*
* @return The (read-only) properties, never {@code null}.
*/
Map getProperties();
/**
* Sets the properties for the artifact.
*
* @param properties The properties for the artifact, may be {@code null}.
* @return The new artifact, never {@code null}.
*/
Artifact setProperties( Map properties );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/artifact/ArtifactType.java 0000664 0000000 0000000 00000003276 11670505567 0030504 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.artifact;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Map;
/**
* An artifact type describing artifact characteristics that are common for certain artifacts. Artifact types are a
* means to simplify the description of an artifact by referring to an artifact type instead of specifying the various
* properties individually.
*
* @author Benjamin Bentmann
*/
public interface ArtifactType
{
/**
* Gets the identifier of this type, e.g. "maven-plugin" or "test-jar".
*
* @return The identifier of this type, never {@code null}.
*/
String getId();
/**
* Gets the file extension to use for artifacts of this type (unless explicitly overridden by the artifact).
*
* @return The file extension, never {@code null}.
*/
String getExtension();
/**
* Gets the classifier to use for artifacts of this type (unless explicitly overridden by the artifact).
*
* @return The classifier or an empty string if none, never {@code null}.
*/
String getClassifier();
/**
* Gets the properties to use for artifacts of this type (unless explicitly overridden by the artifact).
*
* @return The properties, never {@code null}.
*/
Map getProperties();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/artifact/ArtifactTypeRegistry.java 0000664 0000000 0000000 00000001622 11670505567 0032226 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.artifact;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A registry of known artifact types.
*
* @author Benjamin Bentmann
*/
public interface ArtifactTypeRegistry
{
/**
* Gets the artifact type with the specified identifier.
*
* @param typeId The identifier of the type, must not be {@code null}.
* @return The artifact type or {@code null} if no type with the requested identifier exists.
*/
ArtifactType get( String typeId );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/ 0000775 0000000 0000000 00000000000 11670505567 0025570 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/CollectRequest.java 0000664 0000000 0000000 00000024066 11670505567 0031401 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.graph.Dependency;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to collect the transitive dependencies and to build a dependency graph from them. There are three ways to
* create a dependency graph. First, only the root dependency can be given. Second, a root dependency and direct
* dependencies can be specified in which case the specified direct dependencies are merged with the direct dependencies
* retrieved from the artifact descriptor of the root dependency. And last, only direct dependencies can be specified in
* which case the root node of the resulting graph has no associated dependency.
*
* @author Benjamin Bentmann
* @see RepositorySystem#collectDependencies(RepositorySystemSession, CollectRequest)
*/
public class CollectRequest
{
private Dependency root;
private List dependencies = Collections.emptyList();
private List managedDependencies = Collections.emptyList();
private List repositories = Collections.emptyList();
private String context = "";
private RequestTrace trace;
/**
* Creates an unitialized request.
*/
public CollectRequest()
{
// enables default constructor
}
/**
* Creates a request with the specified properties.
*
* @param root The root dependency whose transitive dependencies should be collected, may be {@code null}.
* @param repositories The repositories to use for the collection, may be {@code null}.
*/
public CollectRequest( Dependency root, List repositories )
{
setRoot( root );
setRepositories( repositories );
}
/**
* Creates a new request with the specified properties.
*
* @param root The root dependency whose transitive dependencies should be collected, may be {@code null}.
* @param dependencies The direct dependencies to merge with the direct dependencies from the root dependency's
* artifact descriptor.
* @param repositories The repositories to use for the collection, may be {@code null}.
*/
public CollectRequest( Dependency root, List dependencies, List repositories )
{
setRoot( root );
setDependencies( dependencies );
setRepositories( repositories );
}
/**
* Creates a new request with the specified properties.
*
* @param dependencies The direct dependencies of some imaginary root, may be {@code null}.
* @param managedDependencies The dependency management information to apply to the transitive dependencies, may be
* {@code null}.
* @param repositories The repositories to use for the collection, may be {@code null}.
*/
public CollectRequest( List dependencies, List managedDependencies,
List repositories )
{
setDependencies( dependencies );
setManagedDependencies( managedDependencies );
setRepositories( repositories );
}
/**
* Gets the root dependency of the graph.
*
* @return The root dependency of the graph or {@code null} if none.
*/
public Dependency getRoot()
{
return root;
}
/**
* Sets the root dependency of the graph.
*
* @param root The root dependency of the graph, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setRoot( Dependency root )
{
this.root = root;
return this;
}
/**
* Gets the direct dependencies.
*
* @return The direct dependencies, never {@code null}.
*/
public List getDependencies()
{
return dependencies;
}
/**
* Sets the direct dependencies. If both a root dependency and direct dependencies are given in the request, the
* direct dependencies from the request will be merged with the direct dependencies from the root dependency's
* artifact descriptor, giving higher priority to the dependencies from the request.
*
* @param dependencies The direct dependencies, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setDependencies( List dependencies )
{
if ( dependencies == null )
{
this.dependencies = Collections.emptyList();
}
else
{
this.dependencies = dependencies;
}
return this;
}
/**
* Adds the specified direct dependency.
*
* @param dependency The dependency to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest addDependency( Dependency dependency )
{
if ( dependency != null )
{
if ( this.dependencies.isEmpty() )
{
this.dependencies = new ArrayList();
}
this.dependencies.add( dependency );
}
return this;
}
/**
* Gets the dependency management to apply to transitive dependencies.
*
* @return The dependency management to apply to transitive dependencies, never {@code null}.
*/
public List getManagedDependencies()
{
return managedDependencies;
}
/**
* Sets the dependency management to apply to transitive dependencies. To clarify, this management does not apply to
* the direct dependencies of the root node.
*
* @param managedDependencies The dependency management, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setManagedDependencies( List managedDependencies )
{
if ( managedDependencies == null )
{
this.managedDependencies = Collections.emptyList();
}
else
{
this.managedDependencies = managedDependencies;
}
return this;
}
/**
* Adds the specified managed dependency.
*
* @param managedDependency The managed dependency to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest addManagedDependency( Dependency managedDependency )
{
if ( managedDependency != null )
{
if ( this.managedDependencies.isEmpty() )
{
this.managedDependencies = new ArrayList();
}
this.managedDependencies.add( managedDependency );
}
return this;
}
/**
* Gets the repositories to use for the collection.
*
* @return The repositories to use for the collection, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the repositories to use for the collection.
*
* @param repositories The repositories to use for the collection, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = Collections.emptyList();
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified repository for collection.
*
* @param repository The repository to collect dependency information from, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest addRepository( RemoteRepository repository )
{
if ( repository != null )
{
if ( this.repositories.isEmpty() )
{
this.repositories = new ArrayList();
}
this.repositories.add( repository );
}
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public CollectRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getRoot() + " -> " + getDependencies() + " < " + getRepositories();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/CollectResult.java 0000664 0000000 0000000 00000005722 11670505567 0031225 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.graph.DependencyNode;
/**
* The result of a dependency collection request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#collectDependencies(RepositorySystemSession, CollectRequest)
*/
public class CollectResult
{
private final CollectRequest request;
private final List exceptions;
private DependencyNode root;
/**
* Creates a new result for the specified request.
*
* @param request The resolution request, must not be {@code null}.
*/
public CollectResult( CollectRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "dependency collection request has not been specified" );
}
this.request = request;
this.exceptions = new ArrayList( 4 );
}
/**
* Gets the collection request that was made.
*
* @return The collection request, never {@code null}.
*/
public CollectRequest getRequest()
{
return request;
}
/**
* Gets the exceptions that occurred while building the dependency graph.
*
* @return The exceptions that occurred, never {@code null}.
*/
public List getExceptions()
{
return exceptions;
}
/**
* Records the specified exception while building the dependency graph.
*
* @param exception The exception to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public CollectResult addException( Exception exception )
{
if ( exception != null )
{
this.exceptions.add( exception );
}
return this;
}
/**
* Gets the root node of the dependency graph.
*
* @return The root node of the dependency graph or {@code null} if none.
*/
public DependencyNode getRoot()
{
return root;
}
/**
* Sets the root node of the dependency graph.
*
* @param root The root node of the dependency graph, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public CollectResult setRoot( DependencyNode root )
{
this.root = root;
return this;
}
@Override
public String toString()
{
return String.valueOf( getRoot() );
}
}
DependencyCollectionContext.java 0000664 0000000 0000000 00000003463 11670505567 0034021 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.List;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.graph.Dependency;
/**
* A context used during dependency collection to update the dependency manager, selector and traverser.
*
* @author Benjamin Bentmann
* @see DependencyManager#deriveChildManager(DependencyCollectionContext)
* @see DependencyTraverser#deriveChildTraverser(DependencyCollectionContext)
* @see DependencySelector#deriveChildSelector(DependencyCollectionContext)
*/
public interface DependencyCollectionContext
{
/**
* Gets the repository system session during which the dependency collection happens.
*
* @return The repository system session, never {@code null}.
*/
RepositorySystemSession getSession();
/**
* Gets the dependency whose children are to be processed next during dependency collection.
*
* @return The dependency whose children are going to be processed or {@code null} in case of the root node without
* dependency.
*/
Dependency getDependency();
/**
* Gets the dependency management information that was contributed by the artifact descriptor of the current
* dependency.
*
* @return The dependency management information, never {@code null}.
*/
List getManagedDependencies();
}
DependencyCollectionException.java 0000664 0000000 0000000 00000003334 11670505567 0034330 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of bad artifact descriptors, version ranges or other issues encountered during calculation of the
* dependency graph.
*
* @author Benjamin Bentmann
*/
public class DependencyCollectionException
extends RepositoryException
{
private final CollectResult result;
public DependencyCollectionException( CollectResult result )
{
super( "Failed to collect dependencies for " + getSource( result ), getCause( result ) );
this.result = result;
}
public CollectResult getResult()
{
return result;
}
private static String getSource( CollectResult result )
{
if ( result == null )
{
return "";
}
CollectRequest request = result.getRequest();
if ( request.getRoot() != null )
{
return request.getRoot().toString();
}
return request.getDependencies().toString();
}
private static Throwable getCause( CollectResult result )
{
Throwable cause = null;
if ( result != null && !result.getExceptions().isEmpty() )
{
cause = result.getExceptions().get( 0 );
}
return cause;
}
}
DependencyGraphTransformationContext.java 0000664 0000000 0000000 00000003071 11670505567 0035711 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystemSession;
/**
* A context used during dependency collection to exchange information within a chain of dependency graph transformers.
*
* @author Benjamin Bentmann
* @see DependencyGraphTransformer
*/
public interface DependencyGraphTransformationContext
{
/**
* Gets the repository system session during which the graph transformation happens.
*
* @return The repository system session, never {@code null}.
*/
RepositorySystemSession getSession();
/**
* Gets a keyed value from the context.
*
* @param key The key used to query the value, must not be {@code null}.
* @return The queried value or {@code null} if none.
*/
Object get( Object key );
/**
* Puts a keyed value into the context.
*
* @param key The key used to store the value, must not be {@code null}.
* @param value The value to store, may be {@code null}.
* @return The previous value associated with the key or {@code null} if none.
*/
Object put( Object key, Object value );
}
DependencyGraphTransformer.java 0000664 0000000 0000000 00000003135 11670505567 0033641 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.graph.DependencyNode;
/**
* Transforms a given dependency graph. Note: Dependency graphs may contain cycles, as such a graph transformer
* needs to gracefully handle cyclic graphs, e.g. guard against infinite recursion.
*
* @author Benjamin Bentmann
* @see org.sonatype.aether.RepositorySystemSession#getDependencyGraphTransformer()
*/
public interface DependencyGraphTransformer
{
/**
* Transforms the dependency graph denoted by the specified root node. The transformer may directly change the
* provided input graph or create a new graph.
*
* @param node The root node of the (possibly cyclic!) graph to transform, must not be {@code null}.
* @param context The graph transformation context, must not be {@code null}.
* @return The result graph of the transformation, never {@code null}.
* @throws RepositoryException If the transformation failed.
*/
DependencyNode transformGraph( DependencyNode node, DependencyGraphTransformationContext context )
throws RepositoryException;
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/DependencyManagement.java 0000664 0000000 0000000 00000011364 11670505567 0032513 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import java.util.Map;
import org.sonatype.aether.graph.Dependency;
import org.sonatype.aether.graph.Exclusion;
/**
* The management updates to apply to a dependency.
*
* @author Benjamin Bentmann
* @see DependencyManager#manageDependency(Dependency)
*/
public class DependencyManagement
{
private String version;
private String scope;
private Collection exclusions;
private Map properties;
/**
* Creates an empty management update.
*/
public DependencyManagement()
{
// enables default constructor
}
/**
* Gets the new version to apply to the dependency.
*
* @return The new version or {@code null} if the version is not managed and the existing dependency version should
* remain unchanged.
*/
public String getVersion()
{
return version;
}
/**
* Sets the new version to apply to the dependency.
*
* @param version The new version, may be {@code null} if the version is not managed.
* @return This management update for chaining, never {@code null}.
*/
public DependencyManagement setVersion( String version )
{
this.version = version;
return this;
}
/**
* Gets the new scope to apply to the dependency.
*
* @return The new scope or {@code null} if the scope is not managed and the existing dependency scope should remain
* unchanged.
*/
public String getScope()
{
return scope;
}
/**
* Sets the new scope to apply to the dependency.
*
* @param scope The new scope, may be {@code null} if the scope is not managed.
* @return This management update for chaining, never {@code null}.
*/
public DependencyManagement setScope( String scope )
{
this.scope = scope;
return this;
}
/**
* Gets the new exclusions to apply to the dependency. Note that this collection denotes the complete set of
* exclusions for the dependency, i.e. the dependency manager controls whether any existing exclusions get merged
* with information from dependency management or overridden by it.
*
* @return The new exclusions or {@code null} if the exclusions are not managed and the existing dependency
* exclusions should remain unchanged.
*/
public Collection getExclusions()
{
return exclusions;
}
/**
* Sets the new exclusions to apply to the dependency. Note that this collection denotes the complete set of
* exclusions for the dependency, i.e. the dependency manager controls whether any existing exclusions get merged
* with information from dependency management or overridden by it.
*
* @param exclusions The new exclusions, may be {@code null} if the exclusions are not managed.
* @return This management update for chaining, never {@code null}.
*/
public DependencyManagement setExclusions( Collection exclusions )
{
this.exclusions = exclusions;
return this;
}
/**
* Gets the new properties to apply to the dependency. Note that this map denotes the complete set of properties,
* i.e. the dependency manager controls whether any existing properties get merged with the information from
* dependency management or overridden by it.
*
* @return The new artifact properties or {@code null} if the properties are not managed and the existing properties
* should remain unchanged.
*/
public Map getProperties()
{
return properties;
}
/**
* Sets the new properties to apply to the dependency. Note that this map denotes the complete set of properties,
* i.e. the dependency manager controls whether any existing properties get merged with the information from
* dependency management or overridden by it.
*
* @param properties The new artifact properties, may be {@code null} if the properties are not managed.
* @return This management update for chaining, never {@code null}.
*/
public DependencyManagement setProperties( Map properties )
{
this.properties = properties;
return this;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/DependencyManager.java 0000664 0000000 0000000 00000003647 11670505567 0032016 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.graph.Dependency;
/**
* Applies dependency management to the dependencies of a dependency node. Note: For the sake of good
* performance during dependency collection, implementations should provide a semantic {@link Object#equals(Object)
* equals()} method.
*
* @author Benjamin Bentmann
* @see org.sonatype.aether.RepositorySystemSession#getDependencyManager()
* @see org.sonatype.aether.RepositorySystem#collectDependencies(org.sonatype.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, must not be {@code null}.
*/
DependencyManager deriveChildManager( DependencyCollectionContext context );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/DependencySelector.java 0000664 0000000 0000000 00000003612 11670505567 0032214 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.graph.Dependency;
/**
* Decides what dependencies to include in the dependency graph. Note: For the sake of good performance during
* dependency collection, implementations should provide a semantic {@link Object#equals(Object) equals()} method.
*
* @author Benjamin Bentmann
* @see org.sonatype.aether.RepositorySystemSession#getDependencySelector()
* @see org.sonatype.aether.RepositorySystem#collectDependencies(org.sonatype.aether.RepositorySystemSession,
* CollectRequest)
*/
public interface DependencySelector
{
/**
* Applies exclusions to the specified dependency.
*
* @param dependency The dependency to filter, must not be {@code null}.
* @return {@code false} if the dependency should be excluded from the children of the current node, {@code true}
* otherwise.
*/
boolean selectDependency( Dependency dependency );
/**
* Derives a dependency selector for the specified collection context. When calculating the child selector,
* 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 filter for the target node, must not be {@code null}.
*/
DependencySelector deriveChildSelector( DependencyCollectionContext context );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection/DependencyTraverser.java 0000664 0000000 0000000 00000004124 11670505567 0032410 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.graph.Dependency;
/**
* Decides whether the dependencies of a dependency node should be traversed as well. Note: For the sake of
* good performance during dependency collection, implementations should provide a semantic
* {@link Object#equals(Object) equals()} method.
*
* @author Benjamin Bentmann
* @see org.sonatype.aether.RepositorySystemSession#getDependencyTraverser()
* @see org.sonatype.aether.RepositorySystem#collectDependencies(org.sonatype.aether.RepositorySystemSession,
* CollectRequest)
*/
public interface DependencyTraverser
{
/**
* Decides whether the dependencies of the specified dependency should be traversed.
*
* @param dependency The dependency to check, must not be {@code null}.
* @return {@code true} if the dependency graph builder should recurse into the specified dependency and process its
* dependencies, {@code false} otherwise.
*/
boolean traverseDependency( Dependency dependency );
/**
* Derives a dependency traverser that will be used to decide whether the transitive dependencies of the dependency
* given in the collection context shall be traversed. When calculating the child traverser, 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 traverser for the target node, must not be {@code null}.
*/
DependencyTraverser deriveChildTraverser( DependencyCollectionContext context );
}
UnsolvableVersionConflictException.java 0000664 0000000 0000000 00000012327 11670505567 0035402 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/collection package org.sonatype.aether.collection;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.List;
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.graph.DependencyNode;
import org.sonatype.aether.version.VersionConstraint;
/**
* Thrown in case of an unsolvable conflict between different version constraints for a dependency.
*
* @author Benjamin Bentmann
*/
public class UnsolvableVersionConflictException
extends RepositoryException
{
private final Object dependencyConflictId;
private final Collection versions;
private final Collection> paths;
public UnsolvableVersionConflictException( Object dependencyConflictId, Collection versions )
{
super( "Could not resolve version conflict for " + dependencyConflictId + " with requested versions "
+ toList( versions ) );
this.dependencyConflictId = ( dependencyConflictId != null ) ? dependencyConflictId : "";
this.versions = ( versions != null ) ? versions : Collections. emptyList();
this.paths = Collections.emptyList();
}
private static String toList( Collection versions )
{
StringBuilder buffer = new StringBuilder( 256 );
if ( versions != null )
{
for ( String version : versions )
{
if ( buffer.length() > 0 )
{
buffer.append( ", " );
}
buffer.append( version );
}
}
return buffer.toString();
}
public UnsolvableVersionConflictException( Collection> paths, Object dependencyConflictId )
{
super( "Could not resolve version conflict among " + toPaths( paths ) );
this.dependencyConflictId = ( dependencyConflictId != null ) ? dependencyConflictId : "";
if ( paths == null )
{
this.paths = Collections.emptyList();
this.versions = Collections.emptyList();
}
else
{
this.paths = paths;
this.versions = new LinkedHashSet();
for ( List path : paths )
{
VersionConstraint constraint = path.get( path.size() - 1 ).getVersionConstraint();
if ( constraint != null && !constraint.getRanges().isEmpty() )
{
versions.add( constraint.toString() );
}
}
}
}
private static String toPaths( Collection> paths )
{
String result = "";
if ( paths != null )
{
Collection strings = new LinkedHashSet();
for ( List path : paths )
{
strings.add( toPath( path ) );
}
result = strings.toString();
}
return result;
}
private static String toPath( List path )
{
StringBuilder buffer = new StringBuilder( 256 );
for ( Iterator it = path.iterator(); it.hasNext(); )
{
DependencyNode node = it.next();
if ( node.getDependency() == null )
{
continue;
}
Artifact artifact = node.getDependency().getArtifact();
buffer.append( artifact.getGroupId() );
buffer.append( ':' ).append( artifact.getArtifactId() );
buffer.append( ':' ).append( artifact.getExtension() );
if ( artifact.getClassifier().length() > 0 )
{
buffer.append( ':' ).append( artifact.getClassifier() );
}
buffer.append( ':' ).append( node.getVersionConstraint() );
if ( it.hasNext() )
{
buffer.append( " -> " );
}
}
return buffer.toString();
}
/**
* Gets the conflict id of the dependency that encountered the version conflict.
*
* @return The conflict id, never {@code null}.
*/
public Object getDependencyConflictId()
{
return dependencyConflictId;
}
/**
* Gets the paths leading to the conflicting dependencies.
*
* @return The (read-only) paths leading to the conflicting dependencies, never {@code null}.
*/
public Collection> getPaths()
{
return paths;
}
/**
* Gets the conflicting version constraints of the dependency.
*
* @return The (read-only) conflicting version constraints, never {@code null}.
*/
public Collection getVersions()
{
return versions;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/deployment/ 0000775 0000000 0000000 00000000000 11670505567 0025615 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/deployment/DeployRequest.java 0000664 0000000 0000000 00000011375 11670505567 0031274 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.deployment;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collection;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to deploy artifacts and their accompanying metadata into the a remote repository.
*
* @author Benjamin Bentmann
* @see RepositorySystem#deploy(RepositorySystemSession, DeployRequest)
*/
public class DeployRequest
{
private Collection artifacts = new ArrayList();
private Collection metadata = new ArrayList();
private RemoteRepository repository;
private RequestTrace trace;
/**
* Gets the artifact to deploy.
*
* @return The artifacts to deploy, never {@code null}.
*/
public Collection getArtifacts()
{
return artifacts;
}
/**
* Sets the artifacts to deploy.
*
* @param artifacts The artifacts to deploy, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest setArtifacts( Collection artifacts )
{
if ( artifacts == null )
{
this.artifacts = new ArrayList();
}
else
{
this.artifacts = artifacts;
}
return this;
}
/**
* Adds the specified artifacts for deployment.
*
* @param artifact The artifact to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest addArtifact( Artifact artifact )
{
if ( artifact != null )
{
artifacts.add( artifact );
}
return this;
}
/**
* Gets the metadata to deploy.
*
* @return The metadata to deploy, never {@code null}.
*/
public Collection getMetadata()
{
return metadata;
}
/**
* Sets the metadata to deploy.
*
* @param metadata The metadata to deploy, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest setMetadata( Collection metadata )
{
if ( metadata == null )
{
this.metadata = new ArrayList();
}
else
{
this.metadata = metadata;
}
return this;
}
/**
* Adds the specified metadata for deployment.
*
* @param metadata The metadata to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest addMetadata( Metadata metadata )
{
if ( metadata != null )
{
this.metadata.add( metadata );
}
return this;
}
/**
* Gets the repository to deploy to.
*
* @return The repository to deploy to or {@code null} if not set.
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the repository to deploy to.
*
* @param repository The repository to deploy to, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DeployRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifacts() + ", " + getMetadata() + " > " + getRepository();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/deployment/DeployResult.java 0000664 0000000 0000000 00000010145 11670505567 0031114 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.deployment;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collection;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
/**
* The result of deploying artifacts and their accompanying metadata into the a remote repository.
*
* @author Benjamin Bentmann
* @see RepositorySystem#deploy(RepositorySystemSession, DeployRequest)
*/
public class DeployResult
{
private final DeployRequest request;
private Collection artifacts = new ArrayList();
private Collection metadata = new ArrayList();
/**
* Creates a new result for the specified request.
*
* @param request The deployment request, must not be {@code null}.
*/
public DeployResult( DeployRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "deploy request has not been specified" );
}
this.request = request;
}
/**
* Gets the deploy request that was made.
*
* @return The deploy request, never {@code null}.
*/
public DeployRequest getRequest()
{
return request;
}
/**
* Gets the artifacts that got deployed.
*
* @return The deployed artifacts, never {@code null}.
*/
public Collection getArtifacts()
{
return artifacts;
}
/**
* Sets the artifacts that got deployed.
*
* @param artifacts The deployed artifacts, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DeployResult setArtifacts( Collection artifacts )
{
if ( artifacts == null )
{
this.artifacts = new ArrayList();
}
else
{
this.artifacts = artifacts;
}
return this;
}
/**
* Adds the specified artifacts to the result.
*
* @param artifact The deployed artifact to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DeployResult addArtifact( Artifact artifact )
{
if ( artifact != null )
{
artifacts.add( artifact );
}
return this;
}
/**
* Gets the metadata that got deployed. Note that due to automatically generated metadata, there might have been
* more metadata deployed than originally specified in the deploy request.
*
* @return The deployed metadata, never {@code null}.
*/
public Collection getMetadata()
{
return metadata;
}
/**
* Sets the metadata that got deployed.
*
* @param metadata The deployed metadata, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DeployResult setMetadata( Collection metadata )
{
if ( metadata == null )
{
this.metadata = new ArrayList();
}
else
{
this.metadata = metadata;
}
return this;
}
/**
* Adds the specified metadata to this result.
*
* @param metadata The deployed metadata to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DeployResult addMetadata( Metadata metadata )
{
if ( metadata != null )
{
this.metadata.add( metadata );
}
return this;
}
@Override
public String toString()
{
return getArtifacts() + ", " + getMetadata();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/deployment/DeploymentException.java 0000664 0000000 0000000 00000001634 11670505567 0032463 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.deployment;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of a deployment error like authentication failure.
*
* @author Benjamin Bentmann
*/
public class DeploymentException
extends RepositoryException
{
public DeploymentException( String message )
{
super( message );
}
public DeploymentException( String message, Throwable cause )
{
super( message, cause );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/ 0000775 0000000 0000000 00000000000 11670505567 0024536 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/Dependency.java 0000664 0000000 0000000 00000022066 11670505567 0027465 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.AbstractSet;
import java.util.Collection;
import java.util.Collections;
import java.util.Iterator;
import java.util.LinkedHashSet;
import java.util.NoSuchElementException;
import java.util.Set;
import org.sonatype.aether.artifact.Artifact;
/**
* A dependency to some artifact. Note: Instances of this class are immutable and the exposed mutators return
* new objects rather than changing the current instance.
*
* @author Benjamin Bentmann
*/
public final class Dependency
{
private final Artifact artifact;
private final String scope;
private final boolean optional;
private final Set exclusions;
/**
* Creates a mandatory dependency on the specified artifact with the given scope.
*
* @param artifact The artifact being depended on, must not be {@code null}.
* @param scope The scope of the dependency, may be {@code null}.
*/
public Dependency( Artifact artifact, String scope )
{
this( artifact, scope, false );
}
/**
* Creates a dependency on the specified artifact with the given scope.
*
* @param artifact The artifact being depended on, must not be {@code null}.
* @param scope The scope of the dependency, may be {@code null}.
* @param optional A flag whether the dependency is optional or mandatory.
*/
public Dependency( Artifact artifact, String scope, boolean optional )
{
this( artifact, scope, optional, null );
}
/**
* Creates a dependency on the specified artifact with the given scope and exclusions.
*
* @param artifact The artifact being depended on, must not be {@code null}.
* @param scope The scope of the dependency, may be {@code null}.
* @param optional A flag whether the dependency is optional or mandatory.
* @param exclusions The exclusions that apply to transitive dependencies, may be {@code null} if none.
*/
public Dependency( Artifact artifact, String scope, boolean optional, Collection exclusions )
{
this( artifact, scope, Exclusions.copy( exclusions ), optional );
}
private Dependency( Artifact artifact, String scope, Set exclusions, boolean optional )
{
// NOTE: This constructor assumes immutability of the provided exclusion collection, for internal use only
if ( artifact == null )
{
throw new IllegalArgumentException( "no artifact specified for dependency" );
}
this.artifact = artifact;
this.scope = ( scope != null ) ? scope : "";
this.optional = optional;
this.exclusions = exclusions;
}
/**
* Gets the artifact being depended on.
*
* @return The artifact, never {@code null}.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact being depended on.
*
* @param artifact The artifact, must not be {@code null}.
* @return The new dependency, never {@code null}.
*/
public Dependency setArtifact( Artifact artifact )
{
if ( this.artifact.equals( artifact ) )
{
return this;
}
return new Dependency( artifact, scope, exclusions, optional );
}
/**
* Gets the scope of the dependency. The scope defines in which context this dependency is relevant.
*
* @return The scope or an empty string if not set, never {@code null}.
*/
public String getScope()
{
return scope;
}
/**
* Sets the scope of the dependency, e.g. "compile".
*
* @param scope The scope of the dependency, may be {@code null}.
* @return The new dependency, never {@code null}.
*/
public Dependency setScope( String scope )
{
if ( this.scope.equals( scope ) || ( scope == null && this.scope.length() <= 0 ) )
{
return this;
}
return new Dependency( artifact, scope, exclusions, optional );
}
/**
* Indicates whether this dependency is optional or not. Optional dependencies can usually be ignored during
* transitive dependency resolution.
*
* @return {@code true} if the dependency is optional, {@code false} otherwise.
*/
public boolean isOptional()
{
return optional;
}
/**
* Sets the optional flag for the dependency.
*
* @param optional {@code true} if the dependency is optional, {@code false} if the dependency is mandatory.
* @return The new dependency, never {@code null}.
*/
public Dependency setOptional( boolean optional )
{
if ( this.optional == optional )
{
return this;
}
return new Dependency( artifact, scope, exclusions, optional );
}
/**
* Gets the exclusions for this dependency. Exclusions can be used to remove transitive dependencies during
* resolution.
*
* @return The (read-only) exclusions, never {@code null}.
*/
public Collection getExclusions()
{
return exclusions;
}
/**
* Sets the exclusions for the dependency.
*
* @param exclusions The exclusions, may be {@code null}.
* @return The new dependency, never {@code null}.
*/
public Dependency setExclusions( Collection exclusions )
{
if ( hasEquivalentExclusions( exclusions ) )
{
return this;
}
return new Dependency( artifact, scope, optional, exclusions );
}
private boolean hasEquivalentExclusions( Collection exclusions )
{
if ( exclusions == null || exclusions.isEmpty() )
{
return this.exclusions.isEmpty();
}
if ( exclusions instanceof Set )
{
return this.exclusions.equals( exclusions );
}
return exclusions.size() >= this.exclusions.size() && this.exclusions.containsAll( exclusions )
&& exclusions.containsAll( this.exclusions );
}
@Override
public String toString()
{
return String.valueOf( getArtifact() ) + " (" + getScope() + ( isOptional() ? "?" : "" ) + ")";
}
@Override
public boolean equals( Object obj )
{
if ( obj == this )
{
return true;
}
else if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
Dependency that = (Dependency) obj;
return artifact.equals( that.artifact ) && scope.equals( that.scope ) && optional == that.optional
&& exclusions.equals( that.exclusions );
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + artifact.hashCode();
hash = hash * 31 + scope.hashCode();
hash = hash * 31 + ( optional ? 1 : 0 );
hash = hash * 31 + exclusions.size();
return hash;
}
private static class Exclusions
extends AbstractSet
{
private final Exclusion[] exclusions;
public static Set copy( Collection exclusions )
{
if ( exclusions == null || exclusions.isEmpty() )
{
return Collections.emptySet();
}
return new Exclusions( exclusions );
}
private Exclusions( Collection exclusions )
{
if ( exclusions.size() > 1 && !( exclusions instanceof Set ) )
{
exclusions = new LinkedHashSet( exclusions );
}
this.exclusions = exclusions.toArray( new Exclusion[exclusions.size()] );
}
@Override
public Iterator iterator()
{
return new Iterator()
{
private int cursor = 0;
public boolean hasNext()
{
return cursor < exclusions.length;
}
public Exclusion next()
{
try
{
Exclusion exclusion = exclusions[cursor];
cursor++;
return exclusion;
}
catch ( IndexOutOfBoundsException e )
{
throw new NoSuchElementException();
}
}
public void remove()
{
throw new UnsupportedOperationException();
}
};
}
@Override
public int size()
{
return exclusions.length;
}
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/DependencyFilter.java 0000664 0000000 0000000 00000002631 11670505567 0030627 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.List;
/**
* A filter to include/exclude dependency nodes during other operations.
*
* @author Benjamin Bentmann
*/
public interface DependencyFilter
{
/**
* Indicates whether the specified dependency node shall be included or excluded.
*
* @param node The dependency node to filter, must not be {@code null}.
* @param parents The (read-only) chain of parent nodes that leads to the node to be filtered, must not be
* {@code null}. Iterating this (possibly empty) list walks up the dependency graph towards the root
* node, i.e. the immediate parent node (if any) is the first node in the list. The size of the list also
* denotes the zero-based depth of the filtered node.
* @return {@code true} to include the dependency node, {@code false} to exclude it.
*/
boolean accept( DependencyNode node, List parents );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/DependencyNode.java 0000664 0000000 0000000 00000012176 11670505567 0030274 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import java.util.List;
import java.util.Map;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
import org.sonatype.aether.version.Version;
import org.sonatype.aether.version.VersionConstraint;
/**
* A node within a dependency graph. Note: When traversing a dirty graph, i.e. a graph which hasn't undergone
* conflict resolution, there can be multiple path leading to the same node instance.
*
* @author Benjamin Bentmann
*/
public interface DependencyNode
{
/**
* Gets the child nodes of this node.
*
* @return The child nodes of this node, never {@code null}.
*/
List getChildren();
/**
* Gets the dependency associated with this node. Note: For dependency graphs that have been constructed
* without a root dependency, the root node will not have a dependency associated with it.
*
* @return The dependency or {@code null} if none.
*/
Dependency getDependency();
/**
* Sets the artifact of the dependency.
*
* @param artifact The artifact satisfying the dependency, must not be {@code null}.
*/
void setArtifact( Artifact artifact );
/**
* Gets the sequence of relocations that was followed to resolve the artifact referenced by the dependency.
*
* @return The (read-only) sequence of relocations, never {@code null}.
*/
List getRelocations();
/**
* Gets the known aliases for this dependency's artifact. An alias can be used to mark a patched rebuild of some
* other artifact as such, thereby allowing conflict resolution to consider the patched and the original artifact as
* a conflict.
*
* @return The (read-only) set of known aliases, never {@code null}.
*/
Collection getAliases();
/**
* Gets the version constraint that was parsed from the dependency's version declaration.
*
* @return The version constraint for this node or {@code null}.
*/
VersionConstraint getVersionConstraint();
/**
* Gets the version that was selected for the dependency's target artifact.
*
* @return The parsed version or {@code null}.
*/
Version getVersion();
/**
* Sets the scope of the dependency.
*
* @param scope The scope, may be {@code null}.
*/
void setScope( String scope );
/**
* Gets the version or version range for the dependency before dependency management was applied (if any).
*
* @return The dependency version before dependency management or {@code null} if the version was not managed.
*/
String getPremanagedVersion();
/**
* Gets the scope for the dependency before dependency management was applied (if any).
*
* @return The dependency scope before dependency management or {@code null} if the scope was not managed.
*/
String getPremanagedScope();
/**
* Gets the remote repositories from which this node's artifact shall be resolved.
*
* @return The (read-only) list of remote repositories to use for artifact resolution, never {@code null}.
*/
List getRepositories();
/**
* Gets the request context in which this dependency node was created.
*
* @return The request context, never {@code null}.
*/
String getRequestContext();
/**
* Sets the request context in which this dependency node was created.
*
* @param context The context, may be {@code null}.
*/
void setRequestContext( String context );
/**
* Gets the custom data associated with this dependency node. Clients of the repository system can use this data to
* annotate dependency nodes with domain-specific information.
*
* @return The (read-only) key-value mappings, never {@code null}.
*/
Map getData();
/**
* Associates the specified dependency node data with the given key. Note: This method must not be called
* while {@link #getData()} is being iterated.
*
* @param key The key under which to store the data, must not be {@code null}.
* @param value The data to associate with the key, may be {@code null} to remove the mapping.
*/
void setData( Object key, Object value );
/**
* Traverses this node and potentially its children using the specified visitor.
*
* @param visitor The visitor to call back, must not be {@code null}.
* @return {@code true} to visit siblings nodes of this node as well, {@code false} to skip siblings.
*/
boolean accept( DependencyVisitor visitor );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/DependencyVisitor.java 0000664 0000000 0000000 00000002703 11670505567 0031041 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A visitor for nodes of the dependency graph.
*
* @author Benjamin Bentmann
* @see DependencyNode#accept(DependencyVisitor)
*/
public interface DependencyVisitor
{
/**
* Notifies the visitor of a node visit before its children have been processed.
*
* @param node The dependency node being visited, must not be {@code null}.
* @return {@code true} to visit child nodes of the specified node as well, {@code false} to skip children.
*/
boolean visitEnter( DependencyNode node );
/**
* Notifies the visitor of a node visit after its children have been processed. Note that this method is always
* invoked regardless whether any children have actually been visited.
*
* @param node The dependency node being visited, must not be {@code null}.
* @return {@code true} to visit siblings nodes of the specified node as well, {@code false} to skip siblings.
*/
boolean visitLeave( DependencyNode node );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/graph/Exclusion.java 0000664 0000000 0000000 00000006675 11670505567 0027370 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* An exclusion of one or more transitive dependencies. Note: Instances of this class are immutable and the
* exposed mutators return new objects rather than changing the current instance.
*
* @author Benjamin Bentmann
* @see Dependency#getExclusions()
*/
public final class Exclusion
{
private final String groupId;
private final String artifactId;
private final String classifier;
private final String extension;
/**
* Creates an exclusion for artifacts with the specified coordinates.
*
* @param groupId The group identifier, may be {@code null}.
* @param artifactId The artifact identifier, may be {@code null}.
* @param classifier The classifier, may be {@code null}.
* @param extension The file extension, may be {@code null}.
*/
public Exclusion( String groupId, String artifactId, String classifier, String extension )
{
this.groupId = ( groupId != null ) ? groupId : "";
this.artifactId = ( artifactId != null ) ? artifactId : "";
this.classifier = ( classifier != null ) ? classifier : "";
this.extension = ( extension != null ) ? extension : "";
}
/**
* Gets the group identifier for artifacts to exclude.
*
* @return The group identifier, never {@code null}.
*/
public String getGroupId()
{
return groupId;
}
/**
* Gets the artifact identifier for artifacts to exclude.
*
* @return The artifact identifier, never {@code null}.
*/
public String getArtifactId()
{
return artifactId;
}
/**
* Gets the classifier for artifacts to exclude.
*
* @return The classifier, never {@code null}.
*/
public String getClassifier()
{
return classifier;
}
/**
* Gets the file extension for artifacts to exclude.
*
* @return The file extension of artifacts to exclude, never {@code null}.
*/
public String getExtension()
{
return extension;
}
@Override
public String toString()
{
return getGroupId() + ':' + getArtifactId() + ':' + getExtension()
+ ( getClassifier().length() > 0 ? ':' + getClassifier() : "" );
}
@Override
public boolean equals( Object obj )
{
if ( obj == this )
{
return true;
}
else if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
Exclusion that = (Exclusion) obj;
return artifactId.equals( that.artifactId ) && groupId.equals( that.groupId )
&& extension.equals( that.extension ) && classifier.equals( that.classifier );
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + artifactId.hashCode();
hash = hash * 31 + groupId.hashCode();
hash = hash * 31 + classifier.hashCode();
hash = hash * 31 + extension.hashCode();
return hash;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/installation/ 0000775 0000000 0000000 00000000000 11670505567 0026136 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/installation/InstallRequest.java 0000664 0000000 0000000 00000010114 11670505567 0031755 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.installation;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collection;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
/**
* A request to install artifacts and their accompanying metadata into the local repository.
*
* @author Benjamin Bentmann
* @see RepositorySystem#install(RepositorySystemSession, InstallRequest)
*/
public class InstallRequest
{
private Collection artifacts = new ArrayList();
private Collection metadata = new ArrayList();
private RequestTrace trace;
/**
* Gets the artifact to install.
*
* @return The artifacts to install, never {@code null}.
*/
public Collection getArtifacts()
{
return artifacts;
}
/**
* Sets the artifacts to install.
*
* @param artifacts The artifacts to install, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public InstallRequest setArtifacts( Collection artifacts )
{
if ( artifacts == null )
{
this.artifacts = new ArrayList();
}
else
{
this.artifacts = artifacts;
}
return this;
}
/**
* Adds the specified artifacts for installation.
*
* @param artifact The artifact to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public InstallRequest addArtifact( Artifact artifact )
{
if ( artifact != null )
{
artifacts.add( artifact );
}
return this;
}
/**
* Gets the metadata to install.
*
* @return The metadata to install, never {@code null}.
*/
public Collection getMetadata()
{
return metadata;
}
/**
* Sets the metadata to install.
*
* @param metadata The metadata to install.
* @return This request for chaining, never {@code null}.
*/
public InstallRequest setMetadata( Collection metadata )
{
if ( metadata == null )
{
this.metadata = new ArrayList();
}
else
{
this.metadata = metadata;
}
return this;
}
/**
* Adds the specified metadata for installation.
*
* @param metadata The metadata to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public InstallRequest addMetadata( Metadata metadata )
{
if ( metadata != null )
{
this.metadata.add( metadata );
}
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public InstallRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifacts() + ", " + getMetadata();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/installation/InstallResult.java 0000664 0000000 0000000 00000010204 11670505567 0031603 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.installation;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collection;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
/**
* The result of installing artifacts and their accompanying metadata into the a remote repository.
*
* @author Benjamin Bentmann
* @see RepositorySystem#install(RepositorySystemSession, InstallRequest)
*/
public class InstallResult
{
private final InstallRequest request;
private Collection artifacts = new ArrayList();
private Collection metadata = new ArrayList();
/**
* Creates a new result for the specified request.
*
* @param request The installation request, must not be {@code null}.
*/
public InstallResult( InstallRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "install request has not been specified" );
}
this.request = request;
}
/**
* Gets the install request that was made.
*
* @return The install request, never {@code null}.
*/
public InstallRequest getRequest()
{
return request;
}
/**
* Gets the artifacts that got installed.
*
* @return The installed artifacts, never {@code null}.
*/
public Collection getArtifacts()
{
return artifacts;
}
/**
* Sets the artifacts that got installed.
*
* @param artifacts The installed artifacts, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public InstallResult setArtifacts( Collection artifacts )
{
if ( artifacts == null )
{
this.artifacts = new ArrayList();
}
else
{
this.artifacts = artifacts;
}
return this;
}
/**
* Adds the specified artifacts to the result.
*
* @param artifact The installed artifact to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public InstallResult addArtifact( Artifact artifact )
{
if ( artifact != null )
{
artifacts.add( artifact );
}
return this;
}
/**
* Gets the metadata that got installed. Note that due to automatically generated metadata, there might have been
* more metadata installed than originally specified in the install request.
*
* @return The installed metadata, never {@code null}.
*/
public Collection getMetadata()
{
return metadata;
}
/**
* Sets the metadata that got installed.
*
* @param metadata The installed metadata, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public InstallResult setMetadata( Collection metadata )
{
if ( metadata == null )
{
this.metadata = new ArrayList();
}
else
{
this.metadata = metadata;
}
return this;
}
/**
* Adds the specified metadata to this result.
*
* @param metadata The installed metadata to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public InstallResult addMetadata( Metadata metadata )
{
if ( metadata != null )
{
this.metadata.add( metadata );
}
return this;
}
@Override
public String toString()
{
return getArtifacts() + ", " + getMetadata();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/installation/InstallationException.java 0000664 0000000 0000000 00000001634 11670505567 0033325 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.installation;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of an installation error like an IO error.
*
* @author Benjamin Bentmann
*/
public class InstallationException
extends RepositoryException
{
public InstallationException( String message )
{
super( message );
}
public InstallationException( String message, Throwable cause )
{
super( message, cause );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/metadata/ 0000775 0000000 0000000 00000000000 11670505567 0025215 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/metadata/MergeableMetadata.java 0000664 0000000 0000000 00000002765 11670505567 0031416 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.metadata;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import org.sonatype.aether.RepositoryException;
/**
* A piece of metadata that needs to be merged with any current metadata before installation/deployment.
*
* @author Benjamin Bentmann
*/
public interface MergeableMetadata
extends Metadata
{
/**
* Merges this metadata into the current metadata (if any). Note that this method will be invoked regardless whether
* metadata currently exists or not.
*
* @param current The path to the current metadata file, may not exist but must not be {@code null}.
* @param result The path to the result file where the merged metadata should be stored, must not be {@code null}.
* @throws RepositoryException If the metadata could not be merged.
*/
void merge( File current, File result )
throws RepositoryException;
/**
* Indicates whether this metadata has been merged.
*
* @return {@code true} if the metadata has been merged, {@code false} otherwise.
*/
boolean isMerged();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/metadata/Metadata.java 0000664 0000000 0000000 00000005701 11670505567 0027603 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.metadata;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
/**
* A piece of repository metadata, e.g. an index of available versions. In contrast to an artifact, which usually exists
* in only one repository, metadata usually exists in multiple repositories and each repository contains a different
* copy of the metadata. Note: Metadata instances are supposed to be immutable, e.g. any exposed mutator method
* returns a new metadata instance and leaves the original instance unchanged. Implementors are strongly advised to obey
* this contract.
*
* @author Benjamin Bentmann
*/
public interface Metadata
{
/**
* The nature of the metadata.
*/
enum Nature
{
/**
* The metadata refers to release artifacts only.
*/
RELEASE,
/**
* The metadata refers to snapshot artifacts only.
*/
SNAPSHOT,
/**
* The metadata refers to either release or snapshot artifacts.
*/
RELEASE_OR_SNAPSHOT
}
/**
* Gets the group identifier of this metadata.
*
* @return The group identifier or an empty string if the metadata applies to the entire repository, never {@code
* null}.
*/
String getGroupId();
/**
* Gets the artifact identifier of this metadata.
*
* @return The artifact identifier or an empty string if the metadata applies to the groupId level only, never
* {@code null}.
*/
String getArtifactId();
/**
* Gets the version of this metadata.
*
* @return The version or an empty string if the metadata applies to the groupId:artifactId level only, never
* {@code null}.
*/
String getVersion();
/**
* Gets the type of the metadata, e.g. "maven-metadata.xml".
*
* @return The type of the metadata, never {@code null}.
*/
String getType();
/**
* Gets the nature of this metadata. The nature indicates to what artifact versions the metadata refers.
*
* @return The nature, never {@code null}.
*/
Nature getNature();
/**
* Gets the file of this metadata. Note that only resolved metadata has a file associated with it.
*
* @return The file or {@code null} if none.
*/
File getFile();
/**
* Sets the file of the metadata.
*
* @param file The file of the metadata, may be {@code null}
* @return The new metadata, never {@code null}.
*/
Metadata setFile( File file );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/ 0000775 0000000 0000000 00000000000 11670505567 0025654 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/ArtifactRepository.java 0000664 0000000 0000000 00000001711 11670505567 0032354 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A repository hosting artifacts.
*
* @author Benjamin Bentmann
*/
public interface ArtifactRepository
{
/**
* Gets the type of the repository, for example "default".
*
* @return The (case-sensitive) type of the repository, never {@code null}.
*/
String getContentType();
/**
* Gets the identifier of this repository.
*
* @return The (case-sensitive) identifier, never {@code null}.
*/
String getId();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/Authentication.java 0000664 0000000 0000000 00000020047 11670505567 0031501 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Arrays;
/**
* The authentication to use for accessing a protected resource. Note: Instances of this class are immutable
* and the exposed mutators return new objects rather than changing the current instance.
*
* @author Benjamin Bentmann
*/
public final class Authentication
{
private final String username;
private final char[] password;
private final String privateKeyFile;
private final char[] passphrase;
private static char[] toChars( String str )
{
return ( str != null ) ? str.toCharArray() : null;
}
private static String toStr( char[] chars )
{
return ( chars != null ) ? new String( chars ) : null;
}
private static char[] clone( char[] chars )
{
return ( chars != null ) ? chars.clone() : null;
}
private Authentication( String username, String privateKeyFile, char[] password, char[] passphrase )
{
// NOTE: This constructor assumes ownership/immutability of the provided arrays
this.username = username;
this.password = password;
this.privateKeyFile = privateKeyFile;
this.passphrase = passphrase;
}
/**
* Creates a new authentication with the specified properties
*
* @param username The username, may be {@code null}.
* @param password The password, may be {@code null}.
* @param privateKeyFile The path to the private key file, may be {@code null}.
* @param passphrase The passphrase for the private key file, may be {@code null}.
*/
public Authentication( String username, char[] password, String privateKeyFile, char[] passphrase )
{
this( username, privateKeyFile, clone( password ), clone( passphrase ) );
}
/**
* Creates a new authentication with the specified properties
*
* @param username The username, may be {@code null}.
* @param password The password, may be {@code null}.
* @param privateKeyFile The path to the private key file, may be {@code null}.
* @param passphrase The passphrase for the private key file, may be {@code null}.
*/
public Authentication( String username, String password, String privateKeyFile, String passphrase )
{
this( username, privateKeyFile, toChars( password ), toChars( passphrase ) );
}
/**
* Creates a basic username+password authentication.
*
* @param username The username, may be {@code null}.
* @param password The password, may be {@code null}.
*/
public Authentication( String username, String password )
{
this( username, (String) null, toChars( password ), null );
}
/**
* Creates a basic username+password authentication.
*
* @param username The username, may be {@code null}.
* @param password The password, may be {@code null}.
*/
public Authentication( String username, char[] password )
{
this( username, password, null, null );
}
/**
* Gets the username.
*
* @return The username or {@code null} if none.
*/
public String getUsername()
{
return username;
}
/**
* Sets the username to use for authentication.
*
* @param username The username, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setUsername( String username )
{
if ( eq( this.username, username ) )
{
return this;
}
return new Authentication( username, privateKeyFile, password, passphrase );
}
/**
* Gets the password.
*
* @return The password or {@code null} if none.
*/
public String getPassword()
{
return toStr( password );
}
/**
* Sets the password to use for authentication.
*
* @param password The password, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setPassword( String password )
{
return setPasswordInternal( toChars( password ) );
}
/**
* Sets the password to use for authentication.
*
* @param password The password, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setPassword( char[] password )
{
return setPasswordInternal( clone( password ) );
}
private Authentication setPasswordInternal( char[] password )
{
if ( Arrays.equals( this.password, password ) )
{
return this;
}
return new Authentication( username, privateKeyFile, password, passphrase );
}
/**
* Gets the path to the private key file to use for authentication.
*
* @return The path to the private key file or {@code null} if none.
*/
public String getPrivateKeyFile()
{
return privateKeyFile;
}
/**
* Sets the path to the private key file to use for authentication.
*
* @param privateKeyFile The path to the private key file, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setPrivateKeyFile( String privateKeyFile )
{
if ( eq( this.privateKeyFile, privateKeyFile ) )
{
return this;
}
return new Authentication( username, privateKeyFile, password, passphrase );
}
/**
* Gets the passphrase for the private key.
*
* @return The passphrase for the private key or {@code null} if none.
*/
public String getPassphrase()
{
return toStr( passphrase );
}
/**
* Sets the passphrase for the private key file.
*
* @param passphrase The passphrase for the private key file, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setPassphrase( String passphrase )
{
return setPassphraseInternal( toChars( passphrase ) );
}
/**
* Sets the passphrase for the private key file.
*
* @param passphrase The passphrase for the private key file, may be {@code null}.
* @return The new authentication, never {@code null}.
*/
public Authentication setPassphrase( char[] passphrase )
{
return setPassphraseInternal( clone( passphrase ) );
}
private Authentication setPassphraseInternal( char[] passphrase )
{
if ( Arrays.equals( this.passphrase, passphrase ) )
{
return this;
}
return new Authentication( username, privateKeyFile, password, passphrase );
}
@Override
public String toString()
{
return getUsername();
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
Authentication that = (Authentication) obj;
return eq( username, that.username ) && Arrays.equals( password, that.password )
&& eq( privateKeyFile, that.privateKeyFile ) && Arrays.equals( passphrase, passphrase );
}
private static boolean eq( T s1, T s2 )
{
return s1 != null ? s1.equals( s2 ) : s2 == null;
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + hash( username );
hash = hash * 31 + Arrays.hashCode( password );
hash = hash * 31 + hash( privateKeyFile );
return hash;
}
private static int hash( Object obj )
{
return obj != null ? obj.hashCode() : 0;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/AuthenticationSelector.java 0000664 0000000 0000000 00000001711 11670505567 0033177 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* Selects authentication for a given remote repository.
*
* @author Benjamin Bentmann
*/
public interface AuthenticationSelector
{
/**
* Selects authentication for the specified remote repository.
*
* @param repository The repository for which to select authentication, must not be {@code null}.
* @return The selected authentication or {@code null} if none.
*/
Authentication getAuthentication( RemoteRepository repository );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalArtifactRegistration.java0000664 0000000 0000000 00000010175 11670505567 0033626 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import java.util.Collections;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
/**
* A request to register an artifact within the local repository. Certain local repository implementations can refuse to
* serve physically present artifacts if those haven't been previously registered to them.
*
* @author Benjamin Bentmann
* @see LocalRepositoryManager#add(RepositorySystemSession, LocalArtifactRegistration)
*/
public class LocalArtifactRegistration
{
private Artifact artifact;
private RemoteRepository repository;
private Collection contexts = Collections.emptyList();
/**
* Creates an uninitialized registration.
*/
public LocalArtifactRegistration()
{
// enables default constructor
}
/**
* Creates a registration request for the specified (locally installed) artifact.
*
* @param artifact The artifact to register, may be {@code null}.
*/
public LocalArtifactRegistration( Artifact artifact )
{
setArtifact( artifact );
}
/**
* Creates a registration request for the specified artifact.
*
* @param artifact The artifact to register, may be {@code null}.
* @param repository The remote repository from which the artifact was resolved or {@code null} if the artifact was
* locally installed.
* @param contexts The resolution contexts, may be {@code null}.
*/
public LocalArtifactRegistration( Artifact artifact, RemoteRepository repository, Collection contexts )
{
setArtifact( artifact );
setRepository( repository );
setContexts( contexts );
}
/**
* Gets the artifact to register.
*
* @return The artifact or {@code null} if not set.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact to register.
*
* @param artifact The artifact, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public LocalArtifactRegistration setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the remote repository from which the artifact was resolved.
*
* @return The remote repository or {@code null} if the artifact was locally installed.
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the remote repository from which the artifact was resolved.
*
* @param repository The remote repository or {@code null} if the artifact was locally installed.
* @return This request for chaining, never {@code null}.
*/
public LocalArtifactRegistration setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
/**
* Gets the resolution contexts in which the artifact is available.
*
* @return The resolution contexts in which the artifact is available, never {@code null}.
*/
public Collection getContexts()
{
return contexts;
}
/**
* Sets the resolution contexts in which the artifact is available.
*
* @param contexts The resolution contexts, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public LocalArtifactRegistration setContexts( Collection contexts )
{
if ( contexts != null )
{
this.contexts = contexts;
}
else
{
this.contexts = Collections.emptyList();
}
return this;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalArtifactRequest.java 0000664 0000000 0000000 00000007410 11670505567 0032602 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
/**
* A query to the local repository for the existence of an artifact.
*
* @author Benjamin Bentmann
* @see LocalRepositoryManager#find(RepositorySystemSession, LocalArtifactRequest)
*/
public class LocalArtifactRequest
{
private Artifact artifact;
private String context = "";
private List repositories = Collections.emptyList();
/**
* Creates an uninitialized query.
*/
public LocalArtifactRequest()
{
// enables default constructor
}
/**
* Creates a query with the specified properties.
*
* @param artifact The artifact to query for, may be {@code null}.
* @param repositories The remote repositories that should be considered as potential sources for the artifact, may
* be {@code null} or empty to only consider locally installed artifacts.
* @param context The resolution context for the artifact, may be {@code null}.
*/
public LocalArtifactRequest( Artifact artifact, List repositories, String context )
{
setArtifact( artifact );
setRepositories( repositories );
setContext( context );
}
/**
* Gets the artifact to query for.
*
* @return The artifact or {@code null} if not set.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact to query for.
*
* @param artifact The artifact, may be {@code null}.
* @return This query for chaining, never {@code null}.
*/
public LocalArtifactRequest setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the resolution context.
*
* @return The resolution context, never {@code null}.
*/
public String getContext()
{
return context;
}
/**
* Sets the resolution context.
*
* @param context The resolution context, may be {@code null}.
* @return This query for chaining, never {@code null}.
*/
public LocalArtifactRequest setContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the remote repositories to consider as sources of the artifact.
*
* @return The remote repositories, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the remote repositories to consider as sources of the artifact.
*
* @param repositories The remote repositories, may be {@code null} or empty to only consider locally installed
* artifacts.
* @return This query for chaining, never {@code null}.
*/
public LocalArtifactRequest setRepositories( List repositories )
{
if ( repositories != null )
{
this.repositories = repositories;
}
else
{
this.repositories = Collections.emptyList();
}
return this;
}
@Override
public String toString()
{
return getArtifact() + " @ " + getRepositories();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalArtifactResult.java 0000664 0000000 0000000 00000010677 11670505567 0032441 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import org.sonatype.aether.RepositorySystemSession;
/**
* A result from the local repository about the existence of an artifact.
*
* @author Benjamin Bentmann
* @see LocalRepositoryManager#find(RepositorySystemSession, LocalArtifactRequest)
*/
public class LocalArtifactResult
{
private final LocalArtifactRequest request;
private File file;
private boolean available;
private RemoteRepository repository;
/**
* Creates a new result for the specified request.
*
* @param request The local artifact request, must not be {@code null}.
*/
public LocalArtifactResult( LocalArtifactRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "local artifact request has not been specified" );
}
this.request = request;
}
/**
* Gets the request corresponding to this result.
*
* @return The corresponding request, never {@code null}.
*/
public LocalArtifactRequest getRequest()
{
return request;
}
/**
* Gets the file to the requested artifact. Note that this file must not be used unless {@link #isAvailable()}
* returns {@code true}. An artifact file can be found but considered unavailable if the artifact was cached from a
* remote repository that is not part of the list of remote repositories used for the query.
*
* @return The file to the requested artifact or {@code null} if the artifact does not exist locally.
*/
public File getFile()
{
return file;
}
/**
* Sets the file to requested artifact.
*
* @param file The artifact file, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public LocalArtifactResult setFile( File file )
{
this.file = file;
return this;
}
/**
* Indicates whether the requested artifact is available for use. As a minimum, the file needs to be physically
* existent in the local repository to be available. Additionally, a local repository manager can consider the list
* of supplied remote repositories to determine whether the artifact is logically available and mark an artifact
* unavailable (despite its physical existence) if it is not known to be hosted by any of the provided repositories.
*
* @return {@code true} if the artifact is available, {@code false} otherwise.
* @see LocalArtifactRequest#getRepositories()
*/
public boolean isAvailable()
{
return available;
}
/**
* Sets whether the artifact is available.
*
* @param available {@code true} if the artifact is available, {@code false} otherwise.
* @return This result for chaining, never {@code null}.
*/
public LocalArtifactResult setAvailable( boolean available )
{
this.available = available;
return this;
}
/**
* Gets the (first) remote repository from which the artifact was cached (if any).
*
* @return The remote repository from which the artifact was originally retrieved or {@code null} if unknown or if
* the artifact has been locally installed.
* @see LocalArtifactRequest#getRepositories()
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the (first) remote repository from which the artifact was cached.
*
* @param repository The remote repository from which the artifact was originally retrieved, may be {@code null} if
* unknown or if the artifact has been locally installed.
* @return This result for chaining, never {@code null}.
*/
public LocalArtifactResult setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
@Override
public String toString()
{
return getFile() + " (" + ( isAvailable() ? "available" : "unavailable" ) + ")";
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalMetadataRegistration.java0000664 0000000 0000000 00000010007 11670505567 0033603 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
import java.util.Collections;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.metadata.Metadata;
/**
* A request to register metadata within the local repository.
*
* @see LocalRepositoryManager#add(RepositorySystemSession, LocalMetadataRegistration)
*/
public class LocalMetadataRegistration
{
private Metadata metadata;
private RemoteRepository repository;
private Collection contexts = Collections.emptyList();
/**
* Creates an uninitialized registration.
*/
public LocalMetadataRegistration()
{
// enables default constructor
}
/**
* Creates a registration request for the specified metadata accompanying a locally installed artifact.
*
* @param metadata The metadata to register, may be {@code null}.
*/
public LocalMetadataRegistration( Metadata metadata )
{
setMetadata( metadata );
}
/**
* Creates a registration request for the specified metadata.
*
* @param metadata The metadata to register, may be {@code null}.
* @param repository The remote repository from which the metadata was resolved or {@code null} if the metadata
* accompanies a locally installed artifact.
* @param contexts The resolution contexts, may be {@code null}.
*/
public LocalMetadataRegistration( Metadata metadata, RemoteRepository repository, Collection contexts )
{
setMetadata( metadata );
setRepository( repository );
setContexts( contexts );
}
/**
* Gets the metadata to register.
*
* @return The metadata or {@code null} if not set.
*/
public Metadata getMetadata()
{
return metadata;
}
/**
* Sets the metadata to register.
*
* @param metadata The metadata, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public LocalMetadataRegistration setMetadata( Metadata metadata )
{
this.metadata = metadata;
return this;
}
/**
* Gets the remote repository from which the metadata was resolved.
*
* @return The remote repository or {@code null} if the metadata was locally installed.
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the remote repository from which the metadata was resolved.
*
* @param repository The remote repository or {@code null} if the metadata accompanies a locally installed artifact.
* @return This request for chaining, never {@code null}.
*/
public LocalMetadataRegistration setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
/**
* Gets the resolution contexts in which the metadata is available.
*
* @return The resolution contexts in which the metadata is available, never {@code null}.
*/
public Collection getContexts()
{
return contexts;
}
/**
* Sets the resolution contexts in which the metadata is available.
*
* @param contexts The resolution contexts, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public LocalMetadataRegistration setContexts( Collection contexts )
{
if ( contexts != null )
{
this.contexts = contexts;
}
else
{
this.contexts = Collections.emptyList();
}
return this;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalMetadataRequest.java 0000664 0000000 0000000 00000006507 11670505567 0032573 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.metadata.Metadata;
/**
* A query to the local repository for the existence of metadata.
*
* @see LocalRepositoryManager#find(RepositorySystemSession, LocalMetadataRequest)
*/
public class LocalMetadataRequest
{
private Metadata metadata;
private String context = "";
private RemoteRepository repository = null;
/**
* Creates an uninitialized query.
*/
public LocalMetadataRequest()
{
// enables default constructor
}
/**
* Creates a query with the specified properties.
*
* @param metadata The metadata to query for, may be {@code null}.
* @param repository The source remote repository for the metadata, may be {@code null} for local metadata.
* @param context The resolution context for the metadata, may be {@code null}.
*/
public LocalMetadataRequest( Metadata metadata, RemoteRepository repository, String context )
{
setMetadata( metadata );
setRepository( repository );
setContext( context );
}
/**
* Gets the metadata to query for.
*
* @return The metadata or {@code null} if not set.
*/
public Metadata getMetadata()
{
return metadata;
}
/**
* Sets the metadata to query for.
*
* @param metadata The metadata, may be {@code null}.
* @return This query for chaining, never {@code null}.
*/
public LocalMetadataRequest setMetadata( Metadata metadata )
{
this.metadata = metadata;
return this;
}
/**
* Gets the resolution context.
*
* @return The resolution context, never {@code null}.
*/
public String getContext()
{
return context;
}
/**
* Sets the resolution context.
*
* @param context The resolution context, may be {@code null}.
* @return This query for chaining, never {@code null}.
*/
public LocalMetadataRequest setContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the remote repository to use as source of the metadata.
*
* @return The remote repositories, may be {@code null} for local metadata.
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the remote repository to use as sources of the metadata.
*
* @param repository The remote repository, may be {@code null}.
* @return This query for chaining, may be {@code null} for local metadata.
*/
public LocalMetadataRequest setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
@Override
public String toString()
{
return getMetadata() + " @ " + getRepository();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalMetadataResult.java 0000664 0000000 0000000 00000005360 11670505567 0032415 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import org.sonatype.aether.RepositorySystemSession;
/**
* A result from the local repository about the existence of metadata.
*
* @see LocalRepositoryManager#find(RepositorySystemSession, LocalMetadataRequest)
*/
public class LocalMetadataResult
{
private final LocalMetadataRequest request;
private File file;
private boolean stale;
/**
* Creates a new result for the specified request.
*
* @param request The local metadata request, must not be {@code null}.
*/
public LocalMetadataResult( LocalMetadataRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "local metadata request has not been specified" );
}
this.request = request;
}
/**
* Gets the request corresponding to this result.
*
* @return The corresponding request, never {@code null}.
*/
public LocalMetadataRequest getRequest()
{
return request;
}
/**
* Gets the file to the requested metadata if the metadata is available in the local repository.
*
* @return The file to the requested metadata or {@code null}.
*/
public File getFile()
{
return file;
}
/**
* Sets the file to requested metadata.
*
* @param file The metadata file, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public LocalMetadataResult setFile( File file )
{
this.file = file;
return this;
}
/**
* This value indicates whether the metadata is stale and should be updated.
*
* @return {@code true} if the metadata is stale and should be updated, {@code false} otherwise.
*/
public boolean isStale()
{
return stale;
}
/**
* Sets whether the metadata is stale.
*
* @param stale {@code true} if the metadata is stale and should be updated, {@code false} otherwise.
* @return This result for chaining, never {@code null}.
*/
public LocalMetadataResult setStale( boolean stale )
{
this.stale = stale;
return this;
}
@Override
public String toString()
{
return request.toString() + "(" + getFile() + ")";
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalRepository.java 0000664 0000000 0000000 00000005757 11670505567 0031667 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
/**
* A repository on the local file system used to cache contents of remote repositories and to store locally installed
* artifacts.
*
* @author Benjamin Bentmann
*/
public final class LocalRepository
implements ArtifactRepository
{
private final File basedir;
private final String type;
/**
* Creates a new local repository with the specified base directory and unknown type.
*
* @param basedir The base directory of the repository, may be {@code null}.
*/
public LocalRepository( String basedir )
{
this( ( basedir != null ) ? new File( basedir ) : null, "" );
}
/**
* Creates a new local repository with the specified base directory and unknown type.
*
* @param basedir The base directory of the repository, may be {@code null}.
*/
public LocalRepository( File basedir )
{
this( basedir, "" );
}
/**
* Creates a new local repository with the specified properties.
*
* @param basedir The base directory of the repository, may be {@code null}.
* @param type The type of the repository, may be {@code null}.
*/
public LocalRepository( File basedir, String type )
{
this.basedir = basedir;
this.type = ( type != null ) ? type : "";
}
public String getContentType()
{
return type;
}
public String getId()
{
return "local";
}
/**
* Gets the base directory of the repository.
*
* @return The base directory or {@code null} if none.
*/
public File getBasedir()
{
return basedir;
}
@Override
public String toString()
{
return getBasedir() + " (" + getContentType() + ")";
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
LocalRepository that = (LocalRepository) obj;
return eq( basedir, that.basedir ) && eq( type, that.type );
}
private static boolean eq( T s1, T s2 )
{
return s1 != null ? s1.equals( s2 ) : s2 == null;
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + hash( basedir );
hash = hash * 31 + hash( type );
return hash;
}
private static int hash( Object obj )
{
return obj != null ? obj.hashCode() : 0;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/LocalRepositoryManager.java 0000664 0000000 0000000 00000013757 11670505567 0033161 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.metadata.Metadata;
/**
* Manages access to the local repository.
*
* @author Benjamin Bentmann
*/
public interface LocalRepositoryManager
{
/**
* Gets the description of the local repository being managed.
*
* @return The description of the local repository, never {@code null}.
*/
LocalRepository getRepository();
/**
* Gets the relative path for a locally installed artifact. Note that the artifact need not actually exist yet at
* the returned location, the path merely indicates where the artifact would eventually be stored. The path uses the
* forward slash as directory separator regardless of the underlying file system.
*
* @param artifact The artifact for which to determine the path, must not be {@code null}.
* @return The path, relative to the local repository's base directory.
*/
String getPathForLocalArtifact( Artifact artifact );
/**
* Gets the relative path for an artifact cached from a remote repository. Note that the artifact need not actually
* exist yet at the returned location, the path merely indicates where the artifact would eventually be stored. The
* path uses the forward slash as directory separator regardless of the underlying file system.
*
* @param artifact The artifact for which to determine the path, must not be {@code null}.
* @param repository The source repository of the artifact, must not be {@code null}.
* @param context The resolution context in which the artifact is being requested, may be {@code null}.
* @return The path, relative to the local repository's base directory.
*/
String getPathForRemoteArtifact( Artifact artifact, RemoteRepository repository, String context );
/**
* Gets the relative path for locally installed metadata. Note that the metadata need not actually exist yet at the
* returned location, the path merely indicates where the metadata would eventually be stored. The path uses the
* forward slash as directory separator regardless of the underlying file system.
*
* @param metadata The metadata for which to determine the path, must not be {@code null}.
* @return The path, relative to the local repository's base directory.
*/
String getPathForLocalMetadata( Metadata metadata );
/**
* Gets the relative path for metadata cached from a remote repository. Note that the metadata need not actually
* exist yet at the returned location, the path merely indicates where the metadata would eventually be stored. The
* path uses the forward slash as directory separator regardless of the underlying file system.
*
* @param metadata The metadata for which to determine the path, must not be {@code null}.
* @param repository The source repository of the metadata, must not be {@code null}.
* @param context The resolution context in which the metadata is being requested, may be {@code null}.
* @return The path, relative to the local repository's base directory.
*/
String getPathForRemoteMetadata( Metadata metadata, RemoteRepository repository, String context );
/**
* Queries for the existence of an artifact in the local repository. The request could be satisfied by a locally
* installed artifact or a previously downloaded artifact.
*
* @param session The repository system session during which the request is made, must not be {@code null}.
* @param request The artifact request, must not be {@code null}.
* @return The result of the request, never {@code null}.
*/
LocalArtifactResult find( RepositorySystemSession session, LocalArtifactRequest request );
/**
* Registers an installed or resolved artifact with the local repository. Note that artifact registration is merely
* concerned about updating the local repository's internal state, not about actually installing the artifact or its
* accompanying metadata.
*
* @param session The repository system session during which the registration is made, must not be {@code null}.
* @param request The registration request, must not be {@code null}.
*/
void add( RepositorySystemSession session, LocalArtifactRegistration request );
/**
* Queries for the existence of metadata in the local repository. The request could be satisfied by locally
* installed or previously downloaded metadata.
*
* @param session The repository system session during which the request is made, must not be {@code null}.
* @param request The metadata request, must not be {@code null}.
* @return The result of the request, never {@code null}.
*/
LocalMetadataResult find( RepositorySystemSession session, LocalMetadataRequest request );
/**
* Registers installed or resolved metadata with the local repository. Note that metadata registration is merely
* concerned about updating the local repository's internal state, not about actually installing the metadata.
* However, this method MUST be called after the actual install to give the repository manager the opportunity to
* inspect the added metadata.
*
* @param session The repository system session during which the registration is made, must not be {@code null}.
* @param request The registration request, must not be {@code null}.
*/
void add( RepositorySystemSession session, LocalMetadataRegistration request );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/MirrorSelector.java 0000664 0000000 0000000 00000001713 11670505567 0031474 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* Selects a mirror for a given remote repository.
*
* @author Benjamin Bentmann
*/
public interface MirrorSelector
{
/**
* Selects a mirror for the specified repository.
*
* @param repository The repository to select a mirror for, must not be {@code null}.
* @return The selected mirror or {@code null} if none.
* @see RemoteRepository#getMirroredRepositories()
*/
RemoteRepository getMirror( RemoteRepository repository );
}
NoLocalRepositoryManagerException.java 0000664 0000000 0000000 00000003550 11670505567 0035244 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of an unsupported local repository type.
*/
public class NoLocalRepositoryManagerException
extends RepositoryException
{
private final LocalRepository repository;
public NoLocalRepositoryManagerException( LocalRepository repository )
{
this( repository, toMessage( repository ) );
}
public NoLocalRepositoryManagerException( LocalRepository repository, String message )
{
super( message );
this.repository = repository;
}
public NoLocalRepositoryManagerException( LocalRepository repository, Throwable cause )
{
this( repository, toMessage( repository ), cause );
}
public NoLocalRepositoryManagerException( LocalRepository repository, String message, Throwable cause )
{
super( message, cause );
this.repository = repository;
}
private static String toMessage( LocalRepository repository )
{
if ( repository != null )
{
return "No manager available for local repository (" + repository.getBasedir().getAbsolutePath()
+ ") of type " + repository.getContentType();
}
else
{
return "No connector available to access repository";
}
}
public LocalRepository getRepository()
{
return repository;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/Proxy.java 0000664 0000000 0000000 00000011703 11670505567 0027642 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A proxy to use for connections to a repository. Note: Instances of this class are immutable and the exposed
* mutators return new objects rather than changing the current instance.
*
* @author Benjamin Bentmann
*/
public final class Proxy
{
/**
* Type denoting a proxy for HTTP transfers.
*/
public static final String TYPE_HTTP = "http";
/**
* Type denoting a proxy for HTTPS transfers.
*/
public static final String TYPE_HTTPS = "https";
private final String type;
private final String host;
private final int port;
private final Authentication auth;
/**
* Creates a new proxy with the specified properties.
*
* @param type The type of the proxy, e.g. "http", may be {@code null}.
* @param host The host of the proxy, may be {@code null}.
* @param port The port of the proxy.
* @param auth The authentication to use for the proxy connection, may be {@code null}.
*/
public Proxy( String type, String host, int port, Authentication auth )
{
this.type = ( type != null ) ? type : "";
this.host = ( host != null ) ? host : "";
this.port = port;
this.auth = auth;
}
/**
* Gets the type of this proxy.
*
* @return The type of this proxy, never {@code null}.
*/
public String getType()
{
return type;
}
/**
* Sets the type of the proxy.
*
* @param type The type of the proxy, e.g. "http", may be {@code null}.
* @return The new proxy, never {@code null}.
*/
public Proxy setType( String type )
{
if ( this.type.equals( type ) || ( type == null && this.type.length() <= 0 ) )
{
return this;
}
return new Proxy( type, host, port, auth );
}
/**
* Gets the host for this proxy.
*
* @return The host for this proxy, never {@code null}.
*/
public String getHost()
{
return host;
}
/**
* Sets the host of the proxy.
*
* @param host The host of the proxy, may be {@code null}.
* @return The new proxy, never {@code null}.
*/
public Proxy setHost( String host )
{
if ( this.host.equals( host ) || ( host == null && this.host.length() <= 0 ) )
{
return this;
}
return new Proxy( type, host, port, auth );
}
/**
* Gets the port number for this proxy.
*
* @return The port number for this proxy.
*/
public int getPort()
{
return port;
}
/**
* Sets the port number for the proxy.
*
* @param port The port number for the proxy.
* @return The new proxy, never {@code null}.
*/
public Proxy setPort( int port )
{
if ( this.port == port )
{
return this;
}
return new Proxy( type, host, port, auth );
}
/**
* Gets the authentication to use for the proxy connection.
*
* @return The authentication to use or {@code null} if none.
*/
public Authentication getAuthentication()
{
return auth;
}
/**
* Sets the authentication to use for the proxy connection.
*
* @param auth The authentication to use, may be {@code null}.
* @return The new proxy, never {@code null}.
*/
public Proxy setAuthentication( Authentication auth )
{
if ( eq( this.auth, auth ) )
{
return this;
}
return new Proxy( type, host, port, auth );
}
@Override
public String toString()
{
return getHost() + ':' + getPort();
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
Proxy that = (Proxy) obj;
return eq( type, that.type ) && eq( host, that.host ) && port == that.port && eq( auth, that.auth );
}
private static boolean eq( T s1, T s2 )
{
return s1 != null ? s1.equals( s2 ) : s2 == null;
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + hash( host );
hash = hash * 31 + hash( type );
hash = hash * 31 + port;
hash = hash * 31 + hash( auth );
return hash;
}
private static int hash( Object obj )
{
return obj != null ? obj.hashCode() : 0;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/ProxySelector.java 0000664 0000000 0000000 00000001620 11670505567 0031340 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* Selects a proxy for a given remote repository.
*
* @author Benjamin Bentmann
*/
public interface ProxySelector
{
/**
* Selects a proxy for the specified remote repository.
*
* @param repository The repository for which to select a proxy, must not be {@code null}.
* @return The selected proxy or {@code null} if none.
*/
Proxy getProxy( RemoteRepository repository );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/RemoteRepository.java 0000664 0000000 0000000 00000026074 11670505567 0032063 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collections;
import java.util.List;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
/**
* A repository on a remote server.
*
* @author Benjamin Bentmann
*/
public class RemoteRepository
implements ArtifactRepository
{
private static final Pattern URL_PATTERN =
Pattern.compile( "([^:/]+(:[^:/]{2,}+(?=://))?):(//([^@/]*@)?([^/:]+))?.*" );
private String id = "";
private String type = "";
private String url = "";
private RepositoryPolicy releasePolicy;
private RepositoryPolicy snapshotPolicy;
private Proxy proxy;
private Authentication authentication;
private List mirroredRepositories = Collections.emptyList();
private boolean repositoryManager;
/**
* Creates a new repository using the default release/snapshot policies.
*/
public RemoteRepository()
{
setPolicy( true, null );
setPolicy( false, null );
}
/**
* Creates a shallow copy of the specified repository.
*
* @param repository The repository to copy, must not be {@code null}.
*/
public RemoteRepository( RemoteRepository repository )
{
setId( repository.getId() );
setContentType( repository.getContentType() );
setUrl( repository.getUrl() );
setPolicy( true, repository.getPolicy( true ) );
setPolicy( false, repository.getPolicy( false ) );
setAuthentication( repository.getAuthentication() );
setProxy( repository.getProxy() );
setMirroredRepositories( repository.getMirroredRepositories() );
setRepositoryManager( repository.isRepositoryManager() );
}
/**
* Creates a new repository with the specified properties and the default policies.
*
* @param id The identifier of the repository, may be {@code null}.
* @param type The type of the repository, may be {@code null}.
* @param url The (base) URL of the repository, may be {@code null}.
*/
public RemoteRepository( String id, String type, String url )
{
setId( id );
setContentType( type );
setUrl( url );
setPolicy( true, null );
setPolicy( false, null );
}
public String getId()
{
return id;
}
/**
* Sets the identifier of this repository.
*
* @param id The identifier of this repository, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setId( String id )
{
this.id = ( id != null ) ? id : "";
return this;
}
public String getContentType()
{
return type;
}
/**
* Sets the type of this repository, e.g. "default".
*
* @param type The type of this repository, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setContentType( String type )
{
this.type = ( type != null ) ? type : "";
return this;
}
/**
* Gets the (base) URL of this repository.
*
* @return The (base) URL of this repository, never {@code null}.
*/
public String getUrl()
{
return url;
}
/**
* Sets the (base) URL of this repository.
*
* @param url The URL of this repository, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setUrl( String url )
{
this.url = ( url != null ) ? url : "";
return this;
}
/**
* Gets the protocol part from the repository's URL, for example {@code file} or {@code http}. As suggested by RFC
* 2396, section 3.1 "Scheme Component", the protocol name should be treated case-insensitively.
*
* @return The protocol or an empty string if none, never {@code null}.
*/
public String getProtocol()
{
Matcher m = URL_PATTERN.matcher( this.url );
if ( m.matches() )
{
return m.group( 1 );
}
return "";
}
/**
* Gets the host part from the repository's URL.
*
* @return The host or an empty string if none, never {@code null}.
*/
public String getHost()
{
Matcher m = URL_PATTERN.matcher( this.url );
if ( m.matches() )
{
String host = m.group( 5 );
if ( host != null )
{
return host;
}
}
return "";
}
/**
* Gets the policy to apply for snapshot/release artifacts.
*
* @param snapshot {@code true} to retrieve the snapshot policy, {@code false} to retrieve the release policy.
* @return The requested repository policy, never {@code null}.
*/
public RepositoryPolicy getPolicy( boolean snapshot )
{
return snapshot ? snapshotPolicy : releasePolicy;
}
/**
* Sets the policy to apply for snapshot/release artifacts.
*
* @param snapshot {@code true} to set the snapshot policy, {@code false} to set the release policy.
* @param policy The repository policy to set, may be {@code null} to use a default policy.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setPolicy( boolean snapshot, RepositoryPolicy policy )
{
if ( policy == null )
{
policy = new RepositoryPolicy();
}
if ( snapshot )
{
snapshotPolicy = policy;
}
else
{
releasePolicy = policy;
}
return this;
}
/**
* Gets the proxy that has been selected for this repository.
*
* @return The selected proxy or {@code null} if none.
*/
public Proxy getProxy()
{
return proxy;
}
/**
* Sets the proxy to use in order to access this repository.
*
* @param proxy The proxy to use, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setProxy( Proxy proxy )
{
this.proxy = proxy;
return this;
}
/**
* Gets the authentication that has been selected for this repository.
*
* @return The selected authentication or {@code null} if none.
*/
public Authentication getAuthentication()
{
return authentication;
}
/**
* Sets the authentication to use in order to access this repository.
*
* @param authentication The authentication to use, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setAuthentication( Authentication authentication )
{
this.authentication = authentication;
return this;
}
/**
* Gets the repositories that this repository serves as a mirror for.
*
* @return The repositories being mirrored by this repository, never {@code null}.
*/
public List getMirroredRepositories()
{
return mirroredRepositories;
}
/**
* Sets the repositories being mirrored by this repository.
*
* @param mirroredRepositories The repositories being mirrored by this repository, may be {@code null}.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setMirroredRepositories( List mirroredRepositories )
{
if ( mirroredRepositories == null || mirroredRepositories.isEmpty() )
{
this.mirroredRepositories = Collections.emptyList();
}
else
{
this.mirroredRepositories = mirroredRepositories;
}
return this;
}
/**
* Indicates whether this repository refers to a repository manager or not.
*
* @return {@code true} if this repository is a repository manager, {@code false} otherwise.
*/
public boolean isRepositoryManager()
{
return repositoryManager;
}
/**
* Marks this repository as a repository manager or not.
*
* @param repositoryManager {@code true} if this repository points at a repository manager, {@code false} if the
* repository is just serving static contents.
* @return This repository for chaining, never {@code null}.
*/
public RemoteRepository setRepositoryManager( boolean repositoryManager )
{
this.repositoryManager = repositoryManager;
return this;
}
@Override
public String toString()
{
StringBuilder buffer = new StringBuilder( 256 );
buffer.append( getId() );
buffer.append( " (" ).append( getUrl() );
boolean r = getPolicy( false ).isEnabled(), s = getPolicy( true ).isEnabled();
if ( r && s )
{
buffer.append( ", releases+snapshots" );
}
else if ( r )
{
buffer.append( ", releases" );
}
else if ( s )
{
buffer.append( ", snapshots" );
}
else
{
buffer.append( ", disabled" );
}
if ( isRepositoryManager() )
{
buffer.append( ", managed" );
}
buffer.append( ")" );
return buffer.toString();
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
RemoteRepository that = (RemoteRepository) obj;
return eq( url, that.url ) && eq( type, that.type ) && eq( id, that.id )
&& eq( releasePolicy, that.releasePolicy ) && eq( snapshotPolicy, that.snapshotPolicy )
&& eq( proxy, that.proxy ) && eq( authentication, that.authentication )
&& eq( mirroredRepositories, that.mirroredRepositories ) && repositoryManager == that.repositoryManager;
}
private static boolean eq( T s1, T s2 )
{
return s1 != null ? s1.equals( s2 ) : s2 == null;
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + hash( url );
hash = hash * 31 + hash( type );
hash = hash * 31 + hash( id );
hash = hash * 31 + hash( releasePolicy );
hash = hash * 31 + hash( snapshotPolicy );
hash = hash * 31 + hash( proxy );
hash = hash * 31 + hash( authentication );
hash = hash * 31 + hash( mirroredRepositories );
hash = hash * 31 + ( repositoryManager ? 1 : 0 );
return hash;
}
private static int hash( Object obj )
{
return obj != null ? obj.hashCode() : 0;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/RepositoryPolicy.java 0000664 0000000 0000000 00000014077 11670505567 0032067 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A policy controlling access to a repository. Note: Instances of this class are immutable and the exposed
* mutators return new objects rather than changing the current instance.
*
* @author Benjamin Bentmann
*/
public final class RepositoryPolicy
{
/**
* Never update locally cached data.
*/
public static final String UPDATE_POLICY_NEVER = "never";
/**
* Always update locally cached data.
*/
public static final String UPDATE_POLICY_ALWAYS = "always";
/**
* Update locally cached data once a day.
*/
public static final String UPDATE_POLICY_DAILY = "daily";
/**
* Update locally cached data every X minutes as given by "interval:X".
*/
public static final String UPDATE_POLICY_INTERVAL = "interval";
/**
* Verify checksums and fail the resolution if they do not match.
*/
public static final String CHECKSUM_POLICY_FAIL = "fail";
/**
* Verify checksums and warn if they do not match.
*/
public static final String CHECKSUM_POLICY_WARN = "warn";
/**
* Do not verify checksums.
*/
public static final String CHECKSUM_POLICY_IGNORE = "ignore";
private final boolean enabled;
private final String updatePolicy;
private final String checksumPolicy;
/**
* Creates a new policy with checksum warnings and daily update checks.
*/
public RepositoryPolicy()
{
this( true, UPDATE_POLICY_DAILY, CHECKSUM_POLICY_WARN );
}
/**
* Creates a new policy with the specified settings.
*
* @param enabled A flag whether the associated repository should be accessed or not.
* @param updatePolicy The update interval after which locally cached data from the repository is considered stale
* and should be refetched, may be {@code null}.
* @param checksumPolicy The way checksum verification should be handled, may be {@code null}.
*/
public RepositoryPolicy( boolean enabled, String updatePolicy, String checksumPolicy )
{
this.enabled = enabled;
this.updatePolicy = ( updatePolicy != null ) ? updatePolicy : "";
this.checksumPolicy = ( checksumPolicy != null ) ? checksumPolicy : "";
}
/**
* Indicates whether the associated repository should be contacted or not.
*
* @return {@code true} if the repository should be contacted, {@code false} otherwise.
*/
public boolean isEnabled()
{
return enabled;
}
/**
* Sets the enabled flag for the associated repository.
*
* @param enabled {@code true} if the repository should be contacted, {@code false} otherwise.
* @return The new policy, never {@code null}.
*/
public RepositoryPolicy setEnabled( boolean enabled )
{
if ( this.enabled == enabled )
{
return this;
}
return new RepositoryPolicy( enabled, updatePolicy, checksumPolicy );
}
/**
* Gets the update policy for locally cached data from the repository.
*
* @return The update policy, never {@code null}.
*/
public String getUpdatePolicy()
{
return updatePolicy;
}
/**
* Sets the update policy for locally cached data from the repository. Well-known policies are
* {@link #UPDATE_POLICY_NEVER}, {@link #UPDATE_POLICY_ALWAYS}, {@link #UPDATE_POLICY_DAILY} and
* {@link #UPDATE_POLICY_INTERVAL}
*
* @param updatePolicy The update policy, may be {@code null}.
* @return The new policy, never {@code null}.
*/
public RepositoryPolicy setUpdatePolicy( String updatePolicy )
{
if ( this.updatePolicy.equals( updatePolicy ) )
{
return this;
}
return new RepositoryPolicy( enabled, updatePolicy, checksumPolicy );
}
/**
* Gets the policy for checksum validation.
*
* @return The checksum policy, never {@code null}.
*/
public String getChecksumPolicy()
{
return checksumPolicy;
}
/**
* Sets the policy for checksum validation. Well-known policies are {@link #CHECKSUM_POLICY_FAIL},
* {@link #CHECKSUM_POLICY_WARN} and {@link #CHECKSUM_POLICY_IGNORE}.
*
* @param checksumPolicy The checksum policy, may be {@code null}.
* @return The new policy, never {@code null}.
*/
public RepositoryPolicy setChecksumPolicy( String checksumPolicy )
{
if ( this.checksumPolicy.equals( checksumPolicy ) )
{
return this;
}
return new RepositoryPolicy( enabled, updatePolicy, checksumPolicy );
}
@Override
public String toString()
{
StringBuilder buffer = new StringBuilder( 256 );
buffer.append( "enabled=" ).append( isEnabled() );
buffer.append( ", checksums=" ).append( getChecksumPolicy() );
buffer.append( ", updates=" ).append( getUpdatePolicy() );
return buffer.toString();
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
RepositoryPolicy that = (RepositoryPolicy) obj;
return enabled == that.enabled && updatePolicy.equals( that.updatePolicy )
&& checksumPolicy.equals( that.checksumPolicy );
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + ( enabled ? 1 : 0 );
hash = hash * 31 + updatePolicy.hashCode();
hash = hash * 31 + checksumPolicy.hashCode();
return hash;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/WorkspaceReader.java 0000664 0000000 0000000 00000002752 11670505567 0031606 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import java.util.List;
import org.sonatype.aether.artifact.Artifact;
/**
* Manages a repository backed by the IDE workspace or a build session.
*
* @author Benjamin Bentmann
*/
public interface WorkspaceReader
{
/**
* Gets a description of the workspace repository.
*
* @return The repository description, never {@code null}.
*/
WorkspaceRepository getRepository();
/**
* Locates the specified artifact.
*
* @param artifact The artifact to locate, must not be {@code null}.
* @return The path to the artifact or {@code null} if the artifact is not available.
*/
File findArtifact( Artifact artifact );
/**
* Determines all available versions of the specified artifact.
*
* @param artifact The artifact whose versions should be listed, must not be {@code null}.
* @return The available versions of the artifact, must not be {@code null}.
*/
List findVersions( Artifact artifact );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/repository/WorkspaceRepository.java 0000664 0000000 0000000 00000004522 11670505567 0032560 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.UUID;
/**
* A repository backed by an IDE workspace or the output of a build session.
*
* @author Benjamin Bentmann
*/
public final class WorkspaceRepository
implements ArtifactRepository
{
private final String type;
private final Object key;
public WorkspaceRepository()
{
this( "workspace" );
}
public WorkspaceRepository( String type )
{
this( type, null );
}
public WorkspaceRepository( String type, Object key )
{
this.type = ( type != null ) ? type : "";
this.key = ( key != null ) ? key : UUID.randomUUID().toString().replace( "-", "" );
}
public String getContentType()
{
return type;
}
public String getId()
{
return "workspace";
}
/**
* Gets the key of this workspace repository. The key is used to distinguish one workspace from another and should
* be sensitive to the artifacts that are (potentially) available in the workspace.
*
* @return The (comparison) key for this workspace repository, never {@code null}.
*/
public Object getKey()
{
return key;
}
@Override
public String toString()
{
return "(" + getContentType() + ")";
}
@Override
public boolean equals( Object obj )
{
if ( this == obj )
{
return true;
}
if ( obj == null || !getClass().equals( obj.getClass() ) )
{
return false;
}
WorkspaceRepository that = (WorkspaceRepository) obj;
return getContentType().equals( that.getContentType() ) && getKey().equals( that.getKey() );
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + getKey().hashCode();
hash = hash * 31 + getContentType().hashCode();
return hash;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/ 0000775 0000000 0000000 00000000000 11670505567 0025640 5 ustar 00root root 0000000 0000000 ArtifactDescriptorException.java 0000664 0000000 0000000 00000003106 11670505567 0034077 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of an unreadable or unresolvable artifact descriptor.
*
* @author Benjamin Bentmann
*/
public class ArtifactDescriptorException
extends RepositoryException
{
private final ArtifactDescriptorResult result;
public ArtifactDescriptorException( ArtifactDescriptorResult result, String message )
{
super( message, getCause( result ) );
this.result = result;
}
public ArtifactDescriptorException( ArtifactDescriptorResult result )
{
super( "Failed to read artifact descriptor"
+ ( result != null ? " for " + result.getRequest().getArtifact() : "" ), getCause( result ) );
this.result = result;
}
public ArtifactDescriptorResult getResult()
{
return result;
}
private static Throwable getCause( ArtifactDescriptorResult result )
{
Throwable cause = null;
if ( result != null && !result.getExceptions().isEmpty() )
{
cause = result.getExceptions().get( 0 );
}
return cause;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/ArtifactDescriptorRequest.java0000664 0000000 0000000 00000012341 11670505567 0033651 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to read an artifact descriptor.
*
* @author Benjamin Bentmann
* @see RepositorySystem#readArtifactDescriptor(RepositorySystemSession, ArtifactDescriptorRequest)
*/
public class ArtifactDescriptorRequest
{
private Artifact artifact;
private List repositories = Collections.emptyList();
private String context = "";
private RequestTrace trace;
/**
* Creates an uninitialized request.
*/
public ArtifactDescriptorRequest()
{
// enables default constructor
}
/**
* Creates a request with the specified properties.
*
* @param artifact The artifact whose descriptor should be read, may be {@code null}.
* @param repositories The repositories to resolve the descriptor from, may be {@code null}.
* @param context The context in which this request is made, may be {@code null}.
*/
public ArtifactDescriptorRequest( Artifact artifact, List repositories, String context )
{
setArtifact( artifact );
setRepositories( repositories );
setRequestContext( context );
}
/**
* Gets the artifact whose descriptor shall be read.
*
* @return The artifact or {@code null} if not set.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact whose descriptor shall be read. Eventually, a valid request must have an artifact set.
*
* @param artifact The artifact, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactDescriptorRequest setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the repositories to resolve the descriptor from.
*
* @return The repositories, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the repositories to resolve the descriptor from.
*
* @param repositories The repositories, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactDescriptorRequest setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = Collections.emptyList();
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified repository for the resolution of the artifact descriptor.
*
* @param repository The repository to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactDescriptorRequest addRepository( RemoteRepository repository )
{
if ( repository != null )
{
if ( this.repositories.isEmpty() )
{
this.repositories = new ArrayList();
}
this.repositories.add( repository );
}
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactDescriptorRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactDescriptorRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifact() + " < " + getRepositories();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/ArtifactDescriptorResult.java 0000664 0000000 0000000 00000030647 11670505567 0033510 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Map;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.graph.Dependency;
import org.sonatype.aether.repository.ArtifactRepository;
import org.sonatype.aether.repository.RemoteRepository;
/**
* The result from reading an artifact descriptor.
*
* @author Benjamin Bentmann
* @see RepositorySystem#readArtifactDescriptor(RepositorySystemSession, ArtifactDescriptorRequest)
*/
public class ArtifactDescriptorResult
{
private final ArtifactDescriptorRequest request;
private List exceptions;
private List relocations;
private Collection aliases;
private Artifact artifact;
private ArtifactRepository repository;
private List dependencies;
private List managedDependencies;
private List repositories;
private Map properties;
/**
* Creates a new result for the specified request.
*
* @param request The descriptor request, must not be {@code null}.
*/
public ArtifactDescriptorResult( ArtifactDescriptorRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "artifact descriptor request has not been specified" );
}
this.request = request;
this.artifact = request.getArtifact();
this.exceptions = new ArrayList( 2 );
this.relocations = new ArrayList( 2 );
this.aliases = new ArrayList( 1 );
this.dependencies = new ArrayList();
this.managedDependencies = new ArrayList();
this.repositories = new ArrayList();
this.properties = Collections.emptyMap();
}
/**
* Gets the descriptor request that was made.
*
* @return The descriptor request, never {@code null}.
*/
public ArtifactDescriptorRequest getRequest()
{
return request;
}
/**
* Gets the exceptions that occurred while reading the artifact descriptor.
*
* @return The exceptions that occurred, never {@code null}.
*/
public List getExceptions()
{
return exceptions;
}
/**
* Sets the exceptions that occurred while reading the artifact descriptor.
*
* @param exceptions The exceptions that occurred, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setExceptions( List exceptions )
{
if ( exceptions == null )
{
this.exceptions = new ArrayList( 2 );
}
else
{
this.exceptions = exceptions;
}
return this;
}
/**
* Records the specified exception while reading the artifact descriptor.
*
* @param exception The exception to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addException( Exception exception )
{
if ( exception != null )
{
this.exceptions.add( exception );
}
return this;
}
/**
* Gets the relocations that were processed to read the artifact descriptor. The returned list denotes the hops that
* lead to the final artifact coordinates as given by {@link #getArtifact()}.
*
* @return The relocations that were processed, never {@code null}.
*/
public List getRelocations()
{
return relocations;
}
/**
* Sets the relocations that were processed to read the artifact descriptor.
*
* @param relocations The relocations that were processed, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setRelocations( List relocations )
{
if ( relocations == null )
{
this.relocations = new ArrayList( 2 );
}
else
{
this.relocations = relocations;
}
return this;
}
/**
* Records the specified relocation hop while locating the artifact descriptor.
*
* @param artifact The artifact that got relocated, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addRelocation( Artifact artifact )
{
if ( artifact != null )
{
relocations.add( artifact );
}
return this;
}
/**
* Gets the known aliases for this artifact. An alias denotes a different artifact with (almost) the same contents
* and can be used to mark a patched rebuild of some other artifact as such, thereby allowing conflict resolution to
* consider the patched and the original artifact as a conflict.
*
* @return The aliases of the artifact, never {@code null}.
*/
public Collection getAliases()
{
return aliases;
}
/**
* Sets the aliases of the artifact.
*
* @param aliases The aliases of the artifact, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setAliases( Collection aliases )
{
if ( aliases == null )
{
this.aliases = new ArrayList( 0 );
}
else
{
this.aliases = aliases;
}
return this;
}
/**
* Records the specified alias.
*
* @param alias The alias for the artifact, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addAlias( Artifact alias )
{
if ( alias != null )
{
aliases.add( alias );
}
return this;
}
/**
* Gets the artifact whose descriptor was read. This can be a different artifact than originally requested in case
* relocations were encountered.
*
* @return The artifact after following any relocations, never {@code null}.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact whose descriptor was read.
*
* @param artifact The artifact whose descriptor was read, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the repository from which the descriptor was eventually resolved.
*
* @return The repository from which the descriptor was resolved or {@code null} if unknown.
*/
public ArtifactRepository getRepository()
{
return repository;
}
/**
* Sets the repository from which the descriptor was resolved.
*
* @param repository The repository from which the descriptor was resolved, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setRepository( ArtifactRepository repository )
{
this.repository = repository;
return this;
}
/**
* Gets the list of direct dependencies of the artifact.
*
* @return The list of direct dependencies, never {@code null}
*/
public List getDependencies()
{
return dependencies;
}
/**
* Sets the list of direct dependencies of the artifact.
*
* @param dependencies The list of direct dependencies, may be {@code null}
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setDependencies( List dependencies )
{
if ( dependencies == null )
{
this.dependencies = new ArrayList();
}
else
{
this.dependencies = dependencies;
}
return this;
}
/**
* Adds the specified direct dependency.
*
* @param dependency The direct dependency to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addDependency( Dependency dependency )
{
if ( dependency != null )
{
dependencies.add( dependency );
}
return this;
}
/**
* Gets the dependency management information.
*
* @return The dependency management information.
*/
public List getManagedDependencies()
{
return managedDependencies;
}
/**
* Sets the dependency management information.
*
* @param dependencies The dependency management information, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setManagedDependencies( List dependencies )
{
if ( dependencies == null )
{
this.managedDependencies = new ArrayList();
}
else
{
this.managedDependencies = dependencies;
}
return this;
}
/**
* Adds the specified managed dependency.
*
* @param dependency The managed dependency to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addManagedDependency( Dependency dependency )
{
if ( dependency != null )
{
managedDependencies.add( dependency );
}
return this;
}
/**
* Gets the remote repositories listed in the artifact descriptor.
*
* @return The remote repositories listed in the artifact descriptor, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the remote repositories listed in the artifact descriptor.
*
* @param repositories The remote repositories listed in the artifact descriptor, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = new ArrayList( 2 );
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified remote repository.
*
* @param repository The remote repository to add, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult addRepository( RemoteRepository repository )
{
if ( repository != null )
{
repositories.add( repository );
}
return this;
}
/**
* Gets any additional information about the artifact in form of key-value pairs.
*
* @return The additional information about the artifact, never {@code null}.
*/
public Map getProperties()
{
return properties;
}
/**
* Sets any additional information about the artifact in form of key-value pairs.
*
* @param properties The additional information about the artifact, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactDescriptorResult setProperties( Map properties )
{
if ( properties == null )
{
this.properties = Collections.emptyMap();
}
else
{
this.properties = properties;
}
return this;
}
@Override
public String toString()
{
return getArtifact() + " -> " + getDependencies();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/ArtifactRequest.java 0000664 0000000 0000000 00000014205 11670505567 0031613 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.graph.DependencyNode;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to resolve an artifact.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveArtifacts(RepositorySystemSession, java.util.Collection)
* @see Artifact#getFile()
*/
public class ArtifactRequest
{
private Artifact artifact;
private DependencyNode node;
private List repositories = Collections.emptyList();
private String context = "";
private RequestTrace trace;
/**
* Creates an unitialized request.
*/
public ArtifactRequest()
{
// enables default constructor
}
/**
* Creates a request with the specified properties.
*
* @param artifact The artifact to resolve, may be {@code null}.
* @param repositories The repositories to resolve the artifact from, may be {@code null}.
* @param context The context in which this request is made, may be {@code null}.
*/
public ArtifactRequest( Artifact artifact, List repositories, String context )
{
setArtifact( artifact );
setRepositories( repositories );
setRequestContext( context );
}
/**
* Creates a request from the specified dependency node.
*
* @param node The dependency node to resolve, may be {@code null}.
*/
public ArtifactRequest( DependencyNode node )
{
setDependencyNode( node );
setRepositories( node.getRepositories() );
setRequestContext( node.getRequestContext() );
}
/**
* Gets the artifact to resolve.
*
* @return The artifact to resolve or {@code null}.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact to resolve.
*
* @param artifact The artifact to resolve, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the dependency node (if any) for which to resolve the artifact.
*
* @return The dependency node to resolve or {@code null} if unknown.
*/
public DependencyNode getDependencyNode()
{
return node;
}
/**
* Sets the dependency node to resolve.
*
* @param node The dependency node to resolve, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest setDependencyNode( DependencyNode node )
{
this.node = node;
if ( node != null )
{
setArtifact( node.getDependency().getArtifact() );
}
return this;
}
/**
* Gets the repositories to resolve the version range from.
*
* @return The repositories, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the repositories to resolve the artifact from.
*
* @param repositories The repositories, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = Collections.emptyList();
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified repository for the resolution.
*
* @param repository The repository to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest addRepository( RemoteRepository repository )
{
if ( repository != null )
{
if ( this.repositories.isEmpty() )
{
this.repositories = new ArrayList();
}
this.repositories.add( repository );
}
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public ArtifactRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifact() + " < " + getRepositories();
}
}
ArtifactResolutionException.java 0000664 0000000 0000000 00000006063 11670505567 0034131 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.transfer.ArtifactNotFoundException;
/**
* Thrown in case of a unresolvable artifacts.
*
* @author Benjamin Bentmann
*/
public class ArtifactResolutionException
extends RepositoryException
{
private final List results;
public ArtifactResolutionException( List results )
{
super( getMessage( results ), getCause( results ) );
this.results = ( results != null ) ? results : Collections. emptyList();
}
public List getResults()
{
return results;
}
public ArtifactResult getResult()
{
return !results.isEmpty() ? results.get( 0 ) : null;
}
private static String getMessage( List results )
{
StringBuilder buffer = new StringBuilder( 256 );
buffer.append( "The following artifacts could not be resolved: " );
int unresolved = 0;
String sep = "";
for ( ArtifactResult result : results )
{
if ( !result.isResolved() )
{
unresolved++;
buffer.append( sep );
buffer.append( result.getRequest().getArtifact() );
sep = ", ";
}
}
Throwable cause = getCause( results );
if ( cause != null )
{
if ( unresolved == 1 )
{
buffer.setLength( 0 );
buffer.append( cause.getMessage() );
}
else
{
buffer.append( ": " ).append( cause.getMessage() );
}
}
return buffer.toString();
}
private static Throwable getCause( List results )
{
for ( ArtifactResult result : results )
{
if ( !result.isResolved() )
{
Throwable nf = null;
for ( Throwable t : result.getExceptions() )
{
if ( t instanceof ArtifactNotFoundException )
{
if ( nf == null )
{
nf = t;
}
}
else
{
return t;
}
}
if ( nf != null )
{
return nf;
}
}
}
return null;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/ArtifactResult.java 0000664 0000000 0000000 00000012230 11670505567 0031435 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.ArtifactRepository;
import org.sonatype.aether.transfer.ArtifactNotFoundException;
/**
* The result of an artifact resolution request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveArtifacts(RepositorySystemSession, java.util.Collection)
* @see Artifact#getFile()
*/
public class ArtifactResult
{
private final ArtifactRequest request;
private final List exceptions;
private Artifact artifact;
private ArtifactRepository repository;
/**
* Creates a new result for the specified request.
*
* @param request The resolution request, must not be {@code null}.
*/
public ArtifactResult( ArtifactRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "resolution request has not been specified" );
}
this.request = request;
this.exceptions = new ArrayList( 2 );
}
/**
* Gets the resolution request that was made.
*
* @return The resolution request, never {@code null}.
*/
public ArtifactRequest getRequest()
{
return request;
}
/**
* Gets the resolved artifact (if any). Use {@link #getExceptions()} to query the errors that occurred while trying
* to resolve the artifact.
*
* @return The resolved artifact or {@code null} if the resolution failed.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the resolved artifact.
*
* @param artifact The resolved artifact, may be {@code null} if the resolution failed.
* @return This result for chaining, never {@code null}.
*/
public ArtifactResult setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the exceptions that occurred while resolving the artifact. Note that this list can be non-empty even if the
* artifact was successfully resolved, e.g. when one of the contacted remote repositories didn't contain the
* artifact but a later repository eventually contained it.
*
* @return The exceptions that occurred, never {@code null}.
* @see #isResolved()
*/
public List getExceptions()
{
return exceptions;
}
/**
* Records the specified exception while resolving the artifact.
*
* @param exception The exception to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactResult addException( Exception exception )
{
if ( exception != null )
{
this.exceptions.add( exception );
}
return this;
}
/**
* Gets the repository from which the artifact was eventually resolved.
*
* @return The repository from which the artifact was resolved or {@code null} if unknown.
*/
public ArtifactRepository getRepository()
{
return repository;
}
/**
* Sets the repository from which the artifact was resolved.
*
* @param repository The repository from which the artifact was resolved, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public ArtifactResult setRepository( ArtifactRepository repository )
{
this.repository = repository;
return this;
}
/**
* Indicates whether the requested artifact was resolved. Note that the artifact might have been successfully
* resolved despite {@link #getExceptions()} indicating transfer errors while trying to fetch the artifact from some
* of the specified remote repositories.
*
* @return {@code true} if the artifact was resolved, {@code false} otherwise.
* @see Artifact#getFile()
*/
public boolean isResolved()
{
return getArtifact() != null && getArtifact().getFile() != null;
}
/**
* Indicates whether the requested artifact is not present in any of the specified repositories.
*
* @return {@code true} if the artifact is not present in any repository, {@code false} otherwise.
*/
public boolean isMissing()
{
for ( Exception e : getExceptions() )
{
if ( !( e instanceof ArtifactNotFoundException ) )
{
return false;
}
}
return !isResolved();
}
@Override
public String toString()
{
return getArtifact() + " < " + getRepository();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/DependencyRequest.java 0000664 0000000 0000000 00000014245 11670505567 0032140 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.collection.CollectRequest;
import org.sonatype.aether.graph.DependencyFilter;
import org.sonatype.aether.graph.DependencyNode;
/**
* A request to resolve transitive dependencies. This request can either be supplied with a {@link CollectRequest} to
* calculate the transitive dependencies or with an already resolved dependency graph.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveDependencies(RepositorySystemSession, DependencyRequest)
* @see Artifact#getFile()
*/
public class DependencyRequest
{
private DependencyNode root;
private CollectRequest collectRequest;
private DependencyFilter filter;
private RequestTrace trace;
/**
* Creates an uninitialized request. Note that either {@link #setRoot(DependencyNode)} or
* {@link #setCollectRequest(CollectRequest)} must eventually be called to create a valid request.
*/
public DependencyRequest()
{
// enables default constructor
}
/**
* Creates a request for the specified dependency graph and with the given resolution filter.
*
* @param node The root node of the dependency graph whose artifacts should be resolved, may be {@code null}.
* @param filter The resolution filter to use, may be {@code null}.
*/
public DependencyRequest( DependencyNode node, DependencyFilter filter )
{
setRoot( node );
setFilter( filter );
}
/**
* Creates a request for the specified collect request and with the given resolution filter.
*
* @param request The collect request used to calculate the dependency graph whose artifacts should be resolved, may
* be {@code null}.
* @param filter The resolution filter to use, may be {@code null}.
*/
public DependencyRequest( CollectRequest request, DependencyFilter filter )
{
setCollectRequest( request );
setFilter( filter );
}
/**
* Gets the root node of the dependency graph whose artifacts should be resolved.
*
* @return The root node of the dependency graph or {@code null} if none.
*/
public DependencyNode getRoot()
{
return root;
}
/**
* Sets the root node of the dependency graph whose artifacts should be resolved. When this request is processed,
* the nodes of the given dependency graph will be updated to refer to the resolved artifacts. Eventually, either
* {@link #setRoot(DependencyNode)} or {@link #setCollectRequest(CollectRequest)} must be called to create a valid
* request.
*
* @param root The root node of the dependency graph, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DependencyRequest setRoot( DependencyNode root )
{
this.root = root;
return this;
}
/**
* Gets the collect request used to calculate the dependency graph whose artifacts should be resolved.
*
* @return The collect request or {@code null} if none.
*/
public CollectRequest getCollectRequest()
{
return collectRequest;
}
/**
* Sets the collect request used to calculate the dependency graph whose artifacts should be resolved. Eventually,
* either {@link #setRoot(DependencyNode)} or {@link #setCollectRequest(CollectRequest)} must be called to create a
* valid request. If this request is supplied with a dependency node via {@link #setRoot(DependencyNode)}, the
* collect request is ignored.
*
* @param collectRequest The collect request, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DependencyRequest setCollectRequest( CollectRequest collectRequest )
{
this.collectRequest = collectRequest;
return this;
}
/**
* Gets the resolution filter used to select which artifacts of the dependency graph should be resolved.
*
* @return The resolution filter or {@code null} to resolve all artifacts of the dependency graph.
*/
public DependencyFilter getFilter()
{
return filter;
}
/**
* Sets the resolution filter used to select which artifacts of the dependency graph should be resolved. For
* example, use this filter to restrict resolution to dependencies of a certain scope.
*
* @param filter The resolution filter, may be {@code null} to resolve all artifacts of the dependency graph.
* @return This request for chaining, never {@code null}.
*/
public DependencyRequest setFilter( DependencyFilter filter )
{
this.filter = filter;
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public DependencyRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
if ( root != null )
{
return String.valueOf( root );
}
return String.valueOf( collectRequest );
}
}
DependencyResolutionException.java 0000664 0000000 0000000 00000002476 11670505567 0034456 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of a unresolvable dependencies.
*
* @author Benjamin Bentmann
*/
public class DependencyResolutionException
extends RepositoryException
{
private final DependencyResult result;
public DependencyResolutionException( DependencyResult result, Throwable cause )
{
super( getMessage( cause ), cause );
this.result = result;
}
private static String getMessage( Throwable cause )
{
String msg = null;
if ( cause != null )
{
msg = cause.getMessage();
}
if ( msg == null || msg.length() <= 0 )
{
msg = "Could not resolve transitive dependencies";
}
return msg;
}
public DependencyResult getResult()
{
return result;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/DependencyResult.java 0000664 0000000 0000000 00000010223 11670505567 0031756 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.graph.DependencyNode;
/**
* The result of a dependency resolution request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveDependencies(RepositorySystemSession, DependencyRequest)
*/
public class DependencyResult
{
private final DependencyRequest request;
private DependencyNode root;
private List collectExceptions;
private List artifactResults;
/**
* Creates a new result for the specified request.
*
* @param request The resolution request, must not be {@code null}.
*/
public DependencyResult( DependencyRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "dependency request has not been specified" );
}
this.request = request;
this.root = request.getRoot();
this.collectExceptions = new ArrayList( 2 );
this.artifactResults = new ArrayList( 2 );
}
/**
* Gets the resolution request that was made.
*
* @return The resolution request, never {@code null}.
*/
public DependencyRequest getRequest()
{
return request;
}
/**
* Gets the root node of the resolved dependency graph. Note that this dependency graph might be
* incomplete/unfinished in case of {@link #getCollectExceptions()} indicating errors during its calculation.
*
* @return The root node of the resolved dependency graph or {@code null} if none.
*/
public DependencyNode getRoot()
{
return root;
}
/**
* Sets the root node of the resolved dependency graph.
*
* @param root The root node of the resolved dependency graph, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DependencyResult setRoot( DependencyNode root )
{
this.root = root;
return this;
}
/**
* Gets the exceptions that occurred while building the dependency graph.
*
* @return The exceptions that occurred, never {@code null}.
*/
public List getCollectExceptions()
{
return collectExceptions;
}
/**
* Records the specified exceptions while building the dependency graph.
*
* @param exceptions The exceptions to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DependencyResult setCollectExceptions( List exceptions )
{
this.collectExceptions = ( exceptions != null ) ? exceptions : new ArrayList();
return this;
}
/**
* Gets the resolution results for the dependency artifacts that matched {@link DependencyRequest#getFilter()}.
*
* @return The resolution results for the dependency artifacts, never {@code null}.
*/
public List getArtifactResults()
{
return artifactResults;
}
/**
* Sets the resolution results for the artifacts that matched {@link DependencyRequest#getFilter()}.
*
* @param results The resolution results for the artifacts, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public DependencyResult setArtifactResults( List results )
{
this.artifactResults = ( results != null ) ? results : new ArrayList();
return this;
}
@Override
public String toString()
{
return String.valueOf( artifactResults );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/MetadataRequest.java 0000664 0000000 0000000 00000016425 11670505567 0031604 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.metadata.Metadata;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to resolve metadata from either a remote repository or the local repository.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveMetadata(RepositorySystemSession, java.util.Collection)
* @see Metadata#getFile()
*/
public class MetadataRequest
{
private Metadata metadata;
private RemoteRepository repository;
private String context = "";
private boolean deleteLocalCopyIfMissing;
private boolean favorLocalRepository;
private RequestTrace trace;
/**
* Creates an unitialized request.
*/
public MetadataRequest()
{
// enables default constructor
}
/**
* Creates a request to resolve the specified metadata from the local repository.
*
* @param metadata The metadata to resolve, may be {@code null}.
*/
public MetadataRequest( Metadata metadata )
{
setMetadata( metadata );
}
/**
* Creates a request with the specified properties.
*
* @param metadata The metadata to resolve, may be {@code null}.
* @param repository The repository to resolve the metadata from, may be {@code null} to resolve from the local
* repository.
* @param context The context in which this request is made, may be {@code null}.
*/
public MetadataRequest( Metadata metadata, RemoteRepository repository, String context )
{
setMetadata( metadata );
setRepository( repository );
setRequestContext( context );
}
/**
* Gets the metadata to resolve.
*
* @return The metadata or {@code null} if not set.
*/
public Metadata getMetadata()
{
return metadata;
}
/**
* Sets the metadata to resolve.
*
* @param metadata The metadata, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setMetadata( Metadata metadata )
{
this.metadata = metadata;
return this;
}
/**
* Gets the repository from which the metadata should be resolved.
*
* @return The repository or {@code null} to resolve from the local repository.
*/
public RemoteRepository getRepository()
{
return repository;
}
/**
* Sets the repository from which the metadata should be resolved.
*
* @param repository The repository, may be {@code null} to resolve from the local repository.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setRepository( RemoteRepository repository )
{
this.repository = repository;
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Indicates whether the locally cached copy of the metadata should be removed if the corresponding file does not
* exist (any more) in the remote repository.
*
* @return {@code true} if locally cached metadata should be deleted if no corresponding remote file exists,
* {@code false} to keep the local copy.
*/
public boolean isDeleteLocalCopyIfMissing()
{
return deleteLocalCopyIfMissing;
}
/**
* Controls whether the locally cached copy of the metadata should be removed if the corresponding file does not
* exist (any more) in the remote repository.
*
* @param deleteLocalCopyIfMissing {@code true} if locally cached metadata should be deleted if no corresponding
* remote file exists, {@code false} to keep the local copy.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setDeleteLocalCopyIfMissing( boolean deleteLocalCopyIfMissing )
{
this.deleteLocalCopyIfMissing = deleteLocalCopyIfMissing;
return this;
}
/**
* Indicates whether the metadata resolution should be suppressed if the corresponding metadata of the local
* repository is up-to-date according to the update policy of the remote repository. In this case, the metadata
* resolution will even be suppressed if no local copy of the remote metadata exists yet.
*
* @return {@code true} to suppress resolution of remote metadata if the corresponding metadata of the local
* repository is up-to-date, {@code false} to resolve the remote metadata normally according to the update
* policy.
*/
public boolean isFavorLocalRepository()
{
return favorLocalRepository;
}
/**
* Controls resolution of remote metadata when already corresponding metadata of the local repository exists. In
* cases where the local repository's metadata is sufficient and going to be preferred, resolution of the remote
* metadata can be suppressed to avoid unnecessary network access.
*
* @param favorLocalRepository {@code true} to suppress resolution of remote metadata if the corresponding metadata
* of the local repository is up-to-date, {@code false} to resolve the remote metadata normally according
* to the update policy.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setFavorLocalRepository( boolean favorLocalRepository )
{
this.favorLocalRepository = favorLocalRepository;
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public MetadataRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getMetadata() + " < " + getRepository();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/MetadataResult.java 0000664 0000000 0000000 00000011442 11670505567 0031424 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.metadata.Metadata;
import org.sonatype.aether.transfer.MetadataNotFoundException;
/**
* The result of a metadata resolution request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveMetadata(RepositorySystemSession, java.util.Collection)
*/
public class MetadataResult
{
private final MetadataRequest request;
private Exception exception;
private boolean updated;
private Metadata metadata;
/**
* Creates a new result for the specified request.
*
* @param request The resolution request, must not be {@code null}.
*/
public MetadataResult( MetadataRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "metadata request has not been specified" );
}
this.request = request;
}
/**
* Gets the resolution request that was made.
*
* @return The resolution request, never {@code null}.
*/
public MetadataRequest getRequest()
{
return request;
}
/**
* Gets the resolved metadata (if any).
*
* @return The resolved metadata or {@code null} if the resolution failed.
*/
public Metadata getMetadata()
{
return metadata;
}
/**
* Sets the resolved metadata.
*
* @param metadata The resolved metadata, may be {@code null} if the resolution failed.
* @return This result for chaining, never {@code null}.
*/
public MetadataResult setMetadata( Metadata metadata )
{
this.metadata = metadata;
return this;
}
/**
* Records the specified exception while resolving the metadata.
*
* @param exception The exception to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public MetadataResult setException( Exception exception )
{
this.exception = exception;
return this;
}
/**
* Gets the exception that occurred while resolving the metadata.
*
* @return The exception that occurred or {@code null} if none.
*/
public Exception getException()
{
return exception;
}
/**
* Sets the updated flag for the metadata.
*
* @param updated {@code true} if the metadata was actually fetched from the remote repository during the
* resolution, {@code false} if the metadata was resolved from a locally cached copy.
* @return This result for chaining, never {@code null}.
*/
public MetadataResult setUpdated( boolean updated )
{
this.updated = updated;
return this;
}
/**
* Indicates whether the metadata was actually fetched from the remote repository or resolved from the local cache.
* If metadata has been locally cached during a previous resolution request and this local copy is still up-to-date
* according to the remote repository's update policy, no remote access is made.
*
* @return {@code true} if the metadata was actually fetched from the remote repository during the resolution,
* {@code false} if the metadata was resolved from a locally cached copy.
*/
public boolean isUpdated()
{
return updated;
}
/**
* Indicates whether the requested metadata was resolved. Note that the metadata might have been successfully
* resolved (from the local cache) despite {@link #getException()} indicating a transfer error while trying to
* refetch the metadata from the remote repository.
*
* @return {@code true} if the metadata was resolved, {@code false} otherwise.
* @see Metadata#getFile()
*/
public boolean isResolved()
{
return getMetadata() != null && getMetadata().getFile() != null;
}
/**
* Indicates whether the requested metadata is not present in the remote repository.
*
* @return {@code true} if the metadata is not present in the remote repository, {@code false} otherwise.
*/
public boolean isMissing()
{
return getException() instanceof MetadataNotFoundException;
}
@Override
public String toString()
{
return getMetadata() + ( isUpdated() ? " (updated)" : " (cached)" );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/VersionRangeRequest.java 0000664 0000000 0000000 00000012152 11670505567 0032457 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to resolve a version range.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveVersionRange(RepositorySystemSession, VersionRangeRequest)
*/
public class VersionRangeRequest
{
private Artifact artifact;
private List repositories = Collections.emptyList();
private String context = "";
private RequestTrace trace;
/**
* Creates an uninitialized request.
*/
public VersionRangeRequest()
{
// enables default constructor
}
/**
* Creates a request with the specified properties.
*
* @param artifact The artifact whose version range should be resolved, may be {@code null}.
* @param repositories The repositories to resolve the version from, may be {@code null}.
* @param context The context in which this request is made, may be {@code null}.
*/
public VersionRangeRequest( Artifact artifact, List repositories, String context )
{
setArtifact( artifact );
setRepositories( repositories );
setRequestContext( context );
}
/**
* Gets the artifact whose version range shall be resolved.
*
* @return The artifact or {@code null} if not set.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact whose version range shall be resolved.
*
* @param artifact The artifact, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRangeRequest setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the repositories to resolve the version range from.
*
* @return The repositories, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the repositories to resolve the version range from.
*
* @param repositories The repositories, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRangeRequest setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = Collections.emptyList();
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified repository for the resolution.
*
* @param repository The repository to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRangeRequest addRepository( RemoteRepository repository )
{
if ( repository != null )
{
if ( this.repositories.isEmpty() )
{
this.repositories = new ArrayList();
}
this.repositories.add( repository );
}
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRangeRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRangeRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifact() + " < " + getRepositories();
}
}
VersionRangeResolutionException.java 0000664 0000000 0000000 00000003731 11670505567 0034775 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of an unparseable or unresolvable version range.
*
* @author Benjamin Bentmann
*/
public class VersionRangeResolutionException
extends RepositoryException
{
private final VersionRangeResult result;
public VersionRangeResolutionException( VersionRangeResult result )
{
super( getMessage( result ), getCause( result ) );
this.result = result;
}
private static String getMessage( VersionRangeResult result )
{
StringBuilder buffer = new StringBuilder( 256 );
buffer.append( "Failed to resolve version range" );
if ( result != null )
{
buffer.append( " for " ).append( result.getRequest().getArtifact() );
if ( !result.getExceptions().isEmpty() )
{
buffer.append( ": " ).append( result.getExceptions().iterator().next().getMessage() );
}
}
return buffer.toString();
}
private static Throwable getCause( VersionRangeResult result )
{
Throwable cause = null;
if ( result != null && !result.getExceptions().isEmpty() )
{
cause = result.getExceptions().get( 0 );
}
return cause;
}
public VersionRangeResolutionException( VersionRangeResult result, String message )
{
super( message );
this.result = result;
}
public VersionRangeResult getResult()
{
return result;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/VersionRangeResult.java 0000664 0000000 0000000 00000014307 11670505567 0032311 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.repository.ArtifactRepository;
import org.sonatype.aether.version.Version;
import org.sonatype.aether.version.VersionConstraint;
/**
* The result of a version range resolution request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveVersionRange(RepositorySystemSession, VersionRangeRequest)
*/
public class VersionRangeResult
{
private final VersionRangeRequest request;
private final List exceptions;
private List versions;
private final 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;
this.exceptions = new ArrayList( 4 );
versions = new ArrayList();
repositories = new HashMap();
}
/**
* 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 )
{
this.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.
*
* @param version The version to add, must not be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public VersionRangeResult addVersion( Version version )
{
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 )
{
this.versions = ( versions != null ) ? versions : new ArrayList();
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 )
{
this.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 );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/VersionRequest.java 0000664 0000000 0000000 00000012055 11670505567 0031504 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.RequestTrace;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
/**
* A request to resolve a metaversion.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveVersion(RepositorySystemSession, VersionRequest)
*/
public class VersionRequest
{
private Artifact artifact;
private List repositories = Collections.emptyList();
private String context = "";
private RequestTrace trace;
/**
* Creates an uninitialized request.
*/
public VersionRequest()
{
// enables default constructor
}
/**
* Creates a request with the specified properties.
*
* @param artifact The artifact whose (meta-)version should be resolved, may be {@code null}.
* @param repositories The repositories to resolve the version from, may be {@code null}.
* @param context The context in which this request is made, may be {@code null}.
*/
public VersionRequest( Artifact artifact, List repositories, String context )
{
setArtifact( artifact );
setRepositories( repositories );
setRequestContext( context );
}
/**
* Gets the artifact whose (meta-)version shall be resolved.
*
* @return The artifact or {@code null} if not set.
*/
public Artifact getArtifact()
{
return artifact;
}
/**
* Sets the artifact whose (meta-)version shall be resolved.
*
* @param artifact The artifact, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRequest setArtifact( Artifact artifact )
{
this.artifact = artifact;
return this;
}
/**
* Gets the repositories to resolve the version from.
*
* @return The repositories, never {@code null}.
*/
public List getRepositories()
{
return repositories;
}
/**
* Sets the repositories to resolve the version from.
*
* @param repositories The repositories, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRequest setRepositories( List repositories )
{
if ( repositories == null )
{
this.repositories = Collections.emptyList();
}
else
{
this.repositories = repositories;
}
return this;
}
/**
* Adds the specified repository for the resolution.
*
* @param repository The repository to add, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRequest addRepository( RemoteRepository repository )
{
if ( repository != null )
{
if ( this.repositories.isEmpty() )
{
this.repositories = new ArrayList();
}
this.repositories.add( repository );
}
return this;
}
/**
* Gets the context in which this request is made.
*
* @return The context, never {@code null}.
*/
public String getRequestContext()
{
return context;
}
/**
* Sets the context in which this request is made.
*
* @param context The context, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRequest setRequestContext( String context )
{
this.context = ( context != null ) ? context : "";
return this;
}
/**
* Gets the trace information that describes the higher level request/operation in which this request is issued.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
public RequestTrace getTrace()
{
return trace;
}
/**
* Sets the trace information that describes the higher level request/operation in which this request is issued.
*
* @param trace The trace information about the higher level operation, may be {@code null}.
* @return This request for chaining, never {@code null}.
*/
public VersionRequest setTrace( RequestTrace trace )
{
this.trace = trace;
return this;
}
@Override
public String toString()
{
return getArtifact() + " < " + getRepositories();
}
}
VersionResolutionException.java 0000664 0000000 0000000 00000003402 11670505567 0034013 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of an unresolvable metaversion.
*
* @author Benjamin Bentmann
*/
public class VersionResolutionException
extends RepositoryException
{
private final VersionResult result;
public VersionResolutionException( VersionResult result )
{
super( getMessage( result ), getCause( result ) );
this.result = result;
}
private static String getMessage( VersionResult result )
{
StringBuilder buffer = new StringBuilder( 256 );
buffer.append( "Failed to resolve version" );
if ( result != null )
{
buffer.append( " for " ).append( result.getRequest().getArtifact() );
if ( !result.getExceptions().isEmpty() )
{
buffer.append( ": " ).append( result.getExceptions().iterator().next().getMessage() );
}
}
return buffer.toString();
}
private static Throwable getCause( VersionResult result )
{
Throwable cause = null;
if ( result != null && !result.getExceptions().isEmpty() )
{
cause = result.getExceptions().get( 0 );
}
return cause;
}
public VersionResult getResult()
{
return result;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/resolution/VersionResult.java 0000664 0000000 0000000 00000007127 11670505567 0031336 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.resolution;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.ArrayList;
import java.util.List;
import org.sonatype.aether.RepositorySystem;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.repository.ArtifactRepository;
/**
* The result of a version resolution request.
*
* @author Benjamin Bentmann
* @see RepositorySystem#resolveVersion(RepositorySystemSession, VersionRequest)
*/
public class VersionResult
{
private final VersionRequest request;
private final List exceptions;
private String version;
private ArtifactRepository repository;
/**
* Creates a new result for the specified request.
*
* @param request The resolution request, must not be {@code null}.
*/
public VersionResult( VersionRequest request )
{
if ( request == null )
{
throw new IllegalArgumentException( "version request has not been specified" );
}
this.request = request;
this.exceptions = new ArrayList( 4 );
}
/**
* Gets the resolution request that was made.
*
* @return The resolution request, never {@code null}.
*/
public VersionRequest getRequest()
{
return request;
}
/**
* Gets the exceptions that occurred while resolving the version.
*
* @return The exceptions that occurred, never {@code null}.
*/
public List getExceptions()
{
return exceptions;
}
/**
* Records the specified exception while resolving the version.
*
* @param exception The exception to record, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public VersionResult addException( Exception exception )
{
if ( exception != null )
{
this.exceptions.add( exception );
}
return this;
}
/**
* Gets the resolved version.
*
* @return The resolved version or {@code null} if the resolution failed.
*/
public String getVersion()
{
return version;
}
/**
* Sets the resolved version.
*
* @param version The resolved version, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public VersionResult setVersion( String version )
{
this.version = version;
return this;
}
/**
* Gets the repository from which the version was eventually resolved.
*
* @return The repository from which the version was resolved or {@code null} if unknown.
*/
public ArtifactRepository getRepository()
{
return repository;
}
/**
* Sets the repository from which the version was resolved.
*
* @param repository The repository from which the version was resolved, may be {@code null}.
* @return This result for chaining, never {@code null}.
*/
public VersionResult setRepository( ArtifactRepository repository )
{
this.repository = repository;
return this;
}
@Override
public String toString()
{
return getVersion() + " @ " + getRepository();
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/ 0000775 0000000 0000000 00000000000 11670505567 0025261 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/AbstractTransferListener.java 0000664 0000000 0000000 00000002435 11670505567 0033106 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A skeleton implementation for custom transfer listeners. The callback methods in this class do nothing.
*
* @author Benjamin Bentmann
*/
public abstract class AbstractTransferListener
implements TransferListener
{
public void transferInitiated( TransferEvent event )
throws TransferCancelledException
{
}
public void transferStarted( TransferEvent event )
throws TransferCancelledException
{
}
public void transferProgressed( TransferEvent event )
throws TransferCancelledException
{
}
public void transferCorrupted( TransferEvent event )
throws TransferCancelledException
{
}
public void transferSucceeded( TransferEvent event )
{
}
public void transferFailed( TransferEvent event )
{
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/ArtifactNotFoundException.java 0000664 0000000 0000000 00000003112 11670505567 0033212 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
/**
* Thrown when an artifact was not found in a particular repository.
*
* @author Benjamin Bentmann
*/
public class ArtifactNotFoundException
extends ArtifactTransferException
{
public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository )
{
super( artifact, repository, "Could not find artifact " + artifact + getString( " in ", repository )
+ getLocalPathInfo( artifact, repository ) );
}
private static String getLocalPathInfo( Artifact artifact, RemoteRepository repository )
{
String localPath = ( artifact != null ) ? artifact.getProperty( "localPath", null ) : null;
if ( localPath != null && repository == null )
{
return " at specified path " + localPath;
}
else
{
return "";
}
}
public ArtifactNotFoundException( Artifact artifact, RemoteRepository repository, String message )
{
super( artifact, repository, message );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/ArtifactTransferException.java 0000664 0000000 0000000 00000004175 11670505567 0033254 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.artifact.Artifact;
import org.sonatype.aether.repository.RemoteRepository;
/**
* Thrown when an artifact could not be uploaded/downloaded to/from a particular remote repository.
*
* @author Benjamin Bentmann
*/
public class ArtifactTransferException
extends RepositoryException
{
private final Artifact artifact;
private final RemoteRepository repository;
static String getString( String prefix, RemoteRepository repository )
{
if ( repository == null )
{
return "";
}
else
{
return prefix + repository.getId() + " (" + repository.getUrl() + ")";
}
}
public ArtifactTransferException( Artifact artifact, RemoteRepository repository, String message )
{
super( message );
this.artifact = artifact;
this.repository = repository;
}
public ArtifactTransferException( Artifact artifact, RemoteRepository repository, Throwable cause )
{
super( "Could not transfer artifact " + artifact + getString( " from/to ", repository )
+ getMessage( ": ", cause ), cause );
this.artifact = artifact;
this.repository = repository;
}
public ArtifactTransferException( Artifact artifact, RemoteRepository repository, String message, Throwable cause )
{
super( message, cause );
this.artifact = artifact;
this.repository = repository;
}
public Artifact getArtifact()
{
return artifact;
}
public RemoteRepository getRepository()
{
return repository;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/ChecksumFailureException.java 0000664 0000000 0000000 00000003207 11670505567 0033057 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case of a checksum failure during an artifact/metadata download.
*
* @author Benjamin Bentmann
*/
public class ChecksumFailureException
extends RepositoryException
{
private final String expected;
private final String actual;
public ChecksumFailureException( String expected, String actual )
{
super( "Checksum validation failed, expected " + expected + " but is " + actual );
this.expected = expected;
this.actual = actual;
}
public ChecksumFailureException( String message )
{
super( message );
expected = actual = "";
}
public ChecksumFailureException( Throwable cause )
{
super( "Checksum validation failed, could not read expected checksum" + getMessage( ": ", cause ), cause );
expected = actual = "";
}
public ChecksumFailureException( String message, Throwable cause )
{
super( message, cause );
expected = actual = "";
}
public String getExpected()
{
return expected;
}
public String getActual()
{
return actual;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/MetadataNotFoundException.java 0000664 0000000 0000000 00000003260 11670505567 0033201 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.metadata.Metadata;
import org.sonatype.aether.repository.LocalRepository;
import org.sonatype.aether.repository.RemoteRepository;
/**
* Thrown when metadata was not found in a particular repository.
*
* @author Benjamin Bentmann
*/
public class MetadataNotFoundException
extends MetadataTransferException
{
public MetadataNotFoundException( Metadata metadata, LocalRepository repository )
{
super( metadata, null, "Could not find metadata " + metadata + getString( " in ", repository ) );
}
private static String getString( String prefix, LocalRepository repository )
{
if ( repository == null )
{
return "";
}
else
{
return prefix + repository.getId() + " (" + repository.getBasedir() + ")";
}
}
public MetadataNotFoundException( Metadata metadata, RemoteRepository repository )
{
super( metadata, repository, "Could not find metadata " + metadata + getString( " in ", repository ) );
}
public MetadataNotFoundException( Metadata metadata, RemoteRepository repository, String message )
{
super( metadata, repository, message );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/MetadataTransferException.java 0000664 0000000 0000000 00000004172 11670505567 0033234 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.metadata.Metadata;
import org.sonatype.aether.repository.RemoteRepository;
/**
* Thrown when metadata could not be uploaded/downloaded to/from a particular remote repository.
*
* @author Benjamin Bentmann
*/
public class MetadataTransferException
extends RepositoryException
{
private final Metadata metadata;
private final RemoteRepository repository;
static String getString( String prefix, RemoteRepository repository )
{
if ( repository == null )
{
return "";
}
else
{
return prefix + repository.getId() + " (" + repository.getUrl() + ")";
}
}
public MetadataTransferException( Metadata metadata, RemoteRepository repository, String message )
{
super( message );
this.metadata = metadata;
this.repository = repository;
}
public MetadataTransferException( Metadata metadata, RemoteRepository repository, Throwable cause )
{
super( "Could not transfer metadata " + metadata + getString( " from/to ", repository )
+ getMessage( ": ", cause ), cause );
this.metadata = metadata;
this.repository = repository;
}
public MetadataTransferException( Metadata metadata, RemoteRepository repository, String message, Throwable cause )
{
super( message, cause );
this.metadata = metadata;
this.repository = repository;
}
public Metadata getMetadata()
{
return metadata;
}
public RemoteRepository getRepository()
{
return repository;
}
}
NoRepositoryConnectorException.java 0000664 0000000 0000000 00000003677 11670505567 0034270 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
import org.sonatype.aether.repository.RemoteRepository;
/**
* Thrown in case of an unsupported remote repository type.
*
* @author Benjamin Bentmann
*/
public class NoRepositoryConnectorException
extends RepositoryException
{
private final RemoteRepository repository;
public NoRepositoryConnectorException( RemoteRepository repository )
{
this( repository, toMessage( repository ) );
}
public NoRepositoryConnectorException( RemoteRepository repository, String message )
{
super( message );
this.repository = repository;
}
public NoRepositoryConnectorException( RemoteRepository repository, Throwable cause )
{
this( repository, toMessage( repository ), cause );
}
public NoRepositoryConnectorException( RemoteRepository repository, String message, Throwable cause )
{
super( message, cause );
this.repository = repository;
}
private static String toMessage( RemoteRepository repository )
{
if ( repository != null )
{
return "No connector available to access repository " + repository.getId() + " (" + repository.getUrl()
+ ") of type " + repository.getContentType();
}
else
{
return "No connector available to access repository";
}
}
public RemoteRepository getRepository()
{
return repository;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/TransferCancelledException.java 0000664 0000000 0000000 00000002037 11670505567 0033364 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown in case an upload/download was cancelled (e.g. due to user request).
*
* @author Benjamin Bentmann
*/
public class TransferCancelledException
extends RepositoryException
{
public TransferCancelledException()
{
super( "The operation was cancelled." );
}
public TransferCancelledException( String message )
{
super( message );
}
public TransferCancelledException( String message, Throwable cause )
{
super( message, cause );
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/TransferEvent.java 0000664 0000000 0000000 00000005605 11670505567 0030720 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.nio.ByteBuffer;
/**
* An event fired to a transfer listener during an artifact/metadata transfer.
*
* @author Benjamin Bentmann
* @see TransferListener
*/
public interface TransferEvent
{
/**
* The type of the event.
*/
enum EventType
{
INITIATED, STARTED, PROGRESSED, CORRUPTED, SUCCEEDED, FAILED
}
/**
* The type of the request/transfer.
*/
enum RequestType
{
GET, PUT,
}
/**
* Gets the type of the event.
*
* @return The type of the event, never {@code null}.
*/
EventType getType();
/**
* Gets the type of the request/transfer.
*
* @return The type of the request/transfer, never {@code null}.
*/
RequestType getRequestType();
/**
* Gets the resource that is being transferred.
*
* @return The resource being transferred, never {@code null}.
*/
TransferResource getResource();
/**
* Gets the total number of bytes that have been transferred since the download/upload was started.
*
* @return The total number of bytes that have been transferred since the transfer started, never negative.
* @see #getDataLength()
*/
long getTransferredBytes();
/**
* Gets the byte buffer holding the transferred bytes since the last event. A listener must assume this buffer to be
* owned by the event source and must not change any byte in this buffer. Also, the buffer is only valid for the
* duration of the event callback, i.e. the next event might reuse the same buffer (with updated contents).
* Therefore, if the actual event processing is deferred, the byte buffer would have to be cloned to create an
* immutable snapshot of its contents.
*
* @return The (read-only) byte buffer or {@code null} if not applicable to the event, i.e. if the event type is not
* {@link EventType#PROGRESSED}.
*/
ByteBuffer getDataBuffer();
/**
* Gets the number of bytes that have been transferred since the last event.
*
* @return The number of bytes that have been transferred since the last event, possibly zero but never negative.
* @see #getTransferredBytes()
*/
int getDataLength();
/**
* Gets the error that occurred during the transfer.
*
* @return The error that occurred or {@code null} if none.
*/
Exception getException();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/TransferListener.java 0000664 0000000 0000000 00000006433 11670505567 0031424 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A listener being notified of artifact/metadata transfers from/to remote repositories. The listener may be called from
* an arbitrary thread. Reusing common regular expression syntax, the sequence of events is roughly as follows:
*
*
* INITIATED ( STARTED PROGRESSED* CORRUPTED? )* ( SUCCEEDED | FAILED )
*
*
* Note: Implementors are strongly advised to inherit from {@link AbstractTransferListener} instead of directly
* implementing this interface.
*
* @author Benjamin Bentmann
*/
public interface TransferListener
{
/**
* Notifies the listener about the initiation of a transfer. This event gets fired before any actual network access
* to the remote repository.
*
* @param event The event details, must not be {@code null}.
* @throws TransferCancelledException If the transfer should be aborted.
*/
void transferInitiated( TransferEvent event )
throws TransferCancelledException;
/**
* Notifies the listener about the start of a data transfer, i.e. the successful connection to the remote
* repository.
*
* @param event The event details, must not be {@code null}.
* @throws TransferCancelledException If the transfer should be aborted.
*/
void transferStarted( TransferEvent event )
throws TransferCancelledException;
/**
* Notifies the listener about some progress in the data transfer. This event may even be fired if actually zero
* bytes have been transferred since the last event, for instance to enable cancellation.
*
* @param event The event details, must not be {@code null}.
* @throws TransferCancelledException If the transfer should be aborted.
*/
void transferProgressed( TransferEvent event )
throws TransferCancelledException;
/**
* Notifies the listener that a checksum validation failed. {@link TransferEvent#getException()} will be of type
* {@link ChecksumFailureException} and can be used to query further details about the expected/actual checksums.
*
* @param event The event details, must not be {@code null}.
* @throws TransferCancelledException If the transfer should be aborted.
*/
void transferCorrupted( TransferEvent event )
throws TransferCancelledException;
/**
* Notifies the listener about the successful completion of a transfer.
*
* @param event The event details, must not be {@code null}.
*/
void transferSucceeded( TransferEvent event );
/**
* Notifies the listener about the unsuccessful termination of a transfer. {@link TransferEvent#getException()} will
* provide further information about the failure.
*
* @param event The event details, must not be {@code null}.
*/
void transferFailed( TransferEvent event );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/transfer/TransferResource.java 0000664 0000000 0000000 00000004771 11670505567 0031431 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import org.sonatype.aether.RequestTrace;
/**
* Describes a resource being uploaded or downloaded by the repository system.
*
* @author Benjamin Bentmann
*/
public interface TransferResource
{
/**
* The base URL of the repository, e.g. "http://repo1.maven.org/maven2/". Unless the URL is unknown, it will be
* terminated by a trailing slash.
*
* @return The base URL of the repository or an empty string if unknown, never {@code null}.
*/
String getRepositoryUrl();
/**
* The path of the resource relative to the repository's base URL, e.g. "org/apache/maven/maven/3.0/maven-3.0.pom".
*
* @return The path of the resource, never {@code null}.
*/
String getResourceName();
/**
* Gets the local file being uploaded or downloaded. When the repository system merely checks for the existence of a
* remote resource, no local file will be involved in the transfer.
*
* @return The source/target file involved in the transfer or {@code null} if none.
*/
File getFile();
/**
* The size of the resource in bytes. Note that the size of a resource during downloads might be unknown to the
* client which is usually the case when transfers employ compression like gzip. In general, the content length is
* not known until the transfer has {@link TransferListener#transferStarted(TransferEvent) started}.
*
* @return The size of the resource in bytes or a negative value if unknown.
*/
long getContentLength();
/**
* Gets the timestamp when the transfer of this resource was started.
*
* @return The timestamp when the transfer of this resource was started.
*/
long getTransferStartTime();
/**
* Gets the trace information that describes the higher level request/operation during which this resource is
* transferred.
*
* @return The trace information about the higher level operation or {@code null} if none.
*/
RequestTrace getTrace();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version/ 0000775 0000000 0000000 00000000000 11670505567 0025122 5 ustar 00root root 0000000 0000000 InvalidVersionSpecificationException.java 0000664 0000000 0000000 00000002304 11670505567 0035221 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version package org.sonatype.aether.version;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import org.sonatype.aether.RepositoryException;
/**
* Thrown when a version or version range could not be parsed.
*
* @author Benjamin Bentmann
*/
public class InvalidVersionSpecificationException
extends RepositoryException
{
private final String version;
public InvalidVersionSpecificationException( String version, String message )
{
super( message );
this.version = version;
}
public InvalidVersionSpecificationException( String version, Throwable cause )
{
super( "Could not parse version specification " + version + getMessage( ": ", cause ), cause );
this.version = version;
}
public String getVersion()
{
return version;
}
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version/Version.java 0000664 0000000 0000000 00000001431 11670505567 0027411 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.version;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A parsed artifact version.
*
* @author Benjamin Bentmann
*/
public interface Version
extends Comparable
{
/**
* Gets the original string representation of the version.
*
* @return The string representation of the version.
*/
String toString();
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version/VersionConstraint.java 0000664 0000000 0000000 00000003516 11670505567 0031464 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.version;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.util.Collection;
/**
* A constraint on versions for a dependency. A constraint can either consist of one or more version ranges or a single
* version. In the first case, the constraint expresses a hard requirement on a version matching one of its ranges. In
* the second case, the constraint expresses a soft requirement on a specific version (i.e. a recommendation).
*
* @author Benjamin Bentmann
*/
public interface VersionConstraint
{
/**
* Gets the version ranges of this constraint.
*
* @return The version ranges, may be empty but never {@code null}.
*/
Collection getRanges();
/**
* Gets the version recommended by this constraint.
*
* @return The recommended version or {@code null} if none.
*/
Version getVersion();
/**
* Determines whether the specified version satisfies this constraint. In more detail, a version satisfies this
* constraint if it matches at least one version range or if this constraint has no version ranges at all and the
* specified version equals the version recommended by the constraint.
*
* @param version The version to test, must not be {@code null}.
* @return {@code true} if the specified version satisfies this constraint, {@code false} otherwise.
*/
boolean containsVersion( Version version );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version/VersionRange.java 0000664 0000000 0000000 00000001621 11670505567 0030367 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.version;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A range of versions.
*
* @author Benjamin Bentmann
*/
public interface VersionRange
{
/**
* Determines whether the specified version is contained within this range.
*
* @param version The version to test, must not be {@code null}.
* @return {@code true} if this range contains the specified version, {@code false} otherwise.
*/
boolean containsVersion( Version version );
}
aether-1.13.1/aether-api/src/main/java/org/sonatype/aether/version/VersionScheme.java 0000664 0000000 0000000 00000004141 11670505567 0030537 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.version;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
/**
* A version scheme that handles interpretation of version strings to facilitate their comparison.
*
* @author Benjamin Bentmann
* @author Alin Dreghiciu
*/
public interface VersionScheme
{
/**
* Parses the specified version string, for example "1.0".
*
* @param version The version string to parse, must not be {@code null}.
* @return The parsed version, never {@code null}.
* @throws InvalidVersionSpecificationException If the string violates the syntax rules of this scheme.
*/
Version parseVersion( String version )
throws InvalidVersionSpecificationException;
/**
* Parses the specified version range specification, for example "[1.0,2.0)".
*
* @param range The range specification to parse, must not be {@code null}.
* @return The parsed version range, never {@code null}.
* @throws InvalidVersionSpecificationException If the range specification violates the syntax rules of this scheme.
*/
VersionRange parseVersionRange( String range )
throws InvalidVersionSpecificationException;
/**
* Parses the specified version constraint specification, for example "1.0" or "[1.0,2.0),(2.0,)".
*
* @param constraint The constraint specification to parse, must not be {@code null}.
* @return The parsed version constraint, never {@code null}.
* @throws InvalidVersionSpecificationException If the constraint specification violates the syntax rules of this
* scheme.
*/
VersionConstraint parseVersionConstraint( final String constraint )
throws InvalidVersionSpecificationException;
}
aether-1.13.1/aether-api/src/test/ 0000775 0000000 0000000 00000000000 11670505567 0016646 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/ 0000775 0000000 0000000 00000000000 11670505567 0017567 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/ 0000775 0000000 0000000 00000000000 11670505567 0020356 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/ 0000775 0000000 0000000 00000000000 11670505567 0022220 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/ 0000775 0000000 0000000 00000000000 11670505567 0023470 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/AbstractRepositoryListenerTest.java 0000664 0000000 0000000 00000002034 11670505567 0032543 0 ustar 00root root 0000000 0000000 package org.sonatype.aether;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import static org.junit.Assert.*;
import java.lang.reflect.Method;
import org.junit.Test;
/**
* @author Benjamin Bentmann
*/
public class AbstractRepositoryListenerTest
{
@Test
public void testAllEventTypesHandled()
throws Exception
{
for ( Method method : RepositoryListener.class.getMethods() )
{
assertNotNull( AbstractRepositoryListener.class.getDeclaredMethod( method.getName(),
method.getParameterTypes() ) );
}
}
}
aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/graph/ 0000775 0000000 0000000 00000000000 11670505567 0024571 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/graph/DependencyTest.java 0000664 0000000 0000000 00000004067 11670505567 0030361 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import static org.junit.Assert.*;
import java.util.Arrays;
import java.util.Collections;
import org.junit.Test;
import org.sonatype.aether.graph.Dependency;
import org.sonatype.aether.graph.Exclusion;
/**
* @author Benjamin Bentmann
*/
public class DependencyTest
{
@Test
public void testSetScope()
{
Dependency d1 = new Dependency( new StubArtifact( "gid:aid:ver" ), "compile" );
Dependency d2 = d1.setScope( null );
assertNotSame( d2, d1 );
assertEquals( "", d2.getScope() );
Dependency d3 = d1.setScope( "test" );
assertNotSame( d3, d1 );
assertEquals( "test", d3.getScope() );
}
@Test
public void testSetExclusions()
{
Dependency d1 =
new Dependency( new StubArtifact( "gid:aid:ver" ), "compile", false,
Collections.singleton( new Exclusion( "g", "a", "c", "e" ) ) );
Dependency d2 = d1.setExclusions( null );
assertNotSame( d2, d1 );
assertEquals( 0, d2.getExclusions().size() );
assertSame( d2, d2.setExclusions( null ) );
assertSame( d2, d2.setExclusions( Collections. emptyList() ) );
assertSame( d2, d2.setExclusions( Collections. emptySet() ) );
assertSame( d1, d1.setExclusions( Arrays.asList( new Exclusion( "g", "a", "c", "e" ) ) ) );
Dependency d3 =
d1.setExclusions( Arrays.asList( new Exclusion( "g", "a", "c", "e" ), new Exclusion( "g", "a", "c", "f" ) ) );
assertNotSame( d3, d1 );
assertEquals( 2, d3.getExclusions().size() );
}
}
aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/graph/StubArtifact.java 0000664 0000000 0000000 00000010744 11670505567 0030035 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.graph;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import java.io.File;
import java.util.Collections;
import java.util.Map;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import org.sonatype.aether.artifact.Artifact;
/**
* @author Benjamin Bentmann
*/
class StubArtifact
implements Artifact
{
private final String groupId;
private final String artifactId;
private final String version;
private final String extension;
private final String classifier;
private final File file;
private final Map properties;
public StubArtifact( String coords, Map properties )
{
Pattern p = Pattern.compile( "([^: ]+):([^: ]+)(:([^: ]*)(:([^: ]+))?)?:([^: ]+)" );
Matcher m = p.matcher( coords );
if ( !m.matches() )
{
throw new IllegalArgumentException( "Bad artifact coordinates"
+ ", expected format is :[:[:]]:" );
}
groupId = m.group( 1 );
artifactId = m.group( 2 );
extension = get( m.group( 4 ), "jar" );
classifier = get( m.group( 6 ), "" );
version = m.group( 7 );
file = null;
this.properties = properties;
}
public StubArtifact( String coords )
{
this(coords, Collections.emptyMap());
}
private static String get( String value, String defaultValue )
{
return ( value == null || value.length() <= 0 ) ? defaultValue : value;
}
public String getGroupId()
{
return groupId;
}
public String getArtifactId()
{
return artifactId;
}
public String getVersion()
{
return version;
}
public Artifact setVersion( String version )
{
throw new UnsupportedOperationException( "not implemented" );
}
public String getBaseVersion()
{
return version;
}
public boolean isSnapshot()
{
return getVersion().endsWith( "SNAPSHOT" );
}
public String getClassifier()
{
return classifier;
}
public String getExtension()
{
return extension;
}
public File getFile()
{
return file;
}
public Artifact setFile( File file )
{
throw new UnsupportedOperationException( "not implemented" );
}
public String getProperty( String key, String defaultValue )
{
String value = properties.get( key );
return ( value != null ) ? value : defaultValue;
}
public Map getProperties()
{
return Collections.unmodifiableMap( properties );
}
public Artifact setProperties( Map properties )
{
throw new UnsupportedOperationException( "not implemented" );
}
@Override
public boolean equals( Object obj )
{
if ( obj == this )
{
return true;
}
else if ( !( obj instanceof Artifact ) )
{
return false;
}
Artifact that = (Artifact) obj;
return getArtifactId().equals( that.getArtifactId() ) && getGroupId().equals( that.getGroupId() )
&& getVersion().equals( that.getVersion() ) && getExtension().equals( that.getExtension() )
&& getClassifier().equals( that.getClassifier() ) && eq( getFile(), that.getFile() )
&& getProperties().equals( that.getProperties() );
}
private static boolean eq( T s1, T s2 )
{
return s1 != null ? s1.equals( s2 ) : s2 == null;
}
@Override
public int hashCode()
{
int hash = 17;
hash = hash * 31 + getGroupId().hashCode();
hash = hash * 31 + getArtifactId().hashCode();
hash = hash * 31 + getExtension().hashCode();
hash = hash * 31 + getClassifier().hashCode();
hash = hash * 31 + getVersion().hashCode();
hash = hash * 31 + hash( getFile() );
return hash;
}
private static int hash( Object obj )
{
return ( obj != null ) ? obj.hashCode() : 0;
}
}
aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/repository/ 0000775 0000000 0000000 00000000000 11670505567 0025707 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/repository/ProxyTest.java 0000664 0000000 0000000 00000003005 11670505567 0030531 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import static org.junit.Assert.*;
import org.junit.Test;
/**
* @author Benjamin Bentmann
*/
public class ProxyTest
{
@Test
public void testSetHost()
{
Proxy p1 = new Proxy( "type", "host", 80, null );
Proxy p2 = p1.setHost( null );
assertNotSame( p2, p1 );
assertEquals( "", p2.getHost() );
Proxy p3 = p1.setHost( "HOST" );
assertNotSame( p3, p1 );
assertEquals( "HOST", p3.getHost() );
}
@Test
public void testSetType()
{
Proxy p1 = new Proxy( "type", "host", 80, null );
Proxy p2 = p1.setType( null );
assertNotSame( p2, p1 );
assertEquals( "", p2.getType() );
Proxy p3 = p1.setType( "TYPE" );
assertNotSame( p3, p1 );
assertEquals( "TYPE", p3.getType() );
}
@Test
public void testSetPort()
{
Proxy p1 = new Proxy( "type", "host", 80, null );
Proxy p2 = p1.setPort( 8080 );
assertNotSame( p2, p1 );
assertEquals( 8080, p2.getPort() );
}
}
aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/repository/RemoteRepositoryTest.java 0000664 0000000 0000000 00000005213 11670505567 0032746 0 ustar 00root root 0000000 0000000 package org.sonatype.aether.repository;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import static org.junit.Assert.*;
import org.junit.Test;
/**
* @author Benjamin Bentmann
*/
public class RemoteRepositoryTest
{
@Test
public void testGetProtocol()
{
RemoteRepository repo = new RemoteRepository( "id", "type", "" );
assertEquals( "", repo.getProtocol() );
repo = repo.setUrl( "http://localhost" );
assertEquals( "http", repo.getProtocol() );
repo = repo.setUrl( "HTTP://localhost" );
assertEquals( "HTTP", repo.getProtocol() );
repo = repo.setUrl( "dav+http://www.sonatype.org/" );
assertEquals( "dav+http", repo.getProtocol() );
repo = repo.setUrl( "dav:http://www.sonatype.org/" );
assertEquals( "dav:http", repo.getProtocol() );
repo = repo.setUrl( "file:/path" );
assertEquals( "file", repo.getProtocol() );
repo = repo.setUrl( "file:path" );
assertEquals( "file", repo.getProtocol() );
repo = repo.setUrl( "file:C:\\dir" );
assertEquals( "file", repo.getProtocol() );
repo = repo.setUrl( "file:C:/dir" );
assertEquals( "file", repo.getProtocol() );
}
@Test
public void testGetHost()
{
RemoteRepository repo = new RemoteRepository( "id", "type", "" );
assertEquals( "", repo.getHost() );
repo = repo.setUrl( "http://localhost" );
assertEquals( "localhost", repo.getHost() );
repo = repo.setUrl( "http://localhost/" );
assertEquals( "localhost", repo.getHost() );
repo = repo.setUrl( "http://localhost:1234/" );
assertEquals( "localhost", repo.getHost() );
repo = repo.setUrl( "http://127.0.0.1" );
assertEquals( "127.0.0.1", repo.getHost() );
repo = repo.setUrl( "http://127.0.0.1/" );
assertEquals( "127.0.0.1", repo.getHost() );
repo = repo.setUrl( "http://user@localhost/path" );
assertEquals( "localhost", repo.getHost() );
repo = repo.setUrl( "http://user:pass@localhost/path" );
assertEquals( "localhost", repo.getHost() );
repo = repo.setUrl( "http://user:pass@localhost:1234/path" );
assertEquals( "localhost", repo.getHost() );
}
}
aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/transfer/ 0000775 0000000 0000000 00000000000 11670505567 0025314 5 ustar 00root root 0000000 0000000 AbstractTransferListenerTest.java 0000664 0000000 0000000 00000002035 11670505567 0033716 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-api/src/test/java/org/sonatype/aether/transfer package org.sonatype.aether.transfer;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import static org.junit.Assert.*;
import java.lang.reflect.Method;
import org.junit.Test;
/**
* @author Benjamin Bentmann
*/
public class AbstractTransferListenerTest
{
@Test
public void testAllEventTypesHandled()
throws Exception
{
for ( Method method : TransferListener.class.getMethods() )
{
assertNotNull( AbstractTransferListener.class.getDeclaredMethod( method.getName(),
method.getParameterTypes() ) );
}
}
}
aether-1.13.1/aether-connector-asynchttpclient/ 0000775 0000000 0000000 00000000000 11670505567 0021533 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/pom.xml 0000664 0000000 0000000 00000005460 11670505567 0023055 0 ustar 00root root 0000000 0000000
4.0.0
org.sonatype.aether
aether
1.13.1
aether-connector-asynchttpclient
Aether :: Connector :: AsyncHttpClient
A repository connector implementation based on AsyncHttpClient.
org.sonatype.aether
aether-api
org.sonatype.aether
aether-spi
org.sonatype.aether
aether-util
com.ning
async-http-client
1.6.5
org.codehaus.plexus
plexus-component-annotations
provided
org.sonatype.aether
aether-test-util
test
org.sonatype.sisu
sisu-inject-plexus
test
org.mortbay.jetty
jetty
6.1.25
test
org.sonatype.http-testing-harness
junit-runner
0.4.1
test
org.sonatype.http-testing-harness
server-provider
0.4.1
test
org.codehaus.mojo
animal-sniffer-maven-plugin
org.codehaus.plexus
plexus-component-metadata
aether-1.13.1/aether-connector-asynchttpclient/src/ 0000775 0000000 0000000 00000000000 11670505567 0022322 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/ 0000775 0000000 0000000 00000000000 11670505567 0023246 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/ 0000775 0000000 0000000 00000000000 11670505567 0024167 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/ 0000775 0000000 0000000 00000000000 11670505567 0024756 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/sonatype/ 0000775 0000000 0000000 00000000000 11670505567 0026620 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/sonatype/aether/ 0000775 0000000 0000000 00000000000 11670505567 0030070 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/sonatype/aether/connector/ 0000775 0000000 0000000 00000000000 11670505567 0032062 5 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/sonatype/aether/connector/async/ 0000775 0000000 0000000 00000000000 11670505567 0033177 5 ustar 00root root 0000000 0000000 AsyncRepositoryConnector.java 0000664 0000000 0000000 00000164572 11670505567 0041032 0 ustar 00root root 0000000 0000000 aether-1.13.1/aether-connector-asynchttpclient/src/main/java/org/sonatype/aether/connector/async package org.sonatype.aether.connector.async;
/*******************************************************************************
* Copyright (c) 2010-2011 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
*******************************************************************************/
import com.ning.http.client.AsyncHttpClient;
import com.ning.http.client.AsyncHttpClientConfig;
import com.ning.http.client.AsyncHttpProvider;
import com.ning.http.client.FluentCaseInsensitiveStringsMap;
import com.ning.http.client.HttpResponseBodyPart;
import com.ning.http.client.HttpResponseHeaders;
import com.ning.http.client.ProxyServer;
import com.ning.http.client.ProxyServer.Protocol;
import com.ning.http.client.Realm;
import com.ning.http.client.Request;
import com.ning.http.client.RequestBuilder;
import com.ning.http.client.Response;
import com.ning.http.client.providers.netty.NettyAsyncHttpProvider;
import org.sonatype.aether.ConfigurationProperties;
import org.sonatype.aether.RepositoryCache;
import org.sonatype.aether.RepositorySystemSession;
import org.sonatype.aether.repository.Authentication;
import org.sonatype.aether.repository.Proxy;
import org.sonatype.aether.repository.RemoteRepository;
import org.sonatype.aether.repository.RepositoryPolicy;
import org.sonatype.aether.spi.connector.ArtifactDownload;
import org.sonatype.aether.spi.connector.ArtifactTransfer;
import org.sonatype.aether.spi.connector.ArtifactUpload;
import org.sonatype.aether.spi.connector.MetadataDownload;
import org.sonatype.aether.spi.connector.MetadataTransfer;
import org.sonatype.aether.spi.connector.MetadataUpload;
import org.sonatype.aether.spi.connector.RepositoryConnector;
import org.sonatype.aether.spi.connector.Transfer;
import org.sonatype.aether.spi.io.FileProcessor;
import org.sonatype.aether.spi.log.Logger;
import org.sonatype.aether.transfer.ArtifactNotFoundException;
import org.sonatype.aether.transfer.ArtifactTransferException;
import org.sonatype.aether.transfer.ChecksumFailureException;
import org.sonatype.aether.transfer.MetadataNotFoundException;
import org.sonatype.aether.transfer.MetadataTransferException;
import org.sonatype.aether.transfer.NoRepositoryConnectorException;
import org.sonatype.aether.transfer.TransferEvent;
import org.sonatype.aether.transfer.TransferEvent.EventType;
import org.sonatype.aether.transfer.TransferEvent.RequestType;
import org.sonatype.aether.transfer.TransferListener;
import org.sonatype.aether.transfer.TransferResource;
import org.sonatype.aether.util.ChecksumUtils;
import org.sonatype.aether.util.ConfigUtils;
import org.sonatype.aether.util.StringUtils;
import org.sonatype.aether.util.layout.MavenDefaultLayout;
import org.sonatype.aether.util.layout.RepositoryLayout;
import org.sonatype.aether.util.listener.DefaultTransferEvent;
import org.sonatype.aether.util.listener.DefaultTransferResource;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.FilenameFilter;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.RandomAccessFile;
import java.lang.reflect.InvocationTargetException;
import java.net.ConnectException;
import java.net.HttpURLConnection;
import java.nio.channels.FileLock;
import java.nio.channels.OverlappingFileLockException;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.UUID;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.atomic.AtomicBoolean;
import java.util.concurrent.atomic.AtomicInteger;
/**
* A repository connector that uses the Async Http Client.
*
* @author Jeanfrancois Arcand
*/
class AsyncRepositoryConnector
implements RepositoryConnector
{
private final Logger logger;
private final FileProcessor fileProcessor;
private final RemoteRepository repository;
private final AsyncHttpClient httpClient;
private final Map checksumAlgos;
private final AtomicBoolean closed = new AtomicBoolean( false );
private final RepositoryLayout layout = new MavenDefaultLayout();
private final TransferListener listener;
private final RepositorySystemSession session;
private boolean useCache = false;
private final boolean disableResumeSupport;
private final static ConcurrentHashMap activeDownloadFiles =
new ConcurrentHashMap();
private final int maxIOExceptionRetry;
private final FluentCaseInsensitiveStringsMap headers;
/**
* Create an {@link org.sonatype.aether.connector.async.AsyncRepositoryConnector} instance which connect to the
* {@link RemoteRepository}
*
* @param repository the remote repository
* @param session the {@link RepositorySystemSession}
* @param logger the logger.
* @throws NoRepositoryConnectorException
*/
public AsyncRepositoryConnector( RemoteRepository repository, RepositorySystemSession session,
FileProcessor fileProcessor, Logger logger )
throws NoRepositoryConnectorException
{
this.logger = logger;
this.repository = repository;
this.listener = session.getTransferListener();
this.fileProcessor = fileProcessor;
this.session = session;
if ( !"default".equals( repository.getContentType() ) )
{
throw new NoRepositoryConnectorException( repository );
}
if ( !repository.getProtocol().regionMatches( true, 0, "http", 0, "http".length() ) &&
!repository.getProtocol().regionMatches( true, 0, "dav", 0, "dav".length() ) )
{
throw new NoRepositoryConnectorException( repository );
}
AsyncHttpClientConfig config = createConfig( session, repository, true );
httpClient = new AsyncHttpClient( getProvider( session, config ), config );
checksumAlgos = new LinkedHashMap();
checksumAlgos.put( "SHA-1", ".sha1" );
checksumAlgos.put( "MD5", ".md5" );
disableResumeSupport = ConfigUtils.getBoolean( session, false, "aether.connector.ahc.disableResumable" );
maxIOExceptionRetry = ConfigUtils.getInteger( session, 3, "aether.connector.ahc.resumeRetry" );
this.headers = new FluentCaseInsensitiveStringsMap();
Map headers =
ConfigUtils.getMap( session, null, ConfigurationProperties.HTTP_HEADERS + "." + repository.getId(),
ConfigurationProperties.HTTP_HEADERS );
if ( headers != null )
{
for ( Map.Entry entry : headers.entrySet() )
{
if ( entry.getKey() instanceof String && entry.getValue() instanceof String )
{
this.headers.add( entry.getKey().toString(), entry.getValue().toString() );
}
}
}
}
private AsyncHttpProvider getProvider( RepositorySystemSession session, AsyncHttpClientConfig config )
{
String className = ConfigUtils.getString( session, "", "aether.connector.ahc.provider" );
if ( className != null && className.length() > 0 )
{
if ( "netty".equals( className ) )
{
className = "com.ning.http.client.providers.netty.NettyAsyncHttpProvider";
}
else if ( "jdk".equals( className ) )
{
className = "com.ning.http.client.providers.jdk.JDKAsyncHttpProvider";
}
else if ( "apache".equals( className ) )
{
className = "com.ning.http.client.providers.apache.ApacheAsyncHttpProvider";
}
RepositoryCache cache = session.getCache();
try
{
if ( cache == null || cache.get( session, className ) == null )
{
logger.debug( "Using AHC provider " + className );
Class providerClass = getClass().getClassLoader().loadClass( className );
Object inst = providerClass.getConstructor( AsyncHttpClientConfig.class ).newInstance( config );
return (AsyncHttpProvider) inst;
}
}
catch ( LinkageError e )
{
warn( "Could not load AHC provider " + className + ", falling back to default", e );
}
catch ( ClassNotFoundException e )
{
logger.warn( "Could not load AHC provider " + className + ", falling back to default" );
}
catch ( ClassCastException e )
{
logger.warn( "Could not load type-compatible AHC provider " + className + ", falling back to default" );
}
catch ( Exception e )
{
Throwable cause = e;
if ( e instanceof InvocationTargetException && e.getCause() != null )
{
cause = e.getCause();
}
warn( "Could not instantiate AHC provider " + className + ", falling back to default", cause );
}
if ( cache != null )
{
cache.put( session, className, Boolean.TRUE );
}
}
return getDefaultProvider( config );
}
private AsyncHttpProvider getDefaultProvider( AsyncHttpClientConfig config )
{
return new NettyAsyncHttpProvider( config );
}
private void warn( String message, Throwable cause )
{
String msg = message;
if ( cause != null )
{
msg += ": " + cause;
}
if ( logger.isDebugEnabled() )
{
logger.warn( msg, cause );
}
else
{
logger.warn( msg );
}
}
private Realm getRealm( RemoteRepository repository, String credentialEncoding )
{
Realm realm = null;
Authentication a = repository.getAuthentication();
if ( a != null && a.getUsername() != null )
{
realm = new Realm.RealmBuilder().setPrincipal( a.getUsername() ).setPassword(
a.getPassword() ).setUsePreemptiveAuth( false ).setEnconding( credentialEncoding ).build();
}
return realm;
}
private ProxyServer getProxy( RemoteRepository repository, String credentialEncoding )
{
ProxyServer proxyServer = null;
Proxy p = repository.getProxy();
if ( p != null )
{
Authentication a = p.getAuthentication();
boolean useSSL = repository.getProtocol().equalsIgnoreCase( "https" ) ||
repository.getProtocol().equalsIgnoreCase( "dav:https" );
if ( a == null )
{
proxyServer = new ProxyServer( useSSL ? Protocol.HTTPS : Protocol.HTTP, p.getHost(), p.getPort() );
}
else
{
proxyServer =
new ProxyServer( useSSL ? Protocol.HTTPS : Protocol.HTTP, p.getHost(), p.getPort(), a.getUsername(),
a.getPassword() );
proxyServer.setEncoding( credentialEncoding );
}
}
return proxyServer;
}
/**
* Create an {@link AsyncHttpClientConfig} instance based on the values from {@link RepositorySystemSession}
*
* @param session {link RepositorySystemSession}
* @return a configured instance of
*/
private AsyncHttpClientConfig createConfig( RepositorySystemSession session, RemoteRepository repository,
boolean useCompression )
{
AsyncHttpClientConfig.Builder configBuilder = new AsyncHttpClientConfig.Builder();
String userAgent =
ConfigUtils.getString( session, ConfigurationProperties.DEFAULT_USER_AGENT, ConfigurationProperties.USER_AGENT );
if ( !StringUtils.isEmpty( userAgent ) )
{
configBuilder.setUserAgent( userAgent );
}
int connectTimeout =
ConfigUtils.getInteger( session, ConfigurationProperties.DEFAULT_CONNECT_TIMEOUT,
ConfigurationProperties.CONNECT_TIMEOUT );
String credentialEncoding =
ConfigUtils.getString( session, ConfigurationProperties.DEFAULT_HTTP_CREDENTIAL_ENCODING,
ConfigurationProperties.HTTP_CREDENTIAL_ENCODING + "." + repository.getId(),
ConfigurationProperties.HTTP_CREDENTIAL_ENCODING );
configBuilder.setConnectionTimeoutInMs( connectTimeout );
configBuilder.setCompressionEnabled( useCompression );
configBuilder.setFollowRedirects( true );
configBuilder.setMaxRequestRetry( 0 );
configBuilder.setRequestTimeoutInMs( ConfigUtils.getInteger( session, ConfigurationProperties.DEFAULT_REQUEST_TIMEOUT,
ConfigurationProperties.REQUEST_TIMEOUT ) );
configBuilder.setProxyServer( getProxy( repository, credentialEncoding ) );
configBuilder.setRealm( getRealm( repository, credentialEncoding ) );
return configBuilder.build();
}
private void await( CountDownLatch latch )
{
boolean interrupted = false;
while ( latch.getCount() > 0 )
{
try
{
latch.await();
}
catch ( InterruptedException e )
{
interrupted = true;
}
}
if ( interrupted )
{
Thread.currentThread().interrupt();
}
}
/**
* Use the async http client library to download artifacts and metadata.
*
* @param artifactDownloads The artifact downloads to perform, may be {@code null} or empty.
* @param metadataDownloads The metadata downloads to perform, may be {@code null} or empty.
*/
public void get( Collection artifactDownloads,
Collection metadataDownloads )
{
if ( closed.get() )
{
throw new IllegalStateException( "connector closed" );
}
artifactDownloads = safe( artifactDownloads );
metadataDownloads = safe( metadataDownloads );
CountDownLatch latch = new CountDownLatch( artifactDownloads.size() + metadataDownloads.size() );
Collection> tasks = new ArrayList>();
for ( MetadataDownload download : metadataDownloads )
{
String resource = layout.getPath( download.getMetadata() ).getPath();
GetTask task =
new GetTask( resource, download.getFile(), download.getChecksumPolicy(), latch,
download, METADATA, false );
tasks.add( task );
task.run();
}
for ( ArtifactDownload download : artifactDownloads )
{
String resource = layout.getPath( download.getArtifact() ).getPath();
GetTask task =
new GetTask( resource, download.isExistenceCheck() ? null : download.getFile(),
download.getChecksumPolicy(), latch, download, ARTIFACT, true );
tasks.add( task );
task.run();
}
await( latch );
for ( GetTask task : tasks )
{
task.flush();
}
}
/**
* Use the async http client library to upload artifacts and metadata.
*
* @param artifactUploads The artifact uploads to perform, may be {@code null} or empty.
* @param metadataUploads The metadata uploads to perform, may be {@code null} or empty.
*/
public void put( Collection artifactUploads,
Collection metadataUploads )
{
if ( closed.get() )
{
throw new IllegalStateException( "connector closed" );
}
artifactUploads = safe( artifactUploads );
metadataUploads = safe( metadataUploads );
CountDownLatch latch = new CountDownLatch( artifactUploads.size() + metadataUploads.size() );
Collection> tasks = new ArrayList>();
for ( ArtifactUpload upload : artifactUploads )
{
String path = layout.getPath( upload.getArtifact() ).getPath();
PutTask task = new PutTask( path, upload.getFile(), latch, upload, ARTIFACT );
tasks.add( task );
task.run();
}
for ( MetadataUpload upload : metadataUploads )
{
String path = layout.getPath( upload.getMetadata() ).getPath();
PutTask task = new PutTask( path, upload.getFile(), latch, upload, METADATA );
tasks.add( task );
task.run();
}
await( latch );
for ( PutTask task : tasks )
{
task.flush();
}
}
private void handleResponseCode( String url, int responseCode, String responseMsg )
throws AuthorizationException, ResourceDoesNotExistException, TransferException
{
if ( responseCode == HttpURLConnection.HTTP_NOT_FOUND )
{
throw new ResourceDoesNotExistException(
String.format( "Unable to locate resource %s. Error code %s", url, responseCode ) );
}
if ( responseCode == HttpURLConnection.HTTP_FORBIDDEN || responseCode == HttpURLConnection.HTTP_UNAUTHORIZED ||
responseCode == HttpURLConnection.HTTP_PROXY_AUTH )
{
throw new AuthorizationException(
String.format( "Access denied to %s. Error code %s, %s", url, responseCode, responseMsg ) );
}
if ( responseCode >= HttpURLConnection.HTTP_MULT_CHOICE )
{
throw new TransferException(
String.format( "Failed to transfer %s. Error code %s, %s", url, responseCode, responseMsg ) );
}
}
private TransferEvent newEvent( TransferResource resource, Exception e, TransferEvent.RequestType requestType,
TransferEvent.EventType eventType )
{
DefaultTransferEvent event = new DefaultTransferEvent();
event.setResource( resource );
event.setRequestType( requestType );
event.setType( eventType );
event.setException( e );
return event;
}
class GetTask
implements Runnable
{
private final T download;
private final String path;
private final File file;
private final String checksumPolicy;
private final LatchGuard latch;
private volatile Exception exception;
private final ExceptionWrapper