常連

### 単体テストとデバッグの違いについて
単体テストとデバッグの違いが判りません。
現在、ウェブエンジニアとして仕事をしております。(1年目)

先日、新規画面作成を任され、作成が完了したのですが、
単体テストの粒度がわからず、困っております。

単体テストについてGoogleで調べてみると、新規作成した関数だったりが
機能していることを単体テストとしているような旨が記載されておりました。
ただ、それはデバッグ作業に該当するものだと思っております。

完成後に仕様書通りの機能が動いているかのテストは、
単体テストではなく「結合テスト」に該当するのでしょうか？

単体テスト・デバッグ・結合テストの違いについてがわかりません。

多態性を用いる際、意図通りのインスタンスができているかどうかを確認するための単体テストはどのようにすればよいでしょうか？

例えば、IAを継承するA1、A2、A3クラスがあって、IAを持つクラスBがあった場合、
クラスBのIA型のプロパティのインスタンスがA1なのかA2なのかA3なのかを判別したいけれど、
多態性によってそれらが外部から基本的に区別がつかない状態になっています。

もちろん、それぞれを区別できるような動作を敢えて行えばわかるのですが、
例えば、テスト用にインスタンスの型を識別できるようなプロパティを作ったり、
もしくは、リフレクションを使って識別したりするのは邪道でしょうか？

因みに、A1、A2、A3は個別に単体テストを行なっています。
あくまでも、その生成パターンが意図通りかというテストを行なうことのみを目的としたいです。


多態性（ポリモーフィズム）のパターンを単体テストする場合

現在、JUnitでテストを行っているのですが、エラーが解決できない状況です。

エラー文から判断すると、期待されている内容と値が違うと考えられるのですが、データを確認してみるとデータがあっているはずなのですがエラーが出てしまいます。

わかる方がいれば、エラーの原因をご教授ください。よろしくお願いします。

![![イメージ説明](48a9d083fda1a554fb4a24b439982ec4.png)](1f8bc46d111d190770e0de1e5757cc7f.png)
```DeploymentController
package com.example.demo.controller;

import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Collections;
import java.util.Date;
import java.util.Optional;

import javax.servlet.http.HttpSession;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;

import com.example.demo.DeploymentComparator;
import com.example.demo.entity.DeploymentEntity;
import com.example.demo.entity.UserEntity;
import com.example.demo.repository.DeploymentRepository;
import com.example.demo.service.DeploymentService;

@Controller
public class DeploymentController {

	@Autowired
	DeploymentRepository rep;

	@Autowired
	HttpSession ses;

	@RequestMapping(value = "/depTop", method = RequestMethod.GET)
	public ModelAndView view(ModelAndView mav) {
		mav.setViewName("departmentTop");
		mav.addObject("title", "部署管理");
		ArrayList<DeploymentEntity> list = rep.findDeploymentByDeleteFlag();
		mav.addObject("deploymentData", list);
		return mav;
	}

	@RequestMapping(value = "/delete", method = RequestMethod.POST)
	@Transactional(readOnly = false)
	public ModelAndView deleteDeployment(@RequestParam String selectDeleteId, ModelAndView mav) {
		int id = Integer.parseInt(selectDeleteId);
		Optional<DeploymentEntity> data = rep.findById((long) id);
		DeploymentEntity dep = data.get();

		dep.setDelete_flag(1);

		Date date = new Date();
		SimpleDateFormat format = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss");
		// 日時情報を指定フォーマットの文字列で取得
		String display = format.format(date);

		dep.setDelete_date(display);

		UserEntity loginEmp = (UserEntity) ses.getAttribute("loginEmp");
		dep.setDeleter_id(loginEmp.getId());

		rep.saveAndFlush(dep);

		return new ModelAndView("redirect:/departmetTop");

	}

	@RequestMapping(value = "/depSort", method = RequestMethod.POST)
	public ModelAndView sortExecution(@ModelAttribute ArrayList<DeploymentEntity> kf, ModelAndView mav) {
		Collections.sort(kf, new DeploymentComparator());
		DeploymentService ks = new DeploymentService();
		ks.sortUpdate(kf);
		return new ModelAndView("redirect:/depTop");
	}

}

```

