org.gradle.api.plugins.MavenRepositoryHandlerConvention Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gradle-api Show documentation
Gradle 6.9.1 API redistribution.
There is a newer version: 8.11.1
/*
 * Copyright 2011 the original author or authors.
 *
 * Licensed 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.
 */
package org.gradle.api.plugins;

import groovy.lang.Closure;
import org.gradle.api.Action;
import org.gradle.api.artifacts.maven.GroovyMavenDeployer;
import org.gradle.api.artifacts.maven.MavenResolver;

import java.util.Map;

/**
 * Allows Maven repositories for publishing artifacts to be defined. The Maven plugin mixes-in this interface to the {@link org.gradle.api.artifacts.dsl.RepositoryHandler} associated with each
 * task of type {@link org.gradle.api.tasks.Upload}.
 */
public interface MavenRepositoryHandlerConvention {
    String DEFAULT_MAVEN_DEPLOYER_NAME = "mavenDeployer";
    String DEFAULT_MAVEN_INSTALLER_NAME = "mavenInstaller";

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * @return The added repository
     * @see #mavenDeployer(java.util.Map, groovy.lang.Closure)
     */
    GroovyMavenDeployer mavenDeployer();

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * @param configureClosure A closure to use to configure the repository.
     * @return The added repository
     * @see #mavenDeployer(java.util.Map, groovy.lang.Closure)
     */
    GroovyMavenDeployer mavenDeployer(Closure configureClosure);

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * @param configureAction The action to use to configure the repository.
     * @return The added repository
     * @see #mavenDeployer()
     * @since 4.2
     */
    GroovyMavenDeployer mavenDeployer(Action configureAction);

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * The following parameter are accepted as keys for the map:
     *
     * 
     * 
     *     
     * 
     *     
     * Key Description of Associated Value
name (optional) The name of the repository. The default is mavenDeployer-{SOME_ID}.
     * The name is used in the console output,
     * to point to information related to a particular repository. A name must be unique amongst a repository group.
     * 
     *
     * @param args The argument to create the repository
     * @return The added repository
     * @see #mavenDeployer(java.util.Map, groovy.lang.Closure)
     */
    GroovyMavenDeployer mavenDeployer(Map args);

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * @param args The argument to create the repository
     * @param configureClosure A closure to use to configure the repository.
     * @return The added repository
     */
    GroovyMavenDeployer mavenDeployer(Map args, Closure configureClosure);

    /**
     * Adds a repository for publishing to a Maven repository. This repository can not be used for resolving dependencies.
     *
     * @param args The argument to create the repository
     * @param configureAction The action to use to configure the repository.
     * @return The added repository
     *
     * @since 4.2
     */
    GroovyMavenDeployer mavenDeployer(Map args, Action configureAction);

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * @return The added repository
     * @see #mavenInstaller(java.util.Map, groovy.lang.Closure) (java.util.Map, groovy.lang.Closure)
     */
    MavenResolver mavenInstaller();

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * @param configureClosure A closure to use to configure the repository.
     * @return The added repository
     * @see #mavenInstaller(java.util.Map, groovy.lang.Closure) (java.util.Map, groovy.lang.Closure)
     */
    MavenResolver mavenInstaller(Closure configureClosure);

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * @param configureAction The action to use to configure the repository.
     * @return The added repository
     * @see #mavenInstaller(Map, Action)
     *
     * @since 4.2
     */
    MavenResolver mavenInstaller(Action configureAction);

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * The following parameter are accepted as keys for the map:
     *
     * 
     * 
     *     
     * 
     *     
     * Key Description of Associated Value
name (optional) The name of the repository. The default is mavenInstaller-{SOME_ID}.
     * The name is used in the console output,
     * to point to information related to a particular repository. A name must be unique amongst a repository group.
     * 
     *
     * @param args The argument to create the repository
     * @return The added repository
     * @see #mavenInstaller(java.util.Map, groovy.lang.Closure) (java.util.Map, groovy.lang.Closure)
     */
    MavenResolver mavenInstaller(Map args);

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * @param args The argument to create the repository
     * @param configureClosure A closure to use to configure the repository.
     * @return The added repository
     */
    MavenResolver mavenInstaller(Map args, Closure configureClosure);

    /**
     * Adds a repository for installing to a local Maven cache. This repository can not be used for resolving dependencies.
     *
     * @param args The argument to create the repository
     * @param configureAction The action to use to configure the repository.
     * @return The added repository
     *
     * @since 4.2
     */
    MavenResolver mavenInstaller(Map args, Action configureAction);
}