starred/WireMock.Net
1
0
Fork 0
mirror of https://github.com/wiremock/WireMock.Net.git synced 2026-04-23 09:18:55 +02:00
Code Issues 32 Packages Projects Releases 10 Wiki Activity

Updated Scenarios and States (markdown)

Stef Heyenrath
2020-08-30 10:25:44 +02:00
parent 29f9a87361
commit 66db8d89b5
1 changed files with 47 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

72
Scenarios-and-States.md

@@ -1,41 +1,41 @@
# Scenarios # Using Scenarios
WireMock.Net supports state via the notion of scenarios. A scenario is essentially a state machine whose states can be arbitrarily assigned. Stub mappings can be configured to match on scenario state, such that stub A can be returned initially, then stub B once the next scenario state has been triggered. WireMock.Net supports _State_ via the notion of _scenarios_. A scenario is essentially a state machine whose states can be arbitrarily assigned. Stub mappings can be configured to match on scenario state, such that stub A can be returned initially, then stub B once the next scenario state has been triggered.
For example, suppose we’re writing a to-do list application consisting of a rich client of some kind talking to a REST service. We want to test that our UI can read the to-do list, add an item and refresh itself, showing the updated list. For example, suppose we’re writing a to-do list application consisting of a rich client of some kind talking to a REST service. We want to test that our UI can read the to-do list, add an item and refresh itself, showing the updated list.
Example test code: Example test code:
```c# ``` c#
// Assign // Assign
_server = WireMockServer.Start(); _server = WireMockServer.Start();
_server _server
.Given(Request.Create() .Given(Request.Create()
.WithPath("/todo/items") .WithPath("/todo/items")
.UsingGet()) .UsingGet())
.InScenario("To do list") .InScenario("To do list")
.WillSetStateTo("TodoList State Started") .WillSetStateTo("TodoList State Started")
.RespondWith(Response.Create() .RespondWith(Response.Create()
.WithBody("Buy milk")); .WithBody("Buy milk"));
_server _server
.Given(Request.Create() .Given(Request.Create()
.WithPath("/todo/items") .WithPath("/todo/items")
.UsingPost()) .UsingPost())
.InScenario("To do list") .InScenario("To do list")
.WhenStateIs("TodoList State Started") .WhenStateIs("TodoList State Started")
.WillSetStateTo("Cancel newspaper item added") .WillSetStateTo("Cancel newspaper item added")
.RespondWith(Response.Create() .RespondWith(Response.Create()
.WithStatusCode(201)); .WithStatusCode(201));
_server _server
.Given(Request.Create() .Given(Request.Create()
.WithPath("/todo/items") .WithPath("/todo/items")
.UsingGet()) .UsingGet())
.InScenario("To do list") .InScenario("To do list")
.WhenStateIs("Cancel newspaper item added") .WhenStateIs("Cancel newspaper item added")
.RespondWith(Response.Create() .RespondWith(Response.Create()
.WithBody("Buy milk;Cancel newspaper subscription")); .WithBody("Buy milk;Cancel newspaper subscription"));
// Act and Assert // Act and Assert
string url = "http://localhost:" + _server.Ports[0]; string url = "http://localhost:" + _server.Ports[0];
@@ -65,4 +65,26 @@ The first Scenario and State definition can also be used in the JSON Admin inter
"Body": "Buy milk" "Body": "Buy milk"
} }
} }
```
# Stay in the same State for a number of requests
In case you want to match a request for a certain state multiple times before moving to the next state, you can specify this. Example code:
In the above scenario, if you want to add more items to the ToDo list, like
- Fixing the car
- Cancel newspaper
And you want to move to the next state when these two requests are matched, set the `times` variable to `2` like this:
``` c#
_server
.Given(Request.Create()
.WithPath("/todo/items")
.UsingPost())
.InScenario("To do list")
.WhenStateIs("TodoList State Started")
.WillSetStateTo("Cancel newspaper item added", 2) // <-- The number of times this match should be matched before the state will be changed to the specified one.
.RespondWith(Response.Create()
.WithStatusCode(201));
``` ```