Jakarta EE（基于 JPA）在 IntelliJ IDEA 中开发简单留言板应用的实验指导

       摘要：Jakarta EE 并不仅限于使用 H2 数据库，它支持任何符合 JDBC 或 JPA 标准的数据库，例如 MySQL、PostgreSQL、Oracle 等。H2 通常用于开发测试或嵌入式场景，因为它轻量且易配置，但生产环境往往选择更健壮的数据库如 MySQL。同样，.NET 开发可以使用 MySQL（通过 MySQL Connector/NET），但它也支持 SQL Server、SQLite 等多种数据库，并不局限于 MySQL。

       下面我为你提供一个使用 Jakarta EE（基于 JPA）在 IntelliJ IDEA 中开发简单留言板应用的步-by-step 指南。这个应用会使用 H2 数据库（文件模式，以持久化数据），通过一个 JSP 表单提交留言，并使用 EntityManager 将内容写入 H2。假设你使用 IntelliJ IDEA Ultimate 版（Community 版不支持 Jakarta EE，需要 Ultimate），并已安装 JDK 17+ 和 Maven。

步骤 1: 创建 Jakarta EE 项目

1. 打开 IntelliJ IDEA，选择 File > New > Project。

2. 在 New Project 对话框中，选择 Jakarta EE。

3. 项目名称设为 MessageBoardApp，选择 Maven 作为构建工具，JDK 选 17 或更高。

4. 在 Version 字段选择 Jakarta EE 10 或 11，选择 Web application模板，并确保包括 Servlet 和 JPA规范（如果没有，稍后手动添加）。

5. 点击 Create。IntelliJ 会生成项目结构，包括 pom.xml和基本文件。

步骤 2: 添加依赖

打开 pom.xml，添加以下依赖（H2 驱动、Hibernate 作为 JPA 实现，如果你用 EclipseLink 可以替换）。使用 Alt+Insert（Windows）或 ⌘N（macOS）添加依赖，然后加载 Maven 变更。

<dependencies><!-- Jakarta EE API --><dependency><groupId>jakarta.platform</groupId><artifactId>jakarta.jakartaee-api</artifactId><version>10.0.0</version> <!-- 或 11.0.0，根据你的 Jakarta EE 版本 --><scope>provided</scope></dependency><!-- Hibernate JPA 实现 --><dependency><groupId>org.hibernate</groupId><artifactId>hibernate-core</artifactId><version>6.4.0.Final</version> <!-- 最新版本 --></dependency><!-- H2 数据库 --><dependency><groupId>com.h2database</groupId><artifactId>h2</artifactId><version>2.3.232</version> <!-- 最新版本 --></dependency>
</dependencies>

步骤 3: 配置持久化单元 (persistence.xml)

       在 src/main/resources/META-INF目录下创建 persistence.xml（如果不存在，右键 META-INF > New > XML Configuration File > persistence.xml）。

       使用以下配置（文件模式 H2，数据保存在项目根目录下的 `messageboard.db` 文件中；自动创建表）：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="3.0" xmlns="https://jakarta.ee/xml/ns/persistence"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd"><persistence-unit name="MessageBoardPU" transaction-type="RESOURCE_LOCAL"><provider>org.hibernate.jpa.HibernatePersistenceProvider</provider><class>com.example.entity.Message</class> <!-- 稍后创建的实体类 --><properties><property name="jakarta.persistence.jdbc.driver" value="org.h2.Driver"/><property name="jakarta.persistence.jdbc.url" value="jdbc:h2:./messageboard"/><property name="jakarta.persistence.jdbc.user" value="sa"/><property name="jakarta.persistence.jdbc.password" value=""/><property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/><property name="hibernate.hbm2ddl.auto" value="update"/> <!-- 自动更新 schema --><property name="hibernate.show_sql" value="true"/> <!-- 显示 SQL 日志，便于调试 --></properties></persistence-unit>
</persistence>

步骤 4: 创建留言实体类 (Message)

在 src/main/java下创建包com.example.entity，然后新建类Message.java：

package com.example.entity;import jakarta.persistence.*;
import java.time.LocalDateTime;@Entity
@Table(name = "messages")
public class Message {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;@Column(nullable = false)private String content;@Columnprivate LocalDateTime timestamp = LocalDateTime.now();// Getter 和 Setterpublic Long getId() {return id;}public void setId(Long id) {this.id = id;}public String getContent() {return content;}public void setContent(String content) {this.content = content;}public LocalDateTime getTimestamp() {return timestamp;}public void setTimestamp(LocalDateTime timestamp) {this.timestamp = timestamp;}
}

步骤 5: 创建 Servlet 处理留言提交

在 src/main/java下创建包com.example.servlet，新建类 MessageServlet.java：

package com.example.servlet;

