Implement course fetching and searching

.github/workflows/tests.yml

@@ -14,6 +14,12 @@ jobs:
           distribution: 'temurin'
           java-version: '17'
 
+      - name: Setup env.properties
+        run: |
+          echo "DB_URL=${{ secrets.DB_URL }}" >> src/main/resources/env.properties
+          echo "DB_USERNAME=${{ secrets.DB_USERNAME }}" >> src/main/resources/env.properties
+          echo "DB_PASSWORD=${{ secrets.DB_PASSWORD }}" >> src/main/resources/env.properties
+
       - name: Cache Maven packages
         uses: actions/cache@v4
         with:

.gitignore

@@ -30,4 +30,7 @@ build/
 !**/src/test/**/build/
 
 ### VS Code ###
-.vscode/
+.vscode/
+
+### Enviroment ###
+env.properties

pom.xml

@@ -34,17 +34,27 @@
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-web</artifactId>
 		</dependency>
-
+		<!-- https://mvnrepository.com/artifact/com.mysql/mysql-connector-j -->
 		<dependency>
 			<groupId>com.mysql</groupId>
 			<artifactId>mysql-connector-j</artifactId>
-			<scope>runtime</scope>
+			<version>9.1.0</version>
+		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-data-jpa</artifactId>
 		</dependency>
 		<dependency>
 			<groupId>org.projectlombok</groupId>
 			<artifactId>lombok</artifactId>
 			<optional>true</optional>
 		</dependency>
+		<!-- https://mvnrepository.com/artifact/org.modelmapper/modelmapper -->
+		<dependency>
+			<groupId>org.modelmapper</groupId>
+			<artifactId>modelmapper</artifactId>
+			<version>3.2.1</version>
+		</dependency>
 		<dependency>
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-test</artifactId>

src/main/java/com/carpi/carpibackend/Application.java

@@ -9,5 +9,4 @@ public class Application {
 	public static void main(String[] args) {
 		SpringApplication.run(Application.class, args);
 	}
-
 }

src/main/java/com/carpi/carpibackend/ApplicationConfig.java

@@ -0,0 +1,35 @@
+package com.carpi.carpibackend;
+
+import org.modelmapper.Converter;
+import org.modelmapper.ModelMapper;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import com.carpi.carpibackend.dto.CourseDto;
+import com.carpi.carpibackend.entity.CourseSearchResult;
+
+@Configuration
+public class ApplicationConfig {
+
+    private static final String[] EMPTY_LIST = new String[0];
+
+    @Bean
+    public ModelMapper modelMapper() {
+        ModelMapper modelMapper = new ModelMapper();
+        Converter<String, String[]> split =
+                ctx -> ctx.getSource() == null ? EMPTY_LIST : ctx.getSource().split(",");
+        modelMapper.typeMap(CourseSearchResult.class, CourseDto.class).addMappings(
+            mapper -> {
+                mapper.using(split).map(
+                    CourseSearchResult::getSemesterList,
+                    CourseDto::setSemesterList
+                );
+                mapper.using(split).map(
+                    CourseSearchResult::getAttributeList,
+                    CourseDto::setAttributeList
+                );
+            }
+        );
+        return modelMapper;
+    }
+}

src/main/java/com/carpi/carpibackend/controller/CourseController.java

@@ -0,0 +1,54 @@
+package com.carpi.carpibackend.controller;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import org.modelmapper.ModelMapper;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.CrossOrigin;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import com.carpi.carpibackend.dto.CourseDto;
+import com.carpi.carpibackend.entity.CourseSearchResult;
+import com.carpi.carpibackend.service.CourseSearchService;
+
+@CrossOrigin
+@RestController
+@RequestMapping("/api/v1/course")
+public class CourseController {
+
+    @Autowired
+    private CourseSearchService courseSearchService;
+
+    @Autowired
+    private ModelMapper modelMapper;
+
+    @GetMapping("/all")
+    public ResponseEntity<List<CourseDto>> getAll() {
+        return searchCourses(null, null, null, null);
+    }
+
+    @GetMapping("/search")
+    public ResponseEntity<List<CourseDto>> searchCourses(
+            @RequestParam(required = false) String searchPrompt,
+            @RequestParam(required = false) String[] deptFilters,
+            @RequestParam(required = false) String[] attrFilters,
+            @RequestParam(required = false) String[] semFilters
+    ) {
+        List<CourseSearchResult> searchResults = courseSearchService.searchCourses(
+                searchPrompt,
+                deptFilters,
+                attrFilters,
+                semFilters
+        );
+        List<CourseDto> courseDtos = searchResults.stream().map(
+                                        result -> modelMapper.map(result, CourseDto.class)
+                                    ).collect(Collectors.toList());
+        return ResponseEntity.ok(courseDtos);
+    }
+}

