Package org.eclipse.aether.internal.impl.checksum

Class TrustedToProvidedChecksumsSourceAdapter

java.lang.Object

org.eclipse.aether.internal.impl.checksum.TrustedToProvidedChecksumsSourceAdapter

All Implemented Interfaces:

ProvidedChecksumsSource

@Singleton
@Named("trusted2provided")
public final class TrustedToProvidedChecksumsSourceAdapter
extends Object
implements ProvidedChecksumsSource

Adapter that adapts TrustedChecksumsSource to ProvidedChecksumsSource used by connector. Hence, any "trusted" source exist that is enabled, automatically becomes "provided" source as well.

Since:

1.9.0

Field Summary

Fields

Modifier and Type	Field	Description
static final String	NAME

Constructor Summary

Constructors

Constructor	Description
TrustedToProvidedChecksumsSourceAdapter(Map<String,TrustedChecksumsSource> trustedChecksumsSources)

Method Summary

Modifier and Type	Method	Description
Map<String,String>	getProvidedArtifactChecksums(RepositorySystemSession session, ArtifactDownload transfer, RemoteRepository repository, List<ChecksumAlgorithmFactory> checksumAlgorithmFactories)	May return the provided checksums (for given artifact transfer) from source other than remote repository, or null if it have no checksums available for given transfer.
Map<String,String>	getProvidedMetadataChecksums(RepositorySystemSession session, MetadataDownload transfer, RemoteRepository repository, List<ChecksumAlgorithmFactory> checksumAlgorithmFactories)	May return the provided checksums (for given metadata transfer) from source other than remote repository, or null if it has no checksums available for given transfer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

NAME

public static final String NAME

See Also:

• Constant Field Values

Constructor Details

TrustedToProvidedChecksumsSourceAdapter

@Inject
public TrustedToProvidedChecksumsSourceAdapter(Map<String,TrustedChecksumsSource> trustedChecksumsSources)

Method Details

getProvidedArtifactChecksums

public Map<String,String> getProvidedArtifactChecksums(RepositorySystemSession session,
 ArtifactDownload transfer,
 RemoteRepository repository,
 List<ChecksumAlgorithmFactory> checksumAlgorithmFactories)

Description copied from interface: ProvidedChecksumsSource

May return the provided checksums (for given artifact transfer) from source other than remote repository, or null if it have no checksums available for given transfer. Provided checksums are "opt-in" for transfer, in a way IF they are available upfront, they will be enforced according to checksum policy in effect. Otherwise, provided checksum verification is completely left out.

For enabled provided checksum source is completely acceptable to return null values, as that carries the meaning "nothing to add here", as there are no checksums to be provided upfront transfer. Semantically, this is equivalent to returning empty map, but signals the intent better.

Specified by:

getProvidedArtifactChecksums in interface ProvidedChecksumsSource

Parameters:

session - The current session.

transfer - The transfer that is about to be executed.

repository - The remote repository connector is about to contact.

checksumAlgorithmFactories - The checksum algorithms that are expected.

Returns:

Map of expected checksums, or null.

getProvidedMetadataChecksums

public Map<String,String> getProvidedMetadataChecksums(RepositorySystemSession session,
 MetadataDownload transfer,
 RemoteRepository repository,
 List<ChecksumAlgorithmFactory> checksumAlgorithmFactories)

Description copied from interface: ProvidedChecksumsSource

May return the provided checksums (for given metadata transfer) from source other than remote repository, or null if it has no checksums available for given transfer. Semantics are the same as for ProvidedChecksumsSource.getProvidedArtifactChecksums(RepositorySystemSession, ArtifactDownload, RemoteRepository, List), but covering metadata downloads: metadata like maven-metadata.xml influences resolution decisions (for example version range selection), so it should be coverable by the strongest configured integrity source just like artifacts are.

The default implementation returns null ("nothing to add here"), preserving the behavior of implementations written before this method existed.

Specified by:

getProvidedMetadataChecksums in interface ProvidedChecksumsSource

Parameters:

session - The current session.

transfer - The metadata transfer that is about to be executed.

repository - The remote repository connector is about to contact.

checksumAlgorithmFactories - The checksum algorithms that are expected.

Returns:

Map of expected checksums, or null.