[SOLVED] Java Week13 Coding Assignment

Description

Coding Steps:

1) Create a Maven project named JeepSales as described in the video.

1. a) In Spring Tool Suite, click the “File” menu. Select “New/Project…”. In the popup,

expand “Maven” and select “Maven Project”. Click “Next”.

1. b) Check “Create a simple project (skip archetype selection)”. Click “Next”.
2. c) Enter the following:

Group Id

com.promineotech

Artifact Id jeep-sales

1. d)

Click “Finish”.

2) Navigate to the Spring Initializr (https://start.spring.io/).

1. a) Confirm the following settings:

Project

Maven Project

Language

Java

Spring Boot

Select the latest stable version (not SNAPSHOT or RC)

Group

com.promineotech

Artifact

jeep-sales

Name

jeep-sales

Description

Jeep Sales

Package name com.promineotech

Packaging

Jar

Java

11 (or whatever your version is)Web API Design with Spring Boot Week 13 Coding Assignment

1. b) Add the dependencies from the Initializr:
2. i) Web
3. ii) Devtools

iii) Lombok

1. c) Click “Explore” at the bottom of the page.
2. d) Click “Copy” to copy the pom.xml generated by the Initializr to the clipboard.

3) In Spring Tool Suite, open pom.xml (in the project root directory). Select all the text in the

editor and replace it with the XML copied to the clipboard in the prior step.

4) Navigate to https://mvnrepository.com/. Search for springdoc-openapi-ui. Select the latest

version and add the entry to the POM file in the <dependencies> section.

5) Create a package in src/main/java named com.promineotech.jeep. In this package:

1. a) Create a Java class with a main method named JeepSales.
2. b) Add a class-level annotation: @SpringBootApplication and the import statement.
3. c) In the main() method, add a call to run();. Use JeepSales.class as

the first parameter, and the args parameter that was passed into the main() method as the

second. The entire class should look like this:

package com.promineotech.jeep;

import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication

public class JeepSales {

public static void main(String[] args) {

SpringApplication.run(JeepSales.class, args);

6) Refer to README.docx in the supplied project resources. Copy all files in the Files folder in

the resources to your project as described in the README. Do not copy the files in the

Entity or Source folders at this time.

Page 4 of 10Web API Design with Spring Boot Week 13 Coding Assignment

1. a) Load the files that were added: right-click on the project in Package Explorer and select

“Refresh”.

1. b) Update the project with the new POM dependencies: right-click on the project in Package

Explorer, select “Maven/Update Project”. When the “Update Maven Project” panel

appears, click “OK”.

7) Using the MySQL Workbench or MySQL command line client (CLI), create a database

named “jeep”.

8) Using DBeaver, or the MySQL client of choice, load the supplied .sql files

(V1.0__Jeep_Schema.sql, and V1.1__Jeep_Data.sql) into the MySQL database to create the

tables and populate them with data. These files are found in the project folder

src/test/resources/flyway/migrations.

9) Create a new package in src/test/java named com.promineotech.jeep.controller. Create

a Spring Boot integration test named FetchJeepTest using the techniques shown in the video.

1. a) Add the @SpringBootTest, @ActiveProfiles, and @Sql annotations as described in the

video.

1. b) The class must not be public. It should have package-level access (i.e., not public,

private, or protected).

1. c) The video extended FetchJeepTestSupport, but you don’t need to do that for the

homework. Just put everything in FetchJeepTest. It should look like this:

@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)

@ActiveProfiles(“test”)

@Sql(scripts = {

“classpath:flyway/migrations/V1.0__Jeep_Schema.sql”,

“classpath:flyway/migrations/V1.1__Jeep_Data.sql”},

config = @SqlConfig(encoding = “utf-8”))

class FetchJeepTest {

}

1. d) Create a test method in FetchJeepTest. The method must have the following method

signature:

void testThatJeepsAreReturnedWhenAValidModelAndTrimAreSupplied()

1. e) Inject a TestRestTemplate in the test class. Name the variable restTemplate. Inject the

port used in the test using the @LocalServerPort annotation. Name the variable

serverPort. The variables and annotations should look like this:

