Add clearer comments

codesungrape · codesungrape · commit 5e298ee1cf11 · 2025-11-07T11:35:58.000Z
diff --git a/src/main/java/com/codesungrape/hmcts/BookAPI/service/BookService.java b/src/main/java/com/codesungrape/hmcts/BookAPI/service/BookService.java
@@ -41,7 +41,7 @@ public Book createBook(BookRequest request) {
 
         Book savedBook = bookRepository.save(newBook);
 
-        // Defensive check (even though it "shouldn't" happen)
+        // Defensive check (even though it "shouldn't" happen aka follows JPA contract)
         if (savedBook == null) {
             throw new IllegalStateException("Failed to save book - repository returned null");
         }

Original file line number	Diff line number	Diff line change
`@@ -41,7 +41,7 @@ public Book createBook(BookRequest request) {`
`41`	`41`
`42`	`42`	`Book savedBook = bookRepository.save(newBook);`
`43`	`43`
`44`		`- // Defensive check (even though it "shouldn't" happen)`
	`44`	`+ // Defensive check (even though it "shouldn't" happen aka follows JPA contract)`
`45`	`45`	`if (savedBook == null) {`
`46`	`46`	`throw new IllegalStateException("Failed to save book - repository returned null");`
`47`	`47`	`}`