```DeploymentEntity
package com.example.demo.entity;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table;

@Entity
@Table(name = "m_deployment")
public class DeploymentEntity {

	@Id
	@GeneratedValue(strategy = GenerationType.IDENTITY)
	@Column(name = "deployment_id")
	private int id;
	@Column(name = "deployment_name")
	private String deploymentName;
	@Column
	private String register_date;
	@Column
	private int register_id;
	@Column
	private String edit_date;
	@Column(name = "editer_id")
	private int editor_id;
	@Column
	private int delete_flag;
	@Column
	private String delete_date;
	@Column
	private int deleter_id;
	@Column
	private int sort_num;

	public int getId() {
		return id;
	}

	public void setId(int id) {
		this.id = id;
	}

	public String getDeployment_name() {
		return deploymentName;
	}

	public void setDeployment_name(String deployment_name) {
		this.deploymentName = deployment_name;
	}

	public String getRegister_date() {
		return register_date;
	}

	public void setRegister_date(String register_date) {
		this.register_date = register_date;
	}

	public int getRegister_id() {
		return register_id;
	}

	public void setRegister_id(int register_id) {
		this.register_id = register_id;
	}

	public String getEdit_date() {
		return edit_date;
	}

	public void setEdit_date(String edit_date) {
		this.edit_date = edit_date;
	}

	public int getEditor_id() {
		return editor_id;
	}

	public void setEditor_id(int editor_id) {
		this.editor_id = editor_id;
	}

	public int getDelete_flag() {
		return delete_flag;
	}

	public void setDelete_flag(int delete_flag) {
		this.delete_flag = delete_flag;
	}

	public String getDelete_date() {
		return delete_date;
	}

	public void setDelete_date(String delete_date) {
		this.delete_date = delete_date;
	}

	public int getDeleter_id() {
		return deleter_id;
	}

	public void setDeleter_id(int deleter_id) {
		this.deleter_id = deleter_id;
	}

	public int getSort_num() {
		return sort_num;
	}

	public void setSort_num(int sort_num) {
		this.sort_num = sort_num;
	}

}

```

```DeploymentControllerTest
package com.example.demo;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;

import java.util.ArrayList;

import javax.servlet.http.HttpSession;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.jdbc.AutoConfigureTestDatabase;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;

import com.example.demo.controller.DeploymentController;
import com.example.demo.entity.DeploymentEntity;
import com.example.demo.repository.DeploymentRepository;

@RunWith(SpringJUnit4ClassRunner.class)
@SpringBootTest
@AutoConfigureMockMvc
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)

public class DeploymentControllerTest {
	@Autowired
	private MockMvc mockMvc;

	@Autowired
	DeploymentController dc;

	@Autowired
	DeploymentRepository rep;

	@Autowired
	HttpSession ses;

	@Before
	public void setup() {
		mockMvc = MockMvcBuilders.standaloneSetup(dc).build();

	}

	@Test
	public void viewTest() throws Exception {

		ArrayList<DeploymentEntity> list = rep.findDeploymentByDeleteFlag();

		mockMvc.perform(get("/depTop"))
				.andExpect(status().isOk())
				.andExpect(view().name("departmentTop"))
				.andExpect(model().attribute("title", "部署管理"))
				.andExpect(model().attribute("deploymentData", list));

	}

}

```

JUnitによるAssertion errorの原因がわからない

次のような条件のユニットテストを実施したいです。
0. ソースは既存であり、手を入れることはできない
0. このソースに対して関数単位のテストを実施したい
0. テスト対象となる関数から呼ばれる関数はスタブとしたい
0. スタブにする関数は、テスト対象と同一のソースに含まれる場合がある

この場合、4番目の同一ソースのスタブがネックになると思います。
既存ソースには手を入れずに同一ソースにある関数をスタブにしてユニットテストを行う方法があれば教えてください。