src/main/java/com/carpi/carpibackend/dto/CourseDto.java

@@ -0,0 +1,26 @@
+package com.carpi.carpibackend.dto;
+
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+
+public class CourseDto {
+
+    private String department;
+
+    private int code;
+
+    private String title;
+
+    private String description;
+
+    private short creditMin;
+
+    private short creditMax;
+
+    private String[] semesterList;
+
+    private String[] attributeList;
+}

src/main/java/com/carpi/carpibackend/entity/Course.java

@@ -0,0 +1,39 @@
+package com.carpi.carpibackend.entity;
+
+import com.carpi.carpibackend.keys.CourseKey;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.EmbeddedId;
+import jakarta.persistence.Entity;
+import jakarta.persistence.Table;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+
+@Entity
+@Table(name = "course")
+public class Course {
+
+    @EmbeddedId
+    private CourseKey pkCourses;
+
+    @Column(name = "dept", nullable = false)
+    private String department;
+
+    @Column(name = "code_num", nullable = false)
+    private int code;
+
+    @Column(name = "title", nullable = false)
+    private String title;
+
+    @Column(name = "desc_text", nullable = false)
+    private String description;
+
+    @Column(name = "credit_min", nullable = false)
+    private short creditMin;
+
+    @Column(name = "credit_max", nullable = false)
+    private short creditMax;
+}

src/main/java/com/carpi/carpibackend/entity/CourseSearchResult.java

@@ -0,0 +1,61 @@
+package com.carpi.carpibackend.entity;
+
+import com.carpi.carpibackend.keys.CourseKey;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.EmbeddedId;
+import jakarta.persistence.Entity;
+import lombok.Getter;
+import lombok.Setter;
+
+@Getter
+@Setter
+
+@Entity
+public class CourseSearchResult {
+
+    @EmbeddedId
+    private CourseKey pkCourses;
+
+    @Column(name = "dept", nullable = false)
+    private String department;
+
+    @Column(name = "code_num", nullable = false)
+    private int code;
+
+    @Column(name = "title", nullable = false)
+    private String title;
+
+    @Column(name = "desc_text", nullable = false)
+    private String description;
+
+    @Column(name = "credit_min", nullable = false)
+    private short creditMin;
+
+    @Column(name = "credit_max", nullable = false)
+    private short creditMax;
+
+    @Column(name = "sem_list", nullable = false)
+    private String semesterList;
+
+    @Column(name = "attr_list", nullable = true)
+    private String attributeList;
+
+    @Column(name = "code_match", nullable = false)
+    private boolean codeMatch;
+
+    @Column(name = "title_exact_match", nullable = false)
+    private boolean titleExactMatch;
+
+    @Column(name = "title_start_match", nullable = false)
+    private boolean titleStartMatch;
+
+    @Column(name = "title_match", nullable = false)
+    private boolean titleMatch;
+
+    @Column(name = "title_acronym", nullable = false)
+    private boolean titleAcronym;
+
+    @Column(name = "title_abbrev", nullable = false)
+    private boolean titleAbbrev;
+}

src/main/java/com/carpi/carpibackend/keys/CourseKey.java

@@ -0,0 +1,40 @@
+package com.carpi.carpibackend.keys;
+
+import java.io.Serializable;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Embeddable;
+import lombok.AllArgsConstructor;
+import lombok.NoArgsConstructor;
+
+@NoArgsConstructor
+@AllArgsConstructor
+
+@Embeddable
+public class CourseKey implements Serializable {
+
+    @Column(name = "dept", insertable = false, updatable = false, nullable = false)
+    private String department;
+
+    @Column(name = "code_num", insertable = false, updatable = false, nullable = false)
+    private int code;
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) {
+            return true;
+        }
+        if (obj instanceof CourseKey) {
+            CourseKey other = (CourseKey) obj;
+            return department.equals(other.department) && code == other.code;
+        }
+        return false;
+    }
+
+    @Override
+    public int hashCode() {
+        int result = department.hashCode();
+        result = 31 * result + Integer.hashCode(code);
+        return result;
+    }
+}

src/main/java/com/carpi/carpibackend/repository/CourseRepository.java

@@ -0,0 +1,12 @@
+package com.carpi.carpibackend.repository;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.stereotype.Repository;
+
+import com.carpi.carpibackend.entity.Course;
+import com.carpi.carpibackend.keys.CourseKey;
+
+@Repository
+public interface CourseRepository extends JpaRepository<Course, CourseKey> {
+
+}