Day 3: 1140112一、目标:观摩如何依照MVC架构，建立后端Java档案二、预计使用工具:VS code

三、档案架构:今天要建立的是后端档案，也就是Day 2 内文提到src/main/java的资料夹，今天谈到的两份档案Product.java和ProductController.java分别对应到M和C，架构如下图

四、放主类别/启动(Spring Boot)类别的档案: RestaurantMenuApplication.java

在 Java 中，package 是用来组织和管理类别 (classes) 和介面 (interfaces) 的结构化方式。在第一行，我们先为package命名。值得注意的是，取名的方式最好是遵循资料夹层级的档名(可参考上图)来编排。

接着，引入(import)启动 Spring Boot 应用程式的套件。

package com.restuarant.menu;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

再来，因为本程式使用spring boot 框架，所以下一个 @SpringBootApplication 注解，这个注解包含以下三个重要功能：1.@Configuration：允许定义 bean 并将其注册到 Spring 应用程式上下文中。2.@EnableAutoConfiguration：自动配置 Spring Boot 的预设设定。3.@ComponentScan：自动扫描 com.restaurant.menu package 下的 Spring 组件（如 @Controller, @Service）。

完成基本设定后，就来写主类别的内容了!SpringApplication.run(...) 用来启动 Spring Boot 应用程式。它会加载 Spring 上下文，启动内建的 Tomcat 伺服器（预设埠是 8080）和所有注册的 Spring 套件。

@SpringBootApplication

public class RestaurantMenuApplication {

public static void main(String[] args) {
SpringApplication.run(RestaurantMenuApplication.class, args);

}
}

当按下VSCode中，程式码上方的Run main，就会启动Tomcat 伺服器了，此时如果在浏览器输入http://localhost:8080/会看到Day 2 的Whitelabel Error Page，表示有建立成功。

五、放产品类别的档案: Product.java在第一行，我们一样先为package命名。接着我们为产品创设「类」(class)，并定义他的属性，像是id、名称、价格等，还有他的资料型态，如id是整数(int)。接着，会建立对应的建构子(constructor)和 getter、setter 方法。

1.建构子是用来创建新的 Product 对象，并初始化属性。2.所谓的getter、setter 方法，从程式设计的角度来看，是让原本外部人无法任意修改的属性如private int id;，得以透过公开的方法来取得或写入资讯，如此能确保封装性（Encapsulation），也能更好地控制对属性的访问。

package com.restuarant.menu.model;

public class Product {
private int id;
private String name;
private double price;

//构造函数(Constructor)
public Product(int id, String name, double price) {
this.id = id;
this.name = name;
this.price = price;
}

//getter 是 Java Bean 标準的一部分，用来取得资讯，因为它会返回属性的值
public int getId() {
return id;
}

//setter 是 Java Bean 标準的一部分，用来写入资讯，也就是说，可以透过他设置属性的值
public void setId(int id) {
this.id = id;

......(name和price的部分以此类推)
}
}

六、处理与产品相关的网页请求: ProductController.java在第一行，我们一样先为package命名，并完成基本设定。在此档案中，因为会用到Product.java中的Product类别，所以，需要引用该套件。

package com.restuarant.menu.controller;
//为了后续用List
import java.util.List;
//为了后续用@Controller
import org.springframework.stereotype.Controller;
//为了后续用Model
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

//引用product.java里面的product class
import com.restuarant.menu.model.Product;

接着，是主要内容的部分，以下内容都可以根据网页功能调整!

(一)建立模拟的产品列表（productsList）@Controller 是 Spring 控制器类，处理与网页相关的 HTTP 请求。@RequestMapping("/products") 意味着所有与 /products 相关的 URL 都会由这个控制器处理。这意味着在 ProductController 中定义的方法，处理的 URL 都会以 /products 为前缀。

之所以称为「模拟的产品列表」，是因为它是硬编码在 ProductController 类别的静态资料集合（List）中。这意味着在这个控制器中，productsList 只是临时用来模拟资料库或外部资料源的资料，并且仅在应用启动时存在，并不会从资料库或其他来源读取真实资料。

如果想从外部资料源（如资料库）获取资料，可以将把这段替换为资料库查询的程式码。

@Controller
@RequestMapping("/products") // This means all URLs start with http://localhost:8080/products/
public class ProductController {
//引用product.java里面的product class
private List<Product> productsList = List.of(
new Product(1, "Rice", 1.00),
new Product(2, "Dumpling", 3.50),
new Product(3, "Soup", 2.00),
);

(二)设定根路由(通常是首页)访问的内容 (/products/)@RequestMapping("/") 将根路由 (/products/) 的请求映射到这个方法。@ResponseBody表示返回的内容会直接显示在浏览器中。也就是说，使用者在画面上会直接看到 "Welcome to the Coffee Shop!"。

@RequestMapping("/") // This maps to the URL http://localhost:8080/products/
@ResponseBody
public String home() {
return "Welcome to the Coffee Shop!";
}

(三)设定显示产品列表方法 (/products/list)@RequestMapping("/list") 将 /products/list 的请求映射到这个方法。这个方法使用 Model 参数来传递资料给视图(V，View)。在这里，将 productsList 添加到模型中，并指定将资料发送到名为 menu 的视图。return "menu"; 会返回视图名称 menu，Spring MVC 会根据视图解析器来处理这个名称，通常会寻找名为 menu.html 或 menu.jsp 的文件。

@RequestMapping("/list") // This maps to the URL http://localhost:8080/products/list
public String listProducts(Model productListModel) { // Model argument is used to pass data to the view
productListModel.addAttribute("products", productsList); // Add the productsList to the model
return "menu"; // This returns the view name, that is, the HTML file name
}

(四)设定特定产品资讯 (/products/details/{id})@RequestMapping("/details/{id}") 将 /products/details/{id} 的请求映射到这个方法。{id} 是 URL 路径中的一个变数，会对应到 @PathVariable 的 id 参数。@PathVariable 从 URL 中提取 id 的值。在遍历 productsList 以后，根据传入的 id 查找对应的产品，并返回一个包含产品详情的 HTML 字串。若未找到该产品，则返回 "Product not found!"。

@RequestMapping("/details/{id}") // This maps to the URL http://localhost:8080/products/details/{id}
@ResponseBody
public String getProductDetailsByID(@PathVariable int id){
for (Product product : productsList) {
if (product.getId() == id) {
return "<strong>Requested Product Details: </strong> <hr> Product ID: " + product.getId() + "<br> Name: " + product.getName() + "<br> Price: $" + product.getPrice();
}
}
return "Product not found!";
}
}

七、补充小知识:(一)requestMapping 是适用于所有 HTTP 请求的注解，与他相关的有以下几种:

(二)Java 中的 ListJava 中的 List 是 mutable（可变的），不过，Java 中也有 immutable list 的概念。比如使用 List.of() 创建的 List 是不可变的。