spring と thymeleaf の連携（値を表示したい）

Question

実現したいこと

以下の calendar.html 2行目の user.id を表示しようとするとエラーが出ます。
実現方法が分からないです。ご協力よろしくお願いします。
また、spring や thymeleaf のリファレンスにできる限り慣れていきたいと思っています。
回答する上で参考にしたリファレンスの該当箇所を教えていただけると、
自分で探し出すための参考になるため、大変嬉しいです。（まだリファレンスに慣れておらず、、余力があれば是非よろしくお願いいたします。）

HomeController.java で、model.addAttribute("frames", reservationInfos);で
データを渡しているところを、 for 文の繰り返し処理内で渡すということも考えましたが
Thymeleaf で上手いことやれるならそちらの方がいいのかなと思っております。
（全然実現方法は分からない状況ですが）

<div th:each="frame : ${frames}" th:object="${frame}">
    <p th:text="'user_id ==> ' + *{user.id}"></p>
    <p th:text="'Type ==> ' + *{type}"></p>
    <p th:text="'予約した日 ==> ' + *{reserved_date}"></p>
</div>

    @PostMapping("/calendar")
    public String showCalendar(@Validated HospitalInfoForm form, BindingResult result, Model model) {

        if (result.hasErrors()) {
            return showIndex(form);
        }

        form.setDateTodayIfNull();
        List<UserReservationEntity> reservationInfos = service.getDateSchedule(form.hospital_id, form.date);
        log.info("user_id ====> " + reservationInfos.get(0).user.id);
        model.addAttribute("frames",       reservationInfos);
        model.addAttribute("hospitalName", service.getHospitalName(form.hospital_id));
        model.addAttribute("targetDate",   form.date);

        return "calendar";
    }

★★★★　追記箇所　★★★★

@AllArgsConstructor
public class UserEntity {
    public int id;
    public String name;
    public String gender;
    public LocalDate birthday;
}

★★★★　追記箇所　★★★★

@Getter
@AllArgsConstructor
public class UserReservationEntity {
    public UserEntity user;
    public HospitalDateScheduleEntity schedule;

    public String type;
    public LocalDate reserved_date;

    public int getUserId() {
        return this.user.id;
    }
}

@AllArgsConstructor
public class HospitalDateScheduleEntity {
    public int id;
    public int hospital_id;
    public LocalDate target_date;
    public LocalTime target_time;
}

↓いったんクエリせず、ベタ打ちでデータを作成しています。

@Service
@RequiredArgsConstructor
public class ReservationInfoService {

    private final ReservationInfoRepository repository;

    @Transactional
    public String getHospitalName(int id) {
        return repository.getHospitalName(id);
    }

    @Transactional
    public List<UserReservationEntity> getDateSchedule(int hospital_id, LocalDate date) {
//        return repository.getTargetDateSchedule(hospital_id, date);

        // １．ユーザー生成
        UserEntity user1 = new UserEntity(1, "harukaze",   "woman", LocalDate.of(1995, 12, 5));
        UserEntity user2 = new UserEntity(2, "doncoco" ,   "man"  , LocalDate.of(1990, 1,  2));
        UserEntity user3 = new UserEntity(3, "TomBrown",   "man"  , LocalDate.of(1980, 4, 19));
        UserEntity user4 = new UserEntity(4, "MORISANCHU", "woman", LocalDate.of(1980, 4, 19));
        UserEntity user5 = new UserEntity(5, "MINAMIKAWA", "man"  , LocalDate.of(1980, 4, 19));

        // ２．予約枠生成
        HospitalDateScheduleEntity frame1 = new HospitalDateScheduleEntity(1, 1, LocalDate.now(), LocalTime.of(10,0));
        HospitalDateScheduleEntity frame2 = new HospitalDateScheduleEntity(2, 1, LocalDate.now(), LocalTime.of(11,0));
        HospitalDateScheduleEntity frame3 = new HospitalDateScheduleEntity(3, 1, LocalDate.now(), LocalTime.of(12,0));
        HospitalDateScheduleEntity frame4 = new HospitalDateScheduleEntity(4, 1, LocalDate.now(), LocalTime.of(12,30));
        HospitalDateScheduleEntity frame5 = new HospitalDateScheduleEntity(5, 1, LocalDate.now(), LocalTime.of(14,30));

        // ３．予約枠に予約をセット
        List<UserReservationEntity> reserveList = List.of(
            new UserReservationEntity(user1, frame1, "200", LocalDate.now()),
            new UserReservationEntity(null, frame1, "200", LocalDate.now()),
            new UserReservationEntity(null, frame1, "200", LocalDate.now()),
            new UserReservationEntity(null, frame1, "200", LocalDate.now()),
            new UserReservationEntity(null, frame1, "200", LocalDate.now()),
            new UserReservationEntity(user2, frame2, "400", LocalDate.now()),
            new UserReservationEntity(null, frame2, "400", LocalDate.now()),
            new UserReservationEntity(null, frame2, "400", LocalDate.now()),
            new UserReservationEntity(null, frame2, "400", LocalDate.now()),
            new UserReservationEntity(user3, frame3, "200", LocalDate.now()),
            new UserReservationEntity(user4, frame4, "400", LocalDate.now()),
            new UserReservationEntity(user5, frame5, "200", LocalDate.now())
        );

        return reserveList;
    }
}

発生している問題・分からないこと

エラー内容：Caused by: org.attoparser.ParseException: Exception evaluating SpringEL expression
（User.id）

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

getter を付けてみるなどしましたが、未だ実現できておりません。

補足

