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.Feature	A production feature BackendTest.features() can add to the test's application.
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().
DataJpaTest	Tests persistence without the rest of the application: what Spring's @DataJpaTest does.
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.
ManagementContract	The operational contract of a server with management on, as tests a test class inherits: implement it on a BackendTest with BackendTest.Feature.MANAGEMENT and a port, and its default @Test methods check the probes, the endpoint authentication, the metric schema and the Prometheus scrape against that application.
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.
OtlpTestCollector	An OTLP/HTTP receiver for tests: what a test points the exporters of a BackendTest.Feature.TELEMETRY application at, to see that they send and that they flush when the application stops.
RequestPostProcessor	Changes a request MockMvc is about to send: what MockRequestBuilder.with(RequestPostProcessor) takes.
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.
SecurityMockMvcRequestPostProcessors	What a test says about one request's security, for static import:
SecurityMockMvcRequestPostProcessors.ApiKeyRequestPostProcessor	SecurityMockMvcRequestPostProcessors.apiKey(String), to refine.
SecurityMockMvcRequestPostProcessors.CsrfRequestPostProcessor	SecurityMockMvcRequestPostProcessors.csrf(), to refine.
SecurityMockMvcRequestPostProcessors.JwtRequestPostProcessor	SecurityMockMvcRequestPostProcessors.jwt(), to refine.
SecurityMockMvcRequestPostProcessors.UserRequestPostProcessor	SecurityMockMvcRequestPostProcessors.user(String), to refine.
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.
TestSecurityContextHolder	Who the calling thread's tests are running as.
WebMvcTest	Tests controllers without the rest of the application: what Spring's @WebMvcTest does.
WithAnonymousUser	Runs a test as nobody: for one test of a class that is otherwise WithMockUser.
WithMockUser	Runs a test, or every test of a class, as a signed-in user who exists nowhere but in the test: no user store is asked and no password checked.