Spring + MyBatisでテーブル結合を実現する方法を知りたいです。

Question

#やりたいこと
Spring + MyBatisでテーブル結合を実現したい。

#問題点
SQLのSELECT結果がnullで返却されること。

#ソース

DROP TABLE IF EXISTS detail CASCADE;
DROP TABLE IF EXISTS player CASCADE;


CREATE TABLE player
(
  id character NOT NULL ,
  name character varying(256),
  age character varying(256),
  detail_id character varying(256),
  CONSTRAINT pkey PRIMARY KEY (id)
);


CREATE TABLE detail
(
  detail_id character NOT NULL ,
  work character varying(256),
  CONSTRAINT ppkey PRIMARY KEY (detail_id)
);

<select id="selectItem" resultMap="PlayerDetailMap">
  	 SELECT
	  p.id
	  ,p.name
	  ,d.work
  	 FROM
  	  player p
  	 INNER JOIN
  	  detail d
  	 ON
  	  p.detail_id=d.detail_id
  	 WHERE
  	  p.id=#{id}
  	</select>

	<!-- テーブルのSELECT結果をどのようにマッピングするか指定 -->
    <resultMap id="PlayerDetailMap" type="com.mybatis.test.domain.PlayerEntity">
	 <id property="id" column="id" />
	 <result property="name" column="name" />
	 <collection  property="detailEntity" ofType="com.mybatis.test.domain.DetailEntity">
	  <result property="work" column="work" />
	 </collection>
	</resultMap>

結合する2つの元となるエンティティクラスは以下。

@Entity
public class PlayerEntity {

	@Id
	private String id;

	private String name;
	private String age;
	private String detail_id;
	@Transient
	private List<DetailEntity> detailEntity;

@Entity
public class DetailEntity {