実は過去に実施済みで、その時は、散々調べて、試行錯誤した結果、「できない」という結論に至りました。
結局、泣く泣く既存ソースに次のようなコード（#ifdef UNITTEST～#endif）を足すことなってしまいました。

既存ソース側
```C
#ifdef UNITTEST
#define func1	(*pfunc1)
#define func2	(*pfunc2)
#endif // UNITTEST
static void test(void)
{
	func1();
	func2();
～
}
#undef func1
#undef func2
void func1(void)
{
～
}
void func2(void)
{
～
}
```

テストコード側
```C
void testcode(void)
{
	pfunc1 = func1_stub;
	pfunc2 = func2_stub;
	test();
}
```

実際にはもう少し簡潔に書けるように、インクルードファイルを作ったりしました。

既存ソースに手を入れずに同一ソース内の関数をスタブにしてユニットテストを実施する方法

会社でテストの品質が悪く、単体テストレベルのバグがお客様の総合テストで数多く発見され、ある一定の品質を保つためにテスト仕様書を作成することになりました。
テスト仕様書のひな形を作成するように言われたのですが、いい例を見つけられずに困っています。
いい例を紹介いただけませんでしょうか？
よろしくお願い致します。

テスト仕様書について

Laravelでcontrollerのテストを書いています。
関数Bのユニットテストをした場合に、
関数Aのテストコードはどんな内容を書くのがいいのでしょうか？

関数Aでも関数Bのメール通知とresponseの内容のテストを書くべきですか？
それとも関数Bの内容は重複するため、関数Aのテストではresponseの内容だけテストコードを書くのがよろしいですか？

テストコードについて無知のためご教授お願いします。
```
    public function A()
    {
        $hoge = "hoge";
        BBB($hoge)
        return response()->json(['hoge' => $hoge], 200);
    }

    public function B($hoge)
    {
       // メール通知処理
    }
```




laravelのテストの書き方について

### 前提
laravelでテストコード(PHPUnit)を書いていますが、
処理の中でDBのテーブルにレコードをINSERTした後に、
デバッグで一時停止した状態でコマンドラインからテーブルをSELECTすると、
結果が反映されていない状態(レコード0件)で結果が返ってきます。（想定としてはSELECTの結果レコードが返ってくるはず）

use RefreshDatabase;をコメントアウトすると、想定通りレコードが返ってくるので、
RefreshDatabaseが関係していると思ったのですが、どうしても想定通りになりませんでした。

### 実現したいこと
デバッグで一時停止した状態でSELECTしたら、想定通りレコードが返ってくるようにしたいです。
または仕様として、レコードが返ってこない仕様なのであればそれを知りたいです。

### 意図
テストコード書くのは初心者です。
テストコードの中で、seeder等でテストデータを入れたりしたいので、
デバッグで一時停止して、DBの値を見ながらテストコードを書きたいと思った次第です。
（そもそもテストコードをデバッグするということ自体が間違っているのでしょうか・・？）

### 環境
MacBookAir macOS Monterey 12.4 Intel
Docker Desktop(ローカル開発・検証)
PHP 8.1.12
Laravel Framework 8.75
PHPUnit 9.5.10
Xdebug 3.2.0

### 検証用のプロジェクトリポジトリ(GitHub)
https://github.com/corock510/Experiment

### 該当のソースコード
```UserTest.php
<?php

namespace Tests\Feature;

use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Log;
use Tests\TestCase;

use Illuminate\Support\Facades\DB;

class UserTest extends TestCase
{
    use RefreshDatabase;

    /**
     * A basic feature test example.
     *
     * @return void
     */
    public function test_create_user()
    {
        //クエリビルダを用いて、usersテーブルに2件レコード追加（本来ここはテストコードではなくテスト対象のクラスのメソッドに書きますが、便宜的にここにINSERT処理を書いています。）
        DB::table('users')->insert([
            ['name' => 'A', 'email' => '1@test.com', 'password' => 'aaa'],
            ['name' => 'B', 'email' => '2@test.com', 'password' => 'aaa']
        ]);

        //検証用 ブレークポイント usersテーブルにselect文流して$getValに代入
        $getVal = DB::table('users')->select('name')->get();

        //検証用 ログ(src/storage/logs/laravel.log)に$getValの値を書き込み
        Log::info($getVal);

        //usersテーブルの件数が2件であればテストOK
        $this->assertDatabaseCount(table: 'users', count: 2);
    }
}
```

