Spring bootにおけるビルド失敗

Question

Spring boot 2.1.0にてWebアプリケーションを勉強中です。その中で、ビルドエラーが発生し対処が不明のためご意見を頂戴したいと思っております。

アプリケーション仕様：部屋予約サイト

//エラーログ

Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2018-11-23 03:43:45.939 ERROR 23104 --- [           main] o.s.b.d.LoggingFailureAnalysisReporter   : 

***************************
APPLICATION FAILED TO START
***************************

Description:

Field roomService in com.example.demo.RoomsController required a bean of type 'domain.room.RoomService' that could not be found.

The injection point has the following annotations:
	- @org.springframework.beans.factory.annotation.Autowired(required=true)

RoomsControllerにRoomServiceのBean定義がないと言われていると解釈していますがRoomsControllerには**@Autowired**アノテーションがついているのでBeanアノテーションは必要ないかと思っているですが、そもそもエラーの解釈が違い、違うアプローチが必要なのでしょうか？

package com.example.demo;

import java.time.LocalDate;
import java.util.List;
import domain.model.ReservableRoom;
import domain.room.RoomService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
@RequestMapping("rooms")
public class RoomsController {
	@Autowired
	RoomService roomService;

	@RequestMapping(value = "{date}", method = RequestMethod.GET)
	String listRooms(@DateTimeFormat(iso = DateTimeFormat.ISO.DATE) @PathVariable("date") LocalDate date, Model model) {
		List<ReservableRoom> rooms = roomService.findReservableRooms(date);
		model.addAttribute("rooms", rooms);
		return "room/listRooms";
	}

	@RequestMapping(method = RequestMethod.GET)
	String listRooms(Model model) {
		LocalDate today = LocalDate.now();
		model.addAttribute("date", today);
		return listRooms(today, model);
	}
}

package domain.room;

import java.time.LocalDate;
import java.util.List;
import domain.model.ReservableRoom;
import domain.repository.room.ReservableRoomRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
@Transactional
public class RoomService {
	@Autowired
	ReservableRoomRepository reservableRoomRepository;
	@Autowired
	MeetingRoomRepository meetingRoomRepository;

	public List<ReservableRoom> findReservableRooms(LocalDate date) {
		return reservableRoomRepository.findByReservableRoomId_reservedDateOrderByReservableRoomId_roomIdAsc(date);
	}

//	public MeetingRoom findMeetingRoom(Integer roomId) {
//		return meetingRoomRepository.findOne(roomId);
//	}
}

教材サンプルソースコードはダウンロード可能なのですが公共の場にリンクを貼っていいのか判断がつきませんのでエラーに該当するクラスのみソースコードを貼っておきます。

追加情報：パッケージエクスプローラのキャプチャ追加

Comments

[rubytomato]

パッケージの定義（構造）に問題があるように思います。パッケージの構造がわかるような情報（たとえばパッケージとソースコードの一覧が確認できるプロジェクトエクスプローラーのスクリーンショットなど）があるといいと思います。

[sanezane]

すみません！貼ろうと思って忘れていました。。見にくいと思ったのでフォルダ構成は該当ソースのフォルダしか開いていませんが確認できますでしょか。

[rubytomato]

情報の追記ありがとうございます。回答致しましたのでご確認ください。

Answer 1

現在のパッケージの構造をフォルダ風に表現すると以下のようになるとおもいます。
ご覧の通り、com.example.demoとdomainが別々の階層になっています。

com/
  |
  +--- example/
         |
         +--- demo/
               |
               +--- RoomsController.java
               +--- SampleApplication.java
               +--- TyhmeleafConfig.java

domain/
  |
  +--- model/
  |     |
  |     +--- ReservableRoom.java
  |
  +--- repository/
  |     |
  |     +--- room/
  |            |
  |            +--- ReservableRoomRepository.java
  |
  +--- room/
        |
        +--- MeetingRoomRepository.java
        +--- RoomService.java

これを、以下のように（model、repository、roomパッケージをcom.example.demoパッケージ下に移動）統合し、

com/
  |
  +--- example/
         |
         +--- demo/
               |
               +--- RoomsController.java
               +--- SampleApplication.java
               +--- TyhmeleafConfig.java
               |
               +--- model/
               |     |
               |     +--- ReservableRoom.java
               |
               +--- repository/
               |     |
               |     +--- room/
               |            |
               |            +--- ReservableRoomRepository.java
               |
               +--- room/
                     |
                     +--- MeetingRoomRepository.java
                     +--- RoomService.java

移動したjavaソースのpackage宣言も修正すると解決すると考えています。
たとえば、RoomService.javaであれば

package domain.room;

@Service
@Transactional
public class RoomService {
}

から

package com.example.demo.room;

@Service
@Transactional
public class RoomService {
}

のようにです。

このようなパッケージ構造にするとなぜ解決するか（解決するかはまだわからいないですが）ですが、Spring Bootでは@SpringBootApplicationアノテーションが付いたクラスがある位置からパッケージスキャンが行われます。
パッケージスキャンを簡単に説明しますと、アプリケーションの起動時に@Controller、@Service、@Repository、@Componentアノテーションが付いているクラスを探し出してインスタンス化し、Springの管理下に納めます。
そして、Springの管理下にあるインスタンスは@Autowiredアノテーションが付いたフィールドへ、必要なタイミングで代入（インジェクト）されるという風になっています。

今回のご質問されたプロジェクトでは、@SpringBootApplicationアノテーションが付いたクラスは、おそらくSampleApplicationクラスだと思いますが、パッケージスキャンはこのクラスの位置、つまりcom.example.demoから始まります。このため別の階層にあるdomainはスキャンの対象外になり、このパッケージ下の@Serviceアノテーションなどが付いたクラスは、Springの管理下にはなりません。

これがRoomServiceがAutowiredされない原因だと考えています。
この考え方に間違いがなければ、上記の内容で問題は解決できるとおもっているのですが、この方法で解決した場合、参考にされている教材とプロジェクトの内容に差が出てしまい、このさき困ることが出てくるかもしれません。

なので、いったん教材の方の@SpringBootApplicationアノテーションが付いているクラスやコントローラクラスがどのパッケージの位置にあるのかを確認して頂き、そちらの内容にあわせてcom.example.demoのパッケージ下のクラスを移動させることがいいかもしれません。

Comments

[sanezane]

ありがとうございます。rubytomatoさんのおかげで勉強になっております。今回の質問でアノテーションの基本的な使い方と意味を勉強できました。今回のエラーは解決いたしました。

Answer 2

SpringBootの @SpringBootApplication は、@Configuration、@EnableAutoConfiguration、@ComponentScan を内包します。

特に @ComponentScan はSpringFrameworkの管理下におくクラスをパッケージ名で指定しますが、これを指定しないときは、このアノテーションが存在するパッケージとサブパッケージを対象にします。これは @SpringBootApplicationでも同様です。

もしデフォルトの動作を変えたい場合は、スキャン対象のパッケージを全て記載します。

以上の詳細は、https://docs.spring.io/spring-boot/docs/2.1.0.RELEASE/reference/htmlsingle/#using-boot-structuring-your-code とその前後の章や節を参考にされると良いでしょう。