Skip to main content

Unit Tests

The test suite uses WireMock to mock all external HTTP calls. No real network access is required.

Running tests​

# All unit tests
mvn test

# Smart Health IT sandbox profile (requires network)
mvn test -Psmart

# Epic sandbox profile (requires Epic credentials)
mvn test -Pepic

Test structure​

src/test/java/com/akhester/smartfhir/
├── controller/
│   ├── SmartLaunchControllerTest.java    @WebMvcTest
│   ├── SmartCallbackControllerTest.java  @WebMvcTest
│   └── PatientDataControllerTest.java    @WebMvcTest
├── service/
│   ├── SmartDiscoveryServiceTest.java    WireMock
│   ├── SmartTokenServiceTest.java        WireMock
│   └── IdTokenValidatorTest.java         RSA key generation
├── security/
│   └── PkceHelperTest.java               Crypto tests
└── integration/
    ├── SmartHealthSandboxIT.java         @ActiveProfiles("smart")
    └── EpicSandboxIT.java                @ActiveProfiles("epic")

Example: SmartCallbackControllerTest​

@WebMvcTest(SmartCallbackController.class)
class SmartCallbackControllerTest {

    @Autowired MockMvc mockMvc;
    @MockBean  SmartTokenService tokenService;
    @MockBean  IdTokenValidator  idTokenValidator;
    @MockBean  SmartContextExtractor extractor;

    @Test
    void validCallback_redirectsToDashboard() throws Exception {
        when(tokenService.exchangeCode(any(), any()))
            .thenReturn(mockTokenResponse());
        when(extractor.extract(any()))
            .thenReturn(mockLaunchContext());

        mockMvc.perform(get("/callback")
                .param("code", "auth-code-001")
                .param("state", "valid-state")
                .sessionAttr("pkce", mockPkce()))
            .andExpect(status().is3xxRedirection())
            .andExpect(redirectedUrl("/dashboard"));
    }

    @Test
    void invalidState_returns400() throws Exception {
        mockMvc.perform(get("/callback")
                .param("code", "auth-code-001")
                .param("state", "wrong-state")
                .sessionAttr("pkce", mockPkce()))
            .andExpect(status().is3xxRedirection())
            .andExpect(redirectedUrl("/launch?error=invalid_state"));
    }
}

Example: WireMock for discovery​

@ExtendWith(WireMockExtension.class)
class SmartDiscoveryServiceTest {

    @RegisterExtension
    static WireMockExtension wm = WireMockExtension.newInstance().build();

    @Test
    void discovery_parsesSmartConfiguration() {
        wm.stubFor(get("/.well-known/smart-configuration")
            .willReturn(okJson(SMART_CONFIG_JSON)));

        SmartConfiguration config = service.discover(wm.baseUrl());

        assertThat(config.authorizationEndpoint())
            .isEqualTo(wm.baseUrl() + "/oauth2/authorize");
        assertThat(config.tokenEndpoint())
            .isEqualTo(wm.baseUrl() + "/oauth2/token");
    }
}

Next: SMART Sandbox →