### 詳細
上記のUserTest.phpでは、usersテーブルにレコードを2件INSERTし、その件数が2件であることをテストしています。
INSERT処理の直後(29行目)にブレークポイントを張ってデバッグで一時停止した状態で、コマンドライン上からMySQLに接続し、  
usersテーブルにSELECT文を流すと、結果は2件のはずが、0件(Empty set)で返ってきます。  
その後、UserTest.phpをステップ実行すると、想定通り2件取得できています。  

冒頭でも書きましたが、13行目のuse RefreshDatabase;をコメントアウトすると、④で想定通り2件返ってきます。  

### 検証手順
①拡張機能のxDebugをインストール済の状態で【cmd + shift + D】【F5】でxDebugを実行  
②UserTest.phpの29行目selectの処理にブレークポイントを設定（Error Exception Uncaught Exceptionのチェックを外す）  
③下記記載(1)の方法で、UserTest実行（②のブレークポイントで一時停止する）  
④下記記載(2)の方法で、コマンドライン上でMySQLに接続して、usersテーブルにSELECT文を流す（結果は2件のはずが、0件(Empty set)で返ってくる）  
⑤UserTest.phpの処理をステップ実行する（想定通り2件取得できている）  

(1)UserTest実行
$ docker compose exec php bash  
\# ./vendor/bin/phpunit tests/Feature/UserTest.php  

(2)DB接続、usersテーブルSELECT文発行
$ docker compose exec db mysql -u root -p  
password  
\> use database;  
\> select name from users;    

---
何卒、よろしくお願いいたしますm(_ _)m


laravelのテストコードをデバッグした際にDBデータが反映されない【RefreshDatabase】

### 前提・実現したいこと

JavaでSpringが提供している`MessageSource`インターフェイスを使用しているメソッドを作成しました。
``` Java
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.MessageSource;
import org.springframework.stereotype.Service;

import java.util.Locale;

@Service
public class MessageService {
    @Autowired
    MessageSource messageSource;

    public String getMessageByCode(String code) {
        return messageSource.getMessage(code, null, Locale.getDefault());
    }
}
```

 
上記の`getMessagebyCode`メソッドをテストするためのテストケースをMockitoを用いて作成しました。
``` Java
import org.junit.jupiter.api.Test;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.springframework.context.MessageSource;

import java.util.Locale;

import static org.junit.jupiter.api.Assertions.*;
import static org.mockito.Mockito.doReturn;

class MessageServiceTest {

    @InjectMocks
    MessageService service;
    @Mock
    MessageSource mockMessageSource;

    @Test
    void getMessageByCode() {
        doReturn("Hello!").when(mockMessageSource)
                .getMessage("greeting", null, Locale.getDefault());

        // テスト実行
        String actualMessage = service.getMessageByCode("greeting");
        assertEquals("Hello!", actualMessage);
    }
}
```

### 発生している問題・エラーメッセージ
`MessageServiceTest`クラスの`getMessageByCode`メソッドを実行し、テストを行うと以下のようなエラーが出力されます。
テストコードをどのように修正すればよいのか、回答をよろしくおねがいします。

```
org.mockito.exceptions.misusing.NullInsteadOfMockException: 
Argument passed to when() is null!
Example of correct stubbing:
    doThrow(new RuntimeException()).when(mock).someMethod();
Also, if you use @Mock annotation don't miss initMocks()
```


### 補足情報（FW/ツールのバージョンなど）

下記に作成したコードを公開しています。
[GitHubのリポジトリ](https://github.com/kgSuzuki1994/spring-mockito)