tutorials README

The project's README from github.com/eugenp/tutorials. As one markdown file: README.md.

Cloning the repository

If you are getting an error while cloning the repository, try running: git config --global http.postBuffer 5000000

This will increase the buffer size from the default 1MiB to 5MiB.

To revert this value to the default, use: git config --global http.postBuffer 1000000

The Courses

"Learn Spring" Course:
>> LEARN SPRING - THE MASTER CLASS

"REST With Spring" Course:
>> THE REST WITH SPRING - MASTER CLASS

"Learn Spring Security" Course:
>> LEARN SPRING SECURITY - MASTER CLASS

Java and Spring Tutorials

This project is a collection of small and focused tutorials - each covering a single and well-defined area of development in the Java ecosystem. A strong focus of these is the Spring Framework - Spring, Spring Boot and Spring Security. In addition to Spring, the modules here cover several aspects of Java.

Profile-based segregation

We use Maven build profiles to segregate the huge list of individual projects in our repository.

The projects are broadly divided into 8 lists: default, default-jdk17, default-jdk22, default-jdk23, default-jdk24, default-jdk25, default-jdk8 and default-heavy.

Next, they are segregated further based on the tests that we want to execute.

We also have a parents profile to build only parent modules.

Therefore, we have a total of 17 profiles:

Profile Includes Type of test enabled
default JDK21 projects *UnitTest
integration JDK21 projects *IntegrationTest
default-jdk17 JDK17 projects *UnitTest
integration-jdk17 JDK17 projects *IntegrationTest
default-jdk22 JDK22 projects *UnitTest
integration-jdk22 JDK22 projects *IntegrationTest
default-jdk23 JDK23 projects *UnitTest
integration-jdk23 JDK23 projects *IntegrationTest
default-jdk24 JDK24 projects *UnitTest
integration-jdk24 JDK24 projects *IntegrationTest
default-jdk25 JDK25 projects *UnitTest
integration-jdk25 JDK25 projects *IntegrationTest
default-jdk26 JDK26 projects *UnitTest
integration-jdk26 JDK26 projects *IntegrationTest
default-heavy Heavy/long running projects *UnitTest
integration-heavy Heavy/long running projects *IntegrationTest
default-jdk8 JDK8 projects *UnitTest
integration-jdk8 JDK8 projects *IntegrationTest
parents Set of parent modules None

Building the project

Though it shouldn't be needed often to build the entire repository at once because we are usually concerned with a specific module.

But if we want to, we can invoke the below command from the root of the repository if we want to build the entire repository with only Unit Tests enabled:

mvn clean install -Pdefault,default-heavy

or if we want to build the entire repository with Integration Tests enabled, we can do:

mvn clean install -Pintegration,integration-heavy

Analogously, for the JDK8 projects the commands are:

mvn clean install -Pdefault-jdk8

and

mvn clean install -Pintegration-jdk8

Building a single module

To build a specific module, run the command: mvn clean install in the module directory.

It can happen that your module is part of a parent module e.g. parent-boot-1,parent-spring-5 etc, then you will need to build the parent module first so that you can build your module. We have created a parents profile that you can use to build just the parent modules, just run the profile as: mvn clean install -Pparents

Building modules from the root of the repository

To build specific modules from the root of the repository, run the command: mvn clean install --pl akka-modules,algorithms-modules -Pdefault in the root directory.

Here akka-modules and algorithms-modules are the modules that we want to build and default is the maven profile in which these modules are present.

Running a Spring Boot module

To run a Spring Boot module, run the command: mvn spring-boot:run in the module directory.

Working with the IDE

This repo contains a large number of modules. When you're working with an individual module, there's no need to import all of them (or build all of them) - you can simply import that particular module in either Eclipse or IntelliJ.

Running Tests

The command mvn clean install from within a module will run the unit tests in that module. For Spring modules this will also run the SpringContextTest if present.

To run the integration tests, use the command:

mvn clean install -Pintegration or

mvn clean install -Pintegration-heavy or

mvn clean install -Pintegration-jdk8

depending on the list where our module exists

tutorials (eugenp/tutorials)

Searching Database…

37.3K ·GitHub
Что это такое?Огромная коллекция небольших узкоспециализированных туториалов по экосистеме Java — один модуль с кодом на каждую тему — с сильным упором на Spring, Spring Boot и Spring Security.
Это одно запускаемое приложение или куча отдельных примеров?Отдельные примеры: это Maven-репозиторий со множеством модулей, где каждый туториал живёт в своём модуле, а build-профили группируют их так, что вы собираете только те, которые нужны.
Как запустить один из туториалов на Spring Boot?Перейдите командой cd в каталог нужного модуля и выполните mvn spring-boot:run — каждый туториал запускается как отдельный модуль, а не как приложение из корня репозитория.
Под какой JDK написаны туториалы?Единой JDK нет: модули разбиты на списки для JDK8, JDK17 и JDK21–26, причём в профиле по умолчанию находятся проекты под JDK21 — берите JDK, которая соответствует вашему модулю.
Клонирование падает на середине — как это исправить?В README советуют увеличить http.postBuffer в git до 5 МиБ командой git config --global http.postBuffer 5000000; позже можно вернуть обратно той же командой со значением 1000000.
С какими курсами связан этот репозиторий?Он рекламирует три сопутствующих мастер-класса: Learn Spring, REST With Spring и Learn Spring Security.
Мне обязательно импортировать весь репозиторий в свою IDE?Нет — если работаете над одним туториалом, просто импортируйте конкретный модуль в Eclipse или IntelliJ; импортировать и собирать их все не нужно.
Как запустить интеграционные тесты для модуля?mvn clean install в модуле запускает его модульные тесты; для интеграционных тестов добавьте соответствующий профиль: -Pintegration, -Pintegration-heavy или -Pintegration-jdk8.
Коллекция до сих пор поддерживается?Да — build-профили уже охватывают релизы JDK вплоть до 26, а репозиторий, созданный в 2013 году, не переведён в архив.
Creator
eugenp
Size
130.2 MB
Stars
37.3K
Updated
CommitOct 16
Age
13y
Commits · 90 Days