package com.example.servlet;import com.example.entity.Message;
import jakarta.persistence.EntityManager;
import jakarta.persistence.EntityManagerFactory;
import jakarta.persistence.Persistence;
import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;import java.io.IOException;@WebServlet("/postMessage")
public class MessageServlet extends HttpServlet {private EntityManagerFactory emf;@Overridepublic void init() {emf = Persistence.createEntityManagerFactory("MessageBoardPU");}@Overrideprotected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {String content = req.getParameter("content");if (content != null && !content.isEmpty()) {EntityManager em = emf.createEntityManager();em.getTransaction().begin();Message message = new Message();message.setContent(content);em.persist(message);em.getTransaction().commit();em.close();}resp.sendRedirect("/index.jsp"); // 重定向回首页}@Overridepublic void destroy() {if (emf != null) {emf.close();}}
}

这个 Servlet 接收 POST 请求，将留言持久化到 H2。

步骤 6: 创建 JSP 表单修改 src/main/webapp/index.jsp：jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>留言板</title>
</head>
<body><h1>欢迎留言</h1><form action="/postMessage" method="post"><textarea name="content" placeholder="输入你的留言"></textarea><br><button type="submit">提交</button></form>
</body>
</html>

步骤 7: 配置并运行应用服务器按 Ctrl+Alt+S 打开 Settings，选择 Build, Execution, Deployment > Application Servers

添加 Tomcat（推荐简单 web app）或 GlassFish，指定安装路径。

在 Run Configurations 中添加 Tomcat/GlassFish Local 配置，部署你的 WAR artifact。

运行应用，访问 http://localhost:8080/（端口依服务器而定）。

提交留言后，数据会写入 H2 的 messageboard.db 文件。

步骤 8: 在 IntelliJ 中查看 H2 数据库打开 Database 工具窗口（View > Tool Windows > Database）

点击 + > Data Source > H2。

URL 设为 jdbc:h2:./messageboard（项目根目录），用户 sa，无密码。

测试连接，成功后可浏览表和数据。

       如果运行时遇到问题，如类未找到，确保 Maven 依赖已加载，并重启 IntelliJ。留言提交后，刷新数据库查看写入的内容。如果想添加读取留言功能，可以在 JSP 中使用 EntityManager 查询并显示列表。

8. IntelliJ IDEA（以下简称IDEA）中“没有JPA”怎么办？

        IntelliJ IDEA（以下简称IDEA）中“没有JPA”通常是因为： - 你使用的是Community版（免费版），它不支持Jakarta EE规范（如JPA、Servlet等）的内置模板和Facet（功能模块）。需要升级到Ultimate版（付费版）才能获得完整支持。 - 项目未正确配置Facet或依赖。 下面是添加JPA支持的步骤。根据你的情况选择方法。我假设你是用Maven构建的项目（如之前的留言板示例），并已安装JDK 17+。

方法1: 如果使用IDEA Ultimate版（推荐，内置支持）

1. 检查/升级IDEA版本： - 打开IDEA，点击 **Help > About** 查看版本。如果是Community版，下载Ultimate版（试用30天免费）从官网：https://www.jetbrains.com/idea/download/。

- Ultimate版支持Jakarta EE，包括JPA的代码补全、实体生成、数据库集成等。

2. 在现有项目中添加JPA Facet：

- 右键项目根目录 > Open Module Settings（或按 F4）。

- 在左侧选择 Facets。

- 点击 + > 选择 JPA。

- 在JPA Facet配置中，选择Hibernate作为默认实现（或EclipseLink），并指向你的persistence.xml文件（位于src/main/resources/META-INF）。

- 点击 Apply > OK。

- IDEA会自动下载所需插件/依赖，并启用JPA功能（如实体类注解高亮、JPQL查询支持）。

3. 如果项目是从头创建： - 如之前所述，选择 New > Project > Jakarta EE时，确保勾选 JPA规范。IDEA会自动生成Facet和基本配置。

方法2: 如果使用IDEA Community版（手动添加依赖，无Facet支持） Community版不支持Facet，但你可以通过Maven手动添加JPA依赖，代码仍能运行（只是缺少一些IDE增强功能，如自动代码生成）。

1. 添加Maven依赖：

- 打开pom.xml，添加以下（如果已添加，可跳过）：

<dependencies><!-- Jakarta EE API (包括JPA) --><dependency><groupId>jakarta.platform</groupId><artifactId>jakarta.jakartaee-api</artifactId><version>10.0.0</version> <!-- 或11.0.0 --><scope>provided</scope></dependency><!-- JPA实现 (如Hibernate) --><dependency><groupId>org.hibernate</groupId><artifactId>hibernate-core</artifactId><version>6.4.0.Final</version> <!-- 检查最新版本 --></dependency>
</dependencies>

- 右键pom.xml > Maven > Reload Project以加载依赖。

- IDEA会下载jar包，你可以使用JPA注解（如@Entity、@Id）编写代码，但不会有时自动补全或验证。

2. 手动配置persistence.xml：

- 如之前响应所述，在`src/main/resources/META-INF创建persistence.xml，配置H2连接。

3. 启用插件（可选增强）：

- 打开 File > Settings > Plugins，搜索并安装“Database Tools and SQL”（Community版可用），以支持数据库浏览（如H2查看）。

- 对于JPA代码补全，Community版有限制，但基本注解会工作。

测试JPA是否添加成功

- 在实体类（如Message.java）中添加`@Entity`注解，如果无报错且有高亮，则成功。

- 运行应用，提交留言，检查H2数据库是否写入数据（用Database工具窗口连接jdbc:h2:./messageboard）。

- 如果遇到“ClassNotFoundException”或依赖问题，重启IDEA或运行mvn clean install。

       如果你的IDE是其他（如Eclipse），或具体错误截图，请提供更多细节。如果是拼写错误或其他含义，再解释一下。