オプションのパス変数を使用したSpring MVCのメソッドがあります。オプションのパス変数が提供されていないシナリオでテストしようとしています。
コントローラーのスニペット、呼び出すリソースURI
@RequestMapping(value = "/some/uri/{foo}/{bar}", method = RequestMethod.PUT)
public <T> ResponseEntity<T> someMethod(@PathVariable("foo") String foo, @PathVariable(value = "bar", required = false) String bar) {
LOGGER.info("foo: {}, bar: {}", foo, bar);
}
MockMvcを使用したテストのスニペット-
//inject context
@Autowired
private WebApplicationContext webApplicationContext;
protected MockMvc mockMvc;
@Before
public void setup() {
//build mockMvc
mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext).build();
}
@Test
public void someMethodTest() throws Exception {
//works as expected
mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", "bar"))
.andExpect(status().isOk()); //works
//following doesn't work
//pass null for optional
mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", null))
.andExpect(status().isOk()); //throws 404
//pass empty for optional
mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", ""))
.andExpect(status().isOk()); //throws 404
//remove optional from URI
mockMvc.perform(put("/some/uri/{foo}", "foo"))
.andExpect(status().isOk()); //throws 404
}
このような@RequestMapping
値の配列の使用...
@RequestMapping(value = {"/some/uri/{foo}", "/some/uri/{foo}/{bar}"}, method = RequestMethod.PUT)
public ResponseEntity<String> someMethod(@PathVariable("foo") String foo, @PathVariable(value = "bar", required = false) String bar) {
return new ResponseEntity<>(foo + " and " + (bar == null ? "<null>" : bar), HttpStatus.OK);
}
...このテストに合格します:
@Test
public void someMethodTest() throws Exception {
MvcResult mvcResult = mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", "bar"))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and bar", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", null))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/{foo}/{bar}", "foo", ""))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/{foo}", "foo"))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
}
それは確かに最も簡単な解決策であるように思われ、マッピングを明示的にするため、Swaggerなどのツールにとってより使いやすいと思われます。
ただし、ワイルドカードマッピングを宣言し、コントローラーメソッド内でパスマッチャーを使用してリクエストURIを解釈することもできます。たとえば、このメソッド...
private final AntPathMatcher antPathMatcher = new AntPathMatcher();
@RequestMapping(value = "/some/uri/with/wildcards/**", method = RequestMethod.PUT)
public ResponseEntity<String> someMethod(HttpServletRequest request) {
String matched = antPathMatcher.extractPathWithinPattern(
(String) request.getAttribute(HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE), request.getPathInfo());
// ugly parsing code to read the path variables, allowing for the optionality of the second one
String foo = matched;
String bar = null;
String[] pathVariables = matched.split("/");
if (pathVariables.length > 1) {
foo = pathVariables[0];
bar = pathVariables[1];
}
return new ResponseEntity<>(foo + " and " + (bar == null ? "<null>" : bar), HttpStatus.OK);
}
...このテストに合格します:
@Test
public void someMethodTestWithWildcards() throws Exception {
MvcResult mvcResult = mockMvc.perform(put("/some/uri/with/wildcards/{foo}/{bar}", "foo", "bar"))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and bar", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/with/wildcards/{foo}/{bar}", "foo", null))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/with/wildcards/{foo}/{bar}", "foo", ""))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
mvcResult = mockMvc.perform(put("/some/uri/with/wildcards/{foo}", "foo"))
.andExpect(status().isOk()).andReturn();
Assert.assertEquals("foo and <null>", mvcResult.getResponse().getContentAsString());
}
これは遅いですが、私は最近この状況に直面し、この投稿が他の人を助けると思いました。
オプションのリクエストパラメータまたはパス変数を使用してエンドポイントをモックする場合、次のように指定できます。
コントローラーから呼び出されるm1(String param1, String param2)
としてparamsを持つメソッドがあるとします。
パラメーター2はコントローラーのオプションのパラメーターであるため、渡されない場合は実行時にnullが渡されます。
モックの方法:
_Mockito.when(m1(Mockito.anyString(), Mockito.eq(null)).the return(<whatever you want to return>)
_
テストでMockito.eq(null)
を使用して、オプションのパラメーターのnullとして渡します。