@Autowired

Page 5 of 10Web API Design with Spring Boot Week 13 Coding Assignment

private TestRestTemplate restTemplate;

@LocalServerPort

private int serverPort;

10) Create a new package in src/main/java named com.promineotech.jeep.entity. In that

package, create an enum named JeepModel. Add all the jeep models from the model_id

column in the models table in the database. You can use this query in dBeaver: SELECT

DISTINCT model_id FROM models.

11) Create a Jeep class in the com.promineotech.jeep.entity package. Add the columns from

the models table into this class as instance variables. Annotate the class with the Lombok

annotations @Data, @Builder (and optionally both @NoArgsConstructor and

@AllArgsConstructor). Note that modelId should be of type JeepModel and basePrice should

be of type BigDecimal. The class should look like this (remember to add the appropriate

import statements):

@Data

@Builder

@NoArgsConstructor

@AllArgsConstructor

public class Jeep {

private Long modelPK;

private JeepModel modelId;

private String trimLevel;

private int numDoors;

private int wheelSize;

private BigDecimal basePrice;

}

12) In the supplied resources, copy all files in the Entities folder to the src/main/java/com/–

promineotech/jeep/entity folder. Do not copy anything from the Source folder at this

time.

Page 6 of 10Web API Design with Spring Boot Week 13 Coding Assignment

Page 7 of 10

13) Back in the test method that you were writing, create local variables for JeepModel, trim, and

uri. Set them appropriately like this:

Variable

Type

Variable

Name

Variable Value

JeepModel

model

JeepModel.WRANGLER

String

trim

“Sport”

String

uri

String.format(“http://localhost:%d/jeeps?model=%s&trim=%s”,

serverPort, model, trim);

14)

1. a) Send an HTTP request to the REST service that passes a JeepModel and trim level as

URI parameters (as shown in the video). Use this method call:

ResponseEntity<List<Jeep>> response = restTemplate.exchange(uri,

HttpMethod.GET, null, new ParameterizedTypeReference<>() {});

Make sure to use the import java.util.List and

org.springframework.http.HttpMethod.

1. b) Using AssertJ, test that the response that comes back from the server is 200 (success) – or

as is shown in the video: HttpStatus.OK. The code should look like this:

assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);

Use the import statements:

import static org.assertj.core.api.Assertions.assertThat;Web API Design with Spring Boot Week 13 Coding Assignment

1. c) Produce a screenshot showing the completed test class.

15) In src/main/java, create a new package com.promineotech.jeep.controller. In this

package, create an interface named JeepSalesController.

1. a) Add the class-level annotation @RequestMapping(“/jeeps”).
2. b) Add the fetchJeeps method in a controller interface with the following signature:

List<Jeep> fetchJeeps(JeepModel model, String trim);

Make sure you use the List from java.util.List.

1. c) Add OpenAPI documentation to document the four possible outcomes: 200 (success),

400 (bad input), 404 (not found) and 500 (unplanned error) as shown in the video.

1. d) Add the parameter annotations in the OpenAPI documentation to describe the model and

trim parameters.

1. e) Add the @GetMapping annotation and the @ResponseStatus(code = HttpStatus.OK)

annotation as method-level annotations to the fetchJeeps method.

1. f) Add the @RequestParam annotations to the parameters as described in the video. The

interface should look like this (omitting the OpenAPI annotations):

@RequestMapping(“/jeeps”)

public interface JeepSalesController {

@GetMapping

@ResponseStatus(code = HttpStatus.OK)

List<Jeep> fetchJeeps(@RequestParam JeepModel model,

@RequestParam String trim);

}

Page 8 of 10Web API Design with Spring Boot Week 13 Coding Assignment

1. g) Produce a screenshot showing the interface and OpenAPI documentation.

16) Add the controller implementation class named DefaultJeepSalesController. Don’t forget

the @RestController annotation.

17) Run the application within the IDE and show the resulting OpenAPI (Swagger)

documentation produced in the browser. Produce a screenshot of the documentation showing

Page 9 of 10Web API Design with Spring Boot Week 13 Coding Assignment

all four possible outcomes.

Page 10 of 10