Package com.codename1.backend.test

package com.codename1.backend.test

Testing a backend the way Spring Boot tests are written, on the JVM and as a compiled native test.

A class annotated BackendTest gets the application the build wired, started in the test with the test profile -- an in-memory database, tables created -- and its @Autowired fields filled from it:

@BackendTest
class GreeterApiTest {
    @Autowired MockMvc mvc;
    @Autowired Greeter greeter;

    @Test
    void greets() throws Exception {
        mvc.perform(get("/greet/{name}", "Ada"))
                .andExpect(status().isOk())
                .andExpect(content().string("Hello, Ada"));
    }
}

The same source runs two ways. Under Maven Surefire it is an ordinary JUnit 5 test. With -Dcn1.backend.compiledTests=true the build translates it with the application and runs it as a native binary, the way the server ships -- there is no JUnit and no reflection in that binary, so the build finds the tests in the bytecode and writes the calls itself.

The names follow Spring's so a test ports by changing its imports: MockMvc, perform, MockMvcRequestBuilders, MockMvcResultMatchers, TestConfiguration, MockitoBean, LocalServerPort and TestRestTemplate. What is left out is what Spring keeps for compatibility with servlets.

Related Packages

Package	Description
com.codename1.backend	The Codename One backend runtime: the server side of an application, written in the same Java as the app and compiled to a native server binary.

Class	Description
BackendTest	Runs a test class against the application the build wired: what @SpringBootTest does.
BackendTest.WebEnvironment	How a BackendTest reaches the application.
ContentResultMatchers	Expectations of the response body, from MockMvcResultMatchers.content().
CookieResultMatchers	Expectations of the cookies a response sets, from MockMvcResultMatchers.cookie().
HeaderResultMatchers	Expectations of the response headers, from MockMvcResultMatchers.header().
HttpEntity<T>	A body and its headers, for TestRestTemplate.exchange(String, HttpMethod, HttpEntity, Class, Object...).
HttpHeaders	Request or response headers: names in any case, each with its values in order.
HttpMethod	The methods TestRestTemplate.exchange(String, HttpMethod, HttpEntity, Class, Object...) sends.
HttpStatus	The common response statuses, so assertEquals(HttpStatus.OK, response.getStatusCode()) reads as it does in Spring.
HttpStatusCode	A response status: an HttpStatus for the common ones, or any other code.
JsonPathResultMatchers	Expectations of one JSONPath into the JSON body, from MockMvcResultMatchers.jsonPath(String, Object...).
LocalServerPort	Injects the port the BackendTest's server listens on into an int field.
MediaType	Media types, for contentType(...) and accept(...).
MockitoBean	Replaces every bean of the field's type with a Mockito mock, and injects it:
MockMultipartFile	A file part for MockMvcRequestBuilders.multipart(String, Object...).
MockMultipartRequestBuilder	A multipart/form-data request, from MockMvcRequestBuilders.multipart(String, Object...): files and fields, encoded as a browser's form post would be.
MockMvc	Calls a running backend's routes in the same process: no socket, no port, the same answer.
MockMvcRequestBuilders	The requests MockMvc sends, for static import:
MockMvcResultHandlers	Handlers for andDo(...), for static import.
MockMvcResultMatchers	The expectations andExpect(...) takes, for static import:
MockRequestBuilder	One request for MockMvc, built by MockMvcRequestBuilders.
MockResponse	What a MockMvc request came back with.
MvcResult	One MockMvc exchange: what was sent and what came back.
ResponseEntity<T>	A TestRestTemplate response: status, headers and the body converted to the type asked for.
ResultActions	What to do with a MockMvc result: assert on it, act on it, or return it.
ResultHandler	Something done with a MockMvc result, such as MockMvcResultHandlers.print().
ResultMatcher	One expectation of a MockMvc result, from MockMvcResultMatchers.
StatusResultMatchers	Expectations of the response status, from MockMvcResultMatchers.status().
TestConfiguration	A class whose @Bean methods add beans for a BackendTest, and only for it.
TestRestTemplate	An HTTP client for a BackendTest served on a port -- webEnvironment = RANDOM_PORT -- through the backend's own outbound client, so a compiled test sends real requests from the native binary too.