Recently, I have received a test task to write a test automation framework for API testing with Java. I think it could be interesting for others and I would like to share the results.<\/p>\n
The framework was written with Java. Maven<\/a>, Lombok<\/a>, testNG<\/a> and Rest Assured<\/a> were also used. The framework consists of clients and test layers. If the tests are planned to be E2E or the business logic is complicated, then a business layer, which contains a few API clients, could be added. Also, you could also add a Cucumber layer.<\/p>\n The main idea is to generalize the base API client, which contains main basic API methods (GET, POST, PUT and DELETE). This gives us an opportunity to use one client to interaction with almost all endpoints. Also, it allows configuring the Rest Assured log in one place through baseAPIClient.<\/p>\n Two wrappers, which were generalized, were created to have a unified approach. RequestWrapper and ResponseWrapper get their types in tests. Also, they contain raw data from the Rest Assured.<\/p>\n BaseAPIClient can be used to interact with different endpoints. However, I recommend creating a separate client for every endpoint, which inherits from BaseAPIClient main functionality. Separate API clients could be expanded with specific API methods like search and filter. Base API method from BaseAPIClient can be overridden.<\/p>\n I support the ideas of isolation and managing state of application. You can read more about this in my previous article (Automated Testing Principles<\/a>). I encourage you to create and remove test data in before and after methods. It will increase tests reliability.<\/p>\n I recommend writing test, which cover one REST method, in one class because the preconditions are complicated and can be different for every REST method. Also, I recommend grouping a few asserts in one test method because of optimization. The more atomic approach is valid.<\/p>\n This test has a presentation goal and is being failed because the testing API application does not actually create and remove entities.<\/p>\n The full code can be found on GitLab<\/a><\/p>\n About the Author<\/strong><\/p>\n Oleksandr Podoliako has been working in different software projects as a test automation<\/a> engineer since 2017. His main technology stack is the Java stack. He has passed more than 5 IT certifications. He has written a few testing related topics and has conducted more than 30 interviews in different languages with candidates from all over the world.<\/p>\n![\"Test](\"https:\/\/www.softwaretestingmagazine.com\/wp-content\/uploads\/apijava2.jpg\")
<\/a><\/p>\n\r\npublic class BaseAPIClient {\r\n \/\/some code was cut\r\n\r\n public <T, K> ResponseWrapper<T> getEntity(Class<T> t, RequestWrapper<K> requestWrapper, String url) {\r\n ResponseWrapper<T> responseWrapper = new ResponseWrapper<>();\r\n Response response = configureRequest(requestWrapper)\r\n .when()\r\n .get(url);\r\n\r\n responseWrapper.setBody(response.as(t));\r\n responseWrapper.setResponseRaw(response);\r\n\r\n configureResponse(responseWrapper);\r\n\r\n return responseWrapper;\r\n }\r\n\r\n \/\/some code was cut\r\n\r\n private <T> RequestSpecification configureRequest(RequestWrapper<T> requestWrapper) {\r\n RequestSpecification requestSpecification = RestAssured.given();\r\n\r\n switch (logRequest()) {\r\n case "all":\r\n requestSpecification.log().all();\r\n case "parameters":\r\n requestSpecification.log().parameters();\r\n default:\r\n requestSpecification.log().method();\r\n }\r\n\r\n\r\n if (requestWrapper.getHeaders() != null) {\r\n for (String key : requestWrapper.getHeaders().keySet()) {\r\n requestSpecification.header(key, requestWrapper.getHeaders().get(key));\r\n }\r\n }\r\n\r\n if (requestWrapper.getQueryParameters() != null) {\r\n for (String key : requestWrapper.getQueryParameters().keySet()) {\r\n requestSpecification.queryParam(key, requestWrapper.getQueryParameters().get(key));\r\n }\r\n }\r\n\r\n return requestSpecification;\r\n }\r\n\r\n \/\/some code was cut\r\n}\r\n<\/pre>\n\r\n@Getter\r\n@Setter\r\n@Builder\r\npublic class RequestWrapper<T> {\r\n\r\n private Map<String, String> headers;\r\n private Map<String, String> queryParameters;\r\n\r\n private T body;\r\n}\r\n<\/pre>\n\r\n@Getter\r\n@Setter\r\npublic class ResponseWrapper<T> {\r\n private T body;\r\n private Response responseRaw;\r\n\r\n public int getStatusCode() {\r\n return responseRaw.getStatusCode();\r\n }\r\n}\r\n<\/pre>\n\r\npublic class PostsClient extends BaseAPIClient{\r\n}\r\n<\/pre>\n\r\n@BeforeMethod\r\npublic void init() {\r\n postsClient = new PostsClient();\r\n softAsserts = new SoftAssert();\r\n\r\n Post post = Post.builder()\r\n .userId(1)\r\n .title("title")\r\n .body("body")\r\n .build();\r\n\r\n RequestWrapper<Post> requestWrapper = RequestWrapper.<Post>builder()\r\n .headers(HEADERS)\r\n .body(post)\r\n .build();\r\n\r\n responseWrapperPreconditions = postsClient.postEntity(Post.class, requestWrapper, URL);\r\n}\r\n<\/pre>\n\r\n@AfterMethod\r\npublic void cleanup() {\r\n RequestWrapper<Post> requestWrapper = RequestWrapper.<Post>builder()\r\n .headers(HEADERS)\r\n .body(responseWrapperPreconditions.getBody())\r\n .build();\r\n\r\n postsClient.deleteEntity(Post.class, requestWrapper\r\n , URL + responseWrapperPreconditions.getBody().getId());\r\n}\r\n<\/pre>\n\r\n@Test\r\npublic void testGetPosts() {\r\n RequestWrapper<Post> requestWrapper = RequestWrapper.<Post>builder()\r\n .headers(HEADERS)\r\n .build();\r\n\r\n\r\n ResponseWrapper<Post> responseWrapper = postsClient.getEntity(Post.class, requestWrapper\r\n , URL + responseWrapperPreconditions.getBody().getId());\r\n\r\n softAsserts.assertEquals(responseWrapper.getStatusCode(), 200\r\n , "Response status code should be 200");\r\n\r\n softAsserts.assertTrue((isJsonSchemaValid("postsGetSchema.json",\r\n convertToStringJSON(responseWrapper.getBody())))\r\n , "The search returns response with invalid json schema");\r\n\r\n softAsserts.assertEquals(responseWrapper.getBody().getId(), responseWrapperPreconditions.getBody().getId()\r\n , "Response id should be correct");\r\n softAsserts.assertEquals(responseWrapper.getBody().getUserId(), responseWrapperPreconditions.getBody().getUserId()\r\n , "Response userId should be correct");\r\n softAsserts.assertEquals(responseWrapper.getBody().getTitle(), responseWrapperPreconditions.getBody().getTitle()\r\n , "Response title should be correct");\r\n softAsserts.assertEquals(responseWrapper.getBody().getBody(), responseWrapperPreconditions.getBody().getBody()\r\n , "Response body should be correct");\r\n softAsserts.assertAll();\r\n}\r\n<\/pre>\n