throwExceptionWhen

クラス: matlab.mock.TestCase
名前空間: matlab.mock

メソッドの呼び出しやプロパティの相互作用に対して例外をスロー

このページをすべて展開する

構文

throwExceptionWhen(testcase,behavior) throwExceptionWhen(testcase,behavior,exception)

説明

throwExceptionWhen(testcase,behavior) は、メソッドが呼び出された場合、またはプロパティがアクセスまたは設定された場合にモックが例外をスローすることを指定します。

throwExceptionWhen(testcase,behavior,exception) は、モックがスローする例外を指定します。

入力引数

すべて展開する

`testcase` — テストケースのインスタンス
`matlab.mock.TestCase` オブジェクト

テストケースのインスタンス。matlab.mock.TestCase オブジェクトとして指定します。

`behavior` — モックの動作
`matlab.mock.MethodCallBehavior` インスタンス | `matlab.mock.PropertyGetBehavior` インスタンス | `matlab.mock.PropertySetBehavior` インスタンス

モックの動作。matlab.mock.MethodCallBehavior、matlab.mock.PropertyGetBehavior または matlab.mock.PropertySetBehavior インスタンスとして指定します。matlab.mock.MethodCallBehavior のインスタンスを作成するには、behavior オブジェクトのメソッドを呼び出します。matlab.mock.PropertyGetBehavior のインスタンスを作成するには、behavior オブジェクトのプロパティで get メソッドを呼び出します。matlab.mock.PropertySetBehavior のインスタンスを作成するには、behavior オブジェクトのプロパティで set メソッドを呼び出します。

例: withExactInputs(behavior.myMockedMethod)

例: get(behavior.MyMockedProperty)

例: set(behavior.MyMockedProperty)

`exception` — メソッドの呼び出しまたはプロパティの相互作用でスローする例外
スカラー `MException` オブジェクト

メソッドの呼び出しやプロパティの操作が実行された場合にフレームワークがスローする例外。スカラー MException オブジェクトとして指定します。

例: MException('MyProduct:myID','My exception message.')

例

すべて展開する

例外のスロー

メソッドが呼び出された場合、またはプロパティがアクセスまたは設定された場合に例外をスローします。

testCase = matlab.mock.TestCase.forInteractiveUse;
[mock,behavior] = testCase.createMock('AddedProperties',"PropertyFoo", ...
    'AddedMethods',"methodBar");
testCase.throwExceptionWhen(get(behavior.PropertyFoo));
testCase.throwExceptionWhen(set(behavior.PropertyFoo), ...
    MException('PropertyFoo:set', 'Do not change PropertyFoo'));
testCase.throwExceptionWhen(withAnyInputs(behavior.methodBar));

% Carry out actions
mock.PropertyFoo
mock.PropertyFoo = 123;
mock.methodBar;

代替方法

throwExceptionWhen メソッドの使用は、matlab.mock.actions.ThrowException アクションを MethodCallBehavior クラス、PropertyGetBehavior クラスまたは PropertySetBehavior クラスの when メソッドとあわせて使用するのと機能的には同じです。たとえば、次のコードブロックは機能的に等価です。

% Using the throwExceptionWhen method
testCase.throwExceptionWhen(behavior.deposit(IsLessThan(0)), ...
    MException('Account:deposit:Negative', ...
    'Deposit amount must be positive.'));

% Using the ThrowException action with the when function
import matlab.mock.actions.ThrowException
when(behavior.deposit(IsLessThan(0)),ThrowException( ...
    MException('Account:deposit:Negative', ...
    'Deposit amount must be positive.')))