Chapter 1. Generate the Red Hat Business Optimizer Spring Boot project

Procedure

1. Open Spring Initializr in a web browser:

   https://start.spring.io/

2. Select a project, language, Spring Boot version, and enter project metadata.
3. Click Add Dependencies and select Spring Web to add the spring-boot-starter-web dependency.
4. Click GENERATE. Your project ZIP file downloads.
5. Extract the ZIP file and change directory to your Spring Boot project directory.

6. Add the Red Hat Business Optimizer dependency (optaplanner-spring-boot-starter). Currently optaplanner-spring-boot-starter is not included in Spring Initializr so you must manually add it to your build file.

   • If you generated a Maven project, add the optaplanner-spring-boot-starter dependency to your project’s pom.xml:

     <dependencyManagement>
         <dependencies>
             <dependency>
                 <groupId>org.optaplanner</groupId>
                 <artifactId>optaplanner-spring-boot-starter</artifactId>
                 <version>{project-version}</version>
             </dependency>
         </dependencies>
     </dependencyManagement>

     The following example shows the optaplanner-spring-boot-starter dependency added to your project’s pom.xml file:

     <?xml version="1.0" encoding="UTF-8"?>
     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
         <modelVersion>4.0.0</modelVersion>
         <parent>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-parent</artifactId>
             <version>{version-org-spring-framework-boot}</version>
         </parent>
     
         <groupId>com.example</groupId>
         <artifactId>constraint-solving-ai-optaplanner</artifactId>
         <version>0.1.0-SNAPSHOT</version>
         <name>Constraint Solving AI with Red Hat Business Optimizer</name>
         <description>A Spring Boot Red Hat Business Optimizer example to generate a school timetable.</description>
     
         <properties>
             <java.version>1.8</java.version>
         </properties>
     
         <dependencies>
             <dependency>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-starter-web</artifactId>
             </dependency>
             <dependency>
                 <groupId>org.optaplanner</groupId>
                 <artifactId>optaplanner-spring-boot-starter</artifactId>
             </dependency>
     
             <dependency>
                 <groupId>org.springframework.boot</groupId>
                 <artifactId>spring-boot-starter-test</artifactId>
                 <scope>test</scope>
                 <exclusions>
                     <exclusion>
                         <groupId>org.junit.vintage</groupId>
                         <artifactId>junit-vintage-engine</artifactId>
                     </exclusion>
                 </exclusions>
             </dependency>
         </dependencies>
     
         <dependencyManagement>
             <dependencies>
                 <dependency>
                     <groupId>org.optaplanner</groupId>
                     <artifactId>optaplanner-spring-boot-starter</artifactId>
                     <version>{project-version}</version>
                 </dependency>
             </dependencies>
         </dependencyManagement>
     
         <build>
             <plugins>
                 <plugin>
                     <groupId>org.springframework.boot</groupId>
                     <artifactId>spring-boot-maven-plugin</artifactId>
                 </plugin>
             </plugins>
         </build>
     
     </project>

   • If you generated a Gradle project, add the optaplanner-spring-boot-starter to your build.gradle file:

     implementation "org.optaplanner:optaplanner-spring-boot-starter:{project-version}"

     The following example shows the optaplanner-spring-boot-starter dependency added to your project’s build.gradle file in a Gradle Java project:

     plugins {
         id "org.springframework.boot" version "{version-org-spring-framework-boot}"
         id "io.spring.dependency-management" version "1.0.9.RELEASE"
         id "java"
     }
     
     group = "com.example"
     version = "0.1.0-SNAPSHOT"
     sourceCompatibility = "1.8"
     
     repositories {
         mavenCentral()
     }
     
     dependencies {
         implementation "org.springframework.boot:spring-boot-starter-web"
         implementation "org.optaplanner:optaplanner-spring-boot-starter:{project-version}"
         testImplementation("org.springframework.boot:spring-boot-starter-test") {
             exclude group: "org.junit.vintage", module: "junit-vintage-engine"
         }
     }
     
     test {
         useJUnitPlatform()
     }