cstamas commented on code in PR #199: URL: https://github.com/apache/maven-resolver/pull/199#discussion_r982431840
########## maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/checksum/FileTrustedChecksumsSourceSupport.java: ########## @@ -0,0 +1,149 @@ +package org.eclipse.aether.internal.impl.checksum; + +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you under the Apache License, Version 2.0 (the + * "License"); you may not use this file except in compliance + * with the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, + * software distributed under the License is distributed on an + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + * KIND, either express or implied. See the License for the + * specific language governing permissions and limitations + * under the License. + */ + +import java.io.IOException; +import java.io.UncheckedIOException; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.List; +import java.util.Map; + +import org.eclipse.aether.RepositorySystemSession; +import org.eclipse.aether.artifact.Artifact; +import org.eclipse.aether.repository.ArtifactRepository; +import org.eclipse.aether.spi.checksums.TrustedChecksumsSource; +import org.eclipse.aether.spi.connector.checksum.ChecksumAlgorithmFactory; +import org.eclipse.aether.util.ConfigUtils; +import org.eclipse.aether.util.DirectoryUtils; + +import static java.util.Objects.requireNonNull; + +/** + * Support class for implementing {@link TrustedChecksumsSource} backed by local filesystem. It implements basic support + * like bqsedir calculation, "enabled" flag and "originAware" flag. + * <p> + * The configuration keys supported: + * <ul> + * <li><pre>aether.trustedChecksumsSource.${name}.enabled</pre> (boolean) must be explicitly set to "true" + * to become enabled</li> + * <li><pre>aether.trustedChecksumsSource.${name}.basedir</pre> (string, path) directory from where implementation + * can use files. If unset, default value is ".checksums" and is resolved from local repository basedir.</li> + * <li><pre>aether.trustedChecksumsSource.${name}.originAware</pre> (boolean) whether to make implementation + * "originAware", to factor in origin repository ID as well or not.</li> + * </ul> + * <p> + * This implementation ensures that implementations have "name" property, used in configuration properties above. + * + * @since TBD + */ +abstract class FileTrustedChecksumsSourceSupport + implements TrustedChecksumsSource +{ + private static final String CONFIG_PROP_PREFIX = "aether.trustedChecksumsSource."; + + private static final String CONF_NAME_ENABLED = "enabled"; + + private static final String CONF_NAME_BASEDIR = "basedir"; + + private static final String CONF_NAME_ORIGIN_AWARE = "originAware"; + + /** + * Visible for testing. + */ + static final String LOCAL_REPO_PREFIX = ".checksums"; + + private final String name; + + FileTrustedChecksumsSourceSupport( String name ) + { + this.name = requireNonNull( name ); + } + + /** + * The implementation will call into underlying code only if enabled, chosen basedir exists, and requested + * checksum algorithms are not empty. + */ + @Override + public Map<String, String> getTrustedArtifactChecksums( RepositorySystemSession session, + Artifact artifact, + ArtifactRepository artifactRepository, + List<ChecksumAlgorithmFactory> checksumAlgorithmFactories ) + { + boolean enabled = ConfigUtils.getBoolean( session, false, configPropKey( CONF_NAME_ENABLED ) ); + if ( enabled ) + { + Path baseDir = getBasedir( session ); + if ( baseDir != null && !checksumAlgorithmFactories.isEmpty() ) + { + Map<String, String> result = performLookup( + session, baseDir, artifact, artifactRepository, checksumAlgorithmFactories ); + + return result == null || result.isEmpty() ? null : result; + } + } + return null; + } + + protected abstract Map<String, String> performLookup( RepositorySystemSession session, + Path baseDir, + Artifact artifact, + ArtifactRepository artifactRepository, + List<ChecksumAlgorithmFactory> checksumAlgorithmFactories ); + + /** + * To be used by underlying implementations to form configuration property keys properly scoped. + */ + protected String configPropKey( String name ) + { + requireNonNull( name ); + return CONFIG_PROP_PREFIX + this.name + "." + name; + } + + /** + * Returns {@code true} if session configuration contains "originAware" property set to {@code true}. + */ + protected boolean isOriginAware( RepositorySystemSession session ) + { + return ConfigUtils.getBoolean( session, false, configPropKey( CONF_NAME_ORIGIN_AWARE ) ); + } + + /** + * Uses common {@link DirectoryUtils} to calculate (but not) create basedir for this implementation. Returns + * {@code null} if the calculated basedir does not exist. + */ + private Path getBasedir( RepositorySystemSession session ) + { + try + { + Path basedir = DirectoryUtils.resolveDirectory( + session, LOCAL_REPO_PREFIX, configPropKey( CONF_NAME_BASEDIR ), false ); + if ( !Files.isDirectory( basedir ) ) Review Comment: It is for "not exists" case (and create=false), so yes, if exists and is NOT a directlry, DirectoryUtils will throw already. So when here, it either exists (and is directory) or not exists (and isDirectory returns false). IMHO the `Files.exists` is not appropriate here, as would not reflect the real intent. TL;DR: if exists and is not directory, code does not even arrive here, but I want to reflect the fact basedir is a directory (if exists) or does not exists. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