id 'org.springframework.boot' version '3.2.6'
java : 21
lombok
thymeleaf

Comments

[jimbe]

UserEntity はどのような定義になっているでしょうか。
また、 html で参照したいのは、 UserEntity の id フィールドでしょうか、それとも UserReservationEntity の getUserId メソッドでしょうか。

[tetejiro]

いつも大変お世話になっております。
本当にありがとうございます。
UserEntity.java を追記いたしました。

＞UserEntity の id フィールドでしょうか
UserEntity の id フィールドです。
ID だけでなく、UserReservationEntity のレコードに紐づいている（UserReserveEntity に代入されている）UserEntity のメンバ変数全てを表示させたいと思っております。（id, name, gender, birth）

getUserId メソッドは、試しに置いてみた途中のものがそのままになっておりました。
特に現在、使用しておりません。（紛らわしくしてしまい、申し訳ございません。）

[jimbe]

追加修正ありがとうございます。
例外のご提示が一部だけなので経緯がどうなっているか分かりませんが、私の手元の『springboot を使わず thymeleaf + SpringEL の (spring5 の) 環境』では、calendar.html の書き方でリスト内のオブジェクトのフィールド(user)のフィールド(id)の表示は出来ています。
ただしそれは user が null で無ければ、です。
null の場合は java で普通にあるように NullPointerException 的な例外になります。

[tetejiro]

すみません。ありがとうございます。
私のEntityが null だったから、エラーをはいていたということに気づいていませんでした。
（お恥ずかしい限りです。。）

回答の方もいただき、誠にありがとうございます。
大変丁寧に書いていただき、恐縮です。
今の作業を急いでおりまして、回答の方は読むのに少しお時間いただきますが、
僭越ながら、ひとまずベストアンサーに選ばせていただき、読後
質問があればコメントにて質問をさせていただきたいと思っております。

改めまして、ご回答いただきまして誠にありがとうございました。

Answer 1

素の Java プロジェクトで SpEL 式の Thymeleaf を使うまで を参考にサーバ等を使用しないでも SpEL を用いたテンプレート変換を試せるような環境を作ってテストしてみます。
(thymeleaf: 3.1.2, thymeleaf-spring5: 3.1.2, Spring-expression等: 5.3.37 で行いました。)

TestSpEL.java

package teratail_java.q_3ayq7itkvjtrij;

import java.time.LocalDate;
import java.util.ArrayList;
import java.util.List;

import org.thymeleaf.context.Context;
import org.thymeleaf.spring5.SpringTemplateEngine;
import org.thymeleaf.templatemode.TemplateMode;
import org.thymeleaf.templateresolver.ClassLoaderTemplateResolver;

import lombok.AllArgsConstructor;

public class TestSpEL {
  public static void main(String[] args) {

    ClassLoaderTemplateResolver resolver = new ClassLoaderTemplateResolver();
    resolver.setTemplateMode(TemplateMode.HTML);
    resolver.setPrefix("template/");
    resolver.setSuffix(".html");

    SpringTemplateEngine templateEngine = new SpringTemplateEngine();
    templateEngine.setEnableSpringELCompiler(true);
    templateEngine.setTemplateResolver(resolver);

    //テストデータ
    List<Reservation> list = new ArrayList<Reservation>();
    list.add(new Reservation(new User(1), "200", LocalDate.now()));
    list.add(new Reservation(new User(2), "200", LocalDate.now()));

    Context context = new Context();
    context.setVariable("frames", list);

    System.out.println(templateEngine.process("index", context));
  }

  @AllArgsConstructor
  public static class Reservation {
    public User user;
    public String type;
    public LocalDate reserved_date;
  }

  @AllArgsConstructor
  public static class User {
    public int id;
  }
}

index.html (calendar.html に "xmlns 属性を入れた html タグ" を追加したものです)

<html xmlns:th="http://www.thymeleaf.org">
<div th:each="frame : ${frames}" th:object="${frame}">
    <p th:text="'user_id ==> ' + *{user.id}"></p>
    <p th:text="'Type ==> ' + *{type}"></p>
    <p th:text="'予約した日 ==> ' + *{reserved_date}"></p>
</div>
</html>

実行結果

<html>
<div>
    <p>user_id ==&gt; 1</p>
    <p>Type ==&gt; 200</p>
    <p>予約した日 ==&gt; 2024-06-16</p>
</div>
<div>
    <p>user_id ==&gt; 2</p>
    <p>Type ==&gt; 200</p>
    <p>予約した日 ==&gt; 2024-06-16</p>
</div>
</html>

テストデータの二つ目 (29 行目) の user を null にしてみます。

    list.add(new Reservation(null, "200", LocalDate.now()));

実行結果 (環境が違うため内容も異なるものと思いますが、例外が発生するという意味で同じと考えます。)

[main] ERROR org.thymeleaf.TemplateEngine - [THYMELEAF][main] Exception processing template "index": Exception evaluating SpringEL expression: "user.id" (template: "index" - line 3, col 8)
org.thymeleaf.exceptions.TemplateProcessingException: Exception evaluating SpringEL expression: "user.id" (template: "index" - line 3, col 8)
	at org.thymeleaf.spring5.expression.SPELVariableExpressionEvaluator.evaluate(SPELVariableExpressionEvaluator.java:292)
(中略)
	at org.thymeleaf.TemplateEngine.process(TemplateEngine.java:1053)
	at teratail_java.q_3ayq7itkvjtrij.TestSpEL.main(TestSpEL.java:34)
Caused by: org.springframework.expression.spel.SpelEvaluationException: EL1007E: Property or field 'id' cannot be found on null
(後略)