xbyxr9/ise-exam-drills

Purpose and Build Model

This is a Java 17 Gradle training repository for exam-style JUnit, EasyMock, and Spring REST exercises. It is not one application: it combines isolated domain scenarios, three independently runnable REST servers, and a mutation drill that verifies tests fail against broken implementations. Build orchestration and custom server/report tasks reside in build.gradle; the Gradle wrapper is gradlew.

Entry Points and Execution

The main runnable REST applications are:

• Product server, port 8080: src/main/java/ise/rest/server/ServerApplication.java

• Pullover exam server, port 8081: src/main/java/ise/rest/exam_pullover/PulloverServerApplication.java

• Practice server, port 8082: src/main/java/ise/rest/practice/PracticeServerApplication.java

Use Gradle tasks rather than a single universal main class. The legacy src/Main.java is explicitly not part of the maintained Gradle structure.

Testing Curriculum Domains

The repository’s dominant structure is independent, progressively numbered scenarios rather than a shared business system:

• JUnit/domain-testing exercises: src/main/java/ise/testing/, exemplified by src/main/java/ise/testing/s12_voidstate/ClubRegistry.java and src/main/java/ise/testing/exam_library/Library.java.

• EasyMock interaction-testing exercises: src/main/java/ise/mocking/, including src/main/java/ise/mocking/s12_callorder/AirlockController.java and src/main/java/ise/mocking/exam_vehicle/VehicleManagementSystem.java.

• Each scenario defines a small SUT with explicit collaborator seams, allowing tests to verify state, exceptions, returned values, call counts, ordering, and forbidden calls.

REST Service Architecture

Each REST variant follows a conventional controller/resource → service → repository boundary:

• Product API: src/main/java/ise/rest/server/ProductResource.java, src/main/java/ise/rest/server/ProductService.java, src/main/java/ise/rest/server/ProductRepository.java.

• Pullover stock API: src/main/java/ise/rest/exam_pullover/PulloverStockResource.java, src/main/java/ise/rest/exam_pullover/PulloverStockService.java, src/main/java/ise/rest/exam_pullover/PulloverStockRepository.java.

• Practice stock API mirrors that shape in src/main/java/ise/rest/practice/PracticeStockResource.java.

HTTP requests enter Spring MVC resources, are delegated to service logic, then query/update repository abstractions. Shared REST value types, including products, reviews, and sorting inputs, are under src/main/java/ise/rest/model/.

Client and External Boundaries

The REST client boundary is represented by src/main/java/ise/rest/client/ProductController.java, with endpoint/client behavior tested separately. Mocking scenarios model external services as interfaces/collaborators—such as gateways, mail, shipping, storage, and hardware—rather than integrating real providers; e.g., src/main/java/ise/mocking/s08_exceptions/CardProcessor.java and src/main/java/ise/mocking/s13_multiplemocks/CourierApi.java.

Mutation Verification Control Flow

The mutation drill is a meta-test layer: deliberately broken implementations under src/test/java/ise/mutants/ are executed programmatically by src/test/java/ise/drill/MutationDrillTest.java. Normal tests exclude the mutant tag, while the drill requires every mutant test to fail. Thus the green suite validates both application behavior and the ability of its tests to detect regressions.

Runtime and Infrastructure

Compilation targets Java 17 through Gradle 8.14.5. Spring Boot 3.2.5 libraries provide MVC, WebFlux, testing, and the three embedded HTTP servers, without applying the Spring Boot Gradle plugin. JUnit Jupiter 5.10.2 powers tests; EasyMock 5.2.0 is the intended mocking framework; the JUnit Platform Launcher supports mutation-drill execution.