build.gradle

// блок плагинов, плагины меняют таски учавствующие в сборки/ добавляют таски - красивый императивный подход
plugins {
    id 'org.springframework.boot' version '2.3.5.RELEASE'
    id 'io.spring.dependency-management' version '1.0.10.RELEASE'
    id 'maven-publish'
    id 'java-library'
    id 'java'
}


group = 'com.home.gradle'
version = '0.0.1-SNAPSHOT'


// Вариант взять jdk и скомпилировать в режиме совместимости
//java{
//    sourceCompatibility =JavaVersion.VERSION_11
//}


// Если JDK совпадет с версией - возьмет его, если найдет (соглансо конфигурации поиска - возьмет целевую jdk, если не найдет
// скачает AdobeOpenJdk нужной версии в хом директорию .gradle (C:\Users\ab020686ssv\.gradle\jdks что весьма удобно но сожрет чуть больше места на hdd)
// https://docs.gradle.org/current/userguide/toolchains.html
java { // нужен или этот 'java-library' или 'java' плагин
    toolchain {
        languageVersion = JavaLanguageVersion.of(15)
    }
}

//'org.springframework.boot' пришло из этого плагина - позволяет делать исполняемый джарник
bootJar {
    //Имя артифакта (не хочу чтоб была верия) https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Jar.html#org.gradle.api.tasks.bundling.Jar:archiveFileName
    // (перменные можно посмотреть тут - https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Jar.html
    archiveVersion.set('')
//    archiveVersion ='' тоже валидная строчка но будет ругаться linter
}

// эта опция позволяет на этапе компиляции использовать анннотайшн процессоры, как будто они указаны
configurations {

    // в качестве compileOnly зависимостей добавить из annotationProcessor
    compileOnly {
        extendsFrom annotationProcessor
    }
    // в качестве testCompileOnly зависимостей добавить из annotationProcessor
    testCompileOnly {
        extendsFrom annotationProcessor
    }
    // в качестве testAnnotationProcessor зависимостей добавить из annotationProcessor
    testAnnotationProcessor {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}


//
ext{ // добавили экста перменную в проекте
    commonsVersion= 3.11
}
//def commonsVersion= 3.11 // альтернативный и помоему более удачный способ


dependencies {
    //implementation platform('org.springframework.boot:spring-boot-dependencies:2.3.5.RELEASE')

    //В библиотеке скоуп будет runtime - такое подходит только для зависимостей интерфейсов, для которых будет зависимость реализации в месте подключения
    // градл рекомендует его совать как можно чаще, вот только если имплементации на этапе компиляции не будет ничего не скомпилиться
    // пример мы используем интерфейсы jpa в стартере, конкретная имплементация будет хибернейт это примерно об этом. т.е имплементацию надо будет выбрать в помнике или градл билде куда подключаете
    // Если брать спрингбутовые зависимости поставляемые через бом - тоже норм, тк в месте подключения скорей всего вы делаете так же.
    // та же ситуация с драйвером к базе данных
    // одно из главных достоинств более быстрая компиляция проекта подключившего такую заявисимость
    implementation 'org.springframework.boot:spring-boot-starter-web'

    // зависимость не попадет в помник в библиотеку подходит для анотейшн процессоров в частности ломбока который должен быть в класпасе на этапе компиляции
    // compileOnly 'org.projectlombok:lombok' // Можно не указывать из за конфигурации выше
    // testCompileOnly 'org.projectlombok:lombok' // Можно не указывать из за конфигурации выше
    // testAnnotationProcessor 'org.projectlombok:lombok'// Можно не указывать из за конфигурации выше
    annotationProcessor 'org.projectlombok:lombok'

    annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
    testImplementation('org.springframework.boot:spring-boot-starter-test') {
        exclude group: 'org.junit.vintage', module: 'junit-vintage-engine' //module - это artifactId
    }
    // compileOnlyApi преобразовывается в скоуп compile который является если не указывать его к зависимости к мавену.
    // зависимость будет на этапе компиляции и на этапе выполнения.
    def guava = '30.0-jre'
    api "com.google.guava:guava:$guava"
    compileOnlyApi 'com.google.code.gson:gson'
    compile "org.apache.commons:commons-lang3:$commonsVersion"
    // runtimeOnly = provided было актуально когда среда выполнения поставляла зависимости, сейчас скорей редкое исключение
    // testImplementation скоуп test
    // testCompileOnly на этапе компиляции тестов
    // testRuntimeOnly поставляется платформой на этапе работы тестов
}


test {
    useJUnitPlatform {
        excludeTags('integration')
    }
}
publishing {
    publications {
        maven(MavenPublication) {
            from components.java
        }
    }
}