	@Id
	private String detail_id;
	private String work;

@GetMapping()
	public String index(Model model) {
		PlayerDetailEntity playerDetailEntity = new PlayerDetailEntity();
		playerDetailEntity = myBatisService.selectItem("001");
		model.addAttribute("playerDetailEntity", playerDetailEntity);
		return "index";

<div th:object="${playerDetailEntity}">
		<div>
			<label><b>名前</b></label>
			<p th:text="*{name}">
		</div>
		<div>
			<label><b>仕事</b></label>
			<p th:text="*{detailEntity.work}">
		</div>
	</div>

MyBatisMapper.xmlの記述が問題だと思われるのですが、
どこがイケナイのかわかりません。
ご教示お願い致します。

Answer 1

１：１の親子関係の場合

テーブルの親子関係は detail_id で結びついていますので、親Entityを以下に設定し、これの子をDetailとした場合は、次のように 子要素が1以上ありますので、List<Detail> detailIds として宣言します。

import lombok.Data;

@Data
public class Player {
	private String id;
	private String name;
	private String age;
	private Detail detail;
}

import lombok.Data;

@Data
public class Detail {
	private String detailId;
	private String work;
}

これを検索するSQL（SQLマッピング）は次のようになります。

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
    PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.github.apz.mapper.PlayerMapper">
	<select id="findById" resultMap="playerMap">
		SELECT
			player.id
			, player.name
			, player.age
			, player.detail_id
			, detail.work
		FROM
			player
		JOIN DETAIL
			ON player.detail_id = detail.detail_id
		WHERE
			player.id = #{id}
	</select>

	<resultMap type="com.github.apz.entity.Player" id="playerMap">
		<id property="id" column="id" />
		<result property="name" column="name" />
		<result property="age" column="age" />
		<association property="detail" resultMap="detailResult"/>
	</resultMap>

	<resultMap id="detailResult" type="com.github.apz.entity.Detail">
		<result property="detailId" column="detail_id" />
		<result property="work" column="work" />
	</resultMap>
</mapper>

ポイントとなる点ですが、

テーブルを結合する条件（今回は detail_id）を必ずSQLに盛り込みます。
検索の結果は resultMap要素で別途定義します。

<resultMap>では、実際に検索結果で得たい内容（今回はPlayer）に対する結果のマッピングを行います。 property は Javaクラス側のプロパティ（変数） columnはSQLのカラムです。

テーブル結合の条件となっている detail_id の記述方法ですが、親要素である player の detail が子要素を持つことをPlayerクラスで宣言していている状態を記述します。

propertyで、子クラスを束ねる親クラスのフィールド名 detail であり、その内容は type で宣言したクラスで、この2つのマッピングの関係は、resultMapのid="detailResult" で関連づけられます。

１：Ｎのリレーション関係にある検索結果のマッピングについては https://qiita.com/alpha_pz/items/9c88acd814ffad2f1a36 を参考にしてください。

Comments

[box_908]

ご回答ありがとうございます。
Qiita拝見させていただきました。
申し訳ないですが、参考にさせて頂いて、試行してみましたが、正常に動作しません。

不足している修正箇所はどこになるでしょうか。

[A-pZ]

SQLの検索結果にdetail_id がないようですが、こちらは追加して試されましたでしょうか。

[box_908]

ご親切にありがとうございます。
はい、追加しましたが、まだのようです。

[A-pZ]

なるほど、少しお待ちください。

[box_908]

すみません。お手数をお掛けします。
ソース修正したのを更新しました。

[A-pZ]

あとお手数ですが、テーブル定義もあわせて記載いただけると助かります。ちなみに結合する2つのエンティティですが、親：子＝１：Ｎの関係でしょうか？

[box_908]

内容更新しました。
親：子＝１：1の関係になります。

よろしくお願いします。

[A-pZ]

ありがとうございます、お待ちください。

[box_908]

ご丁寧にありがとうございます。本当に助かります。
ご質問ですが、Entityを＠Dataにしなくては、実現できないものでしょうか？

[A-pZ]

@DataはLombokのアノテーションで、get/setメソッドがあればよいです。
ちなみに回答の先頭にも記載しておりますが、JPAのアノテーション(????Entityや????Id)は利用しません（効果がありません）

[A-pZ]

こちらの実行結果は試されましたでしょうか。

[box_908]

SQL自体は動きました！
ありがとうございます。

度々申し訳ございません。
取得した項目（work）はいまのindexファイルの指定方法だと読み取ってもらえず、
どのような記載が正しいのでしょうか？

[A-pZ]

index？ファイルとは、MyBatisのSQLファイルを記述しているxmlファイルのことであってますでしょうか。

私の回答で記述した内容ですと、Playerクラスに List<Detail> detailIds; にdetailテーブルを結合した内容が入っていますので（今回の場合は、常に1件しか入らないと思います）

Detail detail = detailIds.get(0);

で取得し、detail.getWork() で取得できるかと思います。

[box_908]

画面に出力するために私が作成したindex.htmlのことです。

コントローラーで
player = myBatisService.selectItem("002");のように取得したのち、
player.getDetailIds().get(0).getWork()；をして、ほしい項目を取得する方法しかないということでしょうか？

model.addAttribute("playerDetail", player);でオブジェクトを詰めて
そのままindex.htmlでth:object="${playerDetail}"で値を出力したかったのです。

[A-pZ]

なるほど画面ですね、失礼しました。

PlayerクラスからplayerDetailへのアクセスは、現在の実装（１：Ｎ）の場合はそのように、getDetailIds().get(0).getWork() になります。
ただ、今回のように、１：１の関係しかないのでしたら、Listに詰め替える処理にしないで、直接 playerDetail で取得する方に切り替えた方がよさそうですね。回答を編集しますのでお待ちください。

[box_908]

わざわざすみません。
ありがとうございます。

[A-pZ]

こちら回答を編集いたしましたのでご確認ください。お手数をおかけします。

[box_908]

ありがとうございます！出来ました。
ご丁寧に教えて頂いてありがとうございます。

association 使用する際は、resultMap で子要素を対応づけるのですね。

[A-pZ]

ですです。resultMapを複数つなげるときに使えます。SQLの実装を大きく変えることなくJavaへのマッピングを切り変えるときにも有効です。

[box_908]

慣れるまで、時間かかりそうですが、勉強します！
今回は本当にありがとうございました。

また、機会があれば何卒宜しくお願い致します。

[A-pZ]

d(・ω・今回は長時間にわたってしまい失礼しました。こちらこそよろしくお願いします。