S01L07 – 设置 Hibernate 实体类

html

目录

介绍
理解 Hibernate Entity Classes
设置 Entity Class

命名规范
定义类属性


在 Hibernate 中使用注解

Entity 注解
Table 注解
Id 和 Column 注解


生成 Getters, Setters 和 Constructors
完整的 Entity Class 示例
结论
附加资源


介绍
在基于 Java 的应用程序领域，像 Hibernate 这样的对象关系映射（ORM）框架在连接面向对象编程和关系数据库之间扮演着关键角色。 Hibernate 功能的核心概念是 Entity Classes。这些类对于将 Java 对象映射到数据库表至关重要，确保数据操作和检索的无缝进行。
本电子书深入探讨了设置 Hibernate Entity Class 的复杂细节。无论你是初学者刚开始接触 Hibernate，还是开发人员希望提升你的 ORM 技能，本指南都提供了全面的概述、逐步说明和最佳实践，助你掌握 Entity Class 的创建。

理解 Hibernate Entity Classes
Hibernate 通过允许开发人员使用 Java 对象而不是编写复杂的 SQL 查询，简化了数据库交互。这种抽象的核心是 Entity Classes，它们作为数据库表的蓝图。每个 Entity Class 对应数据库中的一个表，该类的每个实例代表该表中的一行。
关键点：

ORM 框架：Hibernate 管理 Java 对象和数据库表之间的转换。
Entity Class：一个被注解的 Java 类，用于表示数据库中的表。
主键：每个实体必须有一个主键，以唯一标识记录。


设置 Entity Class
创建 Hibernate Entity Class 涉及多个关键步骤，从命名规范到定义属性。让我们详细探讨每个组件。
命名规范
遵循一致的命名规范确保清晰并减少混淆。通常：

类名：以大写字母开头，并遵循 CamelCase 格式（例如 Users）。
属性名：使用小写字母，必要时单词之间用下划线分隔（例如 user_id）。

示例：




		
		
			
			
Java
			
			
public class Users {
    // 类主体
}

			
				
					
				
					1
2
3
4
5
				
						 
public class Users {
    // 类主体
}
 
					
				
			
		


定义类属性
实体类中的每个属性对应数据库表中的一列。准确匹配数据类型和名称至关重要。

数据类型：确保 Java 数据类型与 SQL 数据类型匹配（例如 int 用于数字 ID，String 用于文本数据）。
属性名：应反映数据库列的名称，可能使用下划线以增强可读性。

示例：




		
		
			
			
Java
			
			
private int user_id;
private String username;
private String password;
private String first_name;
private String last_name;

			
				
					
				
					1
2
3
4
5
6
7
				
						 
private int user_id;
private String username;
private String password;
private String first_name;
private String last_name;
 
					
				
			
		



在 Hibernate 中使用注解
注解是 Java 为类、方法和变量添加元数据的方式。在 Hibernate 中，注解在定义 Java 类如何映射到数据库表方面起着关键作用。
Entity 注解
@Entity 注解标记一个类为 Hibernate 实体。它表示该类被映射到数据库表。
语法：




		
		
			
			
Java
			
			
import javax.persistence.Entity;

@Entity(name = "users")
public class Users {
    // 类主体
}

			
				
					
				
					1
2
3
4
5
6
7
8
				
						 
import javax.persistence.Entity;
 
@Entity(name = "users")
public class Users {
    // 类主体
}
 
					
				
			
		



name 属性：指定实体名称，便于日志记录和查询。

Table 注解
@Table 注解提供有关实体映射到的数据库表的附加信息，例如表名。
语法：




		
		
			
			
Java
			
			
import javax.persistence.Table;

@Entity(name = "users")
@Table(name = "users")
public class Users {
    // 类主体
}

			
				
					
				
					1
2
3
4
5
6
7
8
9
				
						 
import javax.persistence.Table;
 
@Entity(name = "users")
@Table(name = "users")
public class Users {
    // 类主体
}
 
					
				
			
		



name 属性：指定数据库中确切的表名，确保清晰，特别是当类名和表名不同时。

Id 和 Column 注解
@Id 注解标示实体的主键，而 @Column 注解指定列的详细信息。
语法：




		
		
			
			
Java
			
			
import javax.persistence.Id;
import javax.persistence.Column;

@Id
@Column(name = "user_id")
private int user_id;

@Column(name = "username")
private String username;

// 其他属性类似

			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
				
						 
import javax.persistence.Id;
import javax.persistence.Column;
 
@Id
@Column(name = "user_id")
private int user_id;
 
@Column(name = "username")
private String username;
 
// 其他属性类似
 
					
				
			
		



@Id：标记主键。
@Column：将类属性映射到数据库表中的特定列。
命名差异：即使属性名与列名不同（例如 firstName vs. first_name），@Column 注解也确保准确映射。


生成 Getters, Setters 和 Constructors
为了便于数据操作，实体类应为每个属性生成 getter 和 setter 方法。此外，构造函数使得可以创建具有特定属性值的对象实例。
Getters 和 Setters
这些方法允许对私有类属性进行受控访问和修改。
示例：




		
		
			
			
Java
			
			
public int getUser_id() {
    return user_id;
}

public void setUser_id(int user_id) {
    this.user_id = user_id;
}

// 其他属性类似

			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
				
						 
public int getUser_id() {
    return user_id;
}
 
public void setUser_id(int user_id) {
    this.user_id = user_id;
}
 
// 其他属性类似
 
					
				
			
		


Constructors
构造函数初始化实体类的新实例。通常生成一个无参数的构造函数和一个排除自动生成的主键的参数化构造函数。
示例：




		
		
			
			
Java
			
			
public Users() {
    // 无参数构造函数
}

public Users(String username, String password, String first_name, String last_name) {
    this.username = username;
    this.password = password;
    this.first_name = first_name;
    this.last_name = last_name;
}

			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
				
						 
public Users() {
    // 无参数构造函数
}
 
public Users(String username, String password, String first_name, String last_name) {
    this.username = username;
    this.password = password;
    this.first_name = first_name;
    this.last_name = last_name;
}
 
					
				
			
		



完整的 Entity Class 示例
将所有讨论的组件整合在一起，基于提供的转录内容，以下是完整的 Hibernate Entity Class 示例。




		
		
			
			
Java
			
			
package org.studyeasy.entity;

import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.Id;
import javax.persistence.Column;

@Entity(name = "users")
@Table(name = "users")
public class Users {

    @Id
    @Column(name = "user_id")
    private int user_id;

    @Column(name = "username")
    private String username;

    @Column(name = "password")
    private String password;

    @Column(name = "first_name")
    private String first_name;

    @Column(name = "last_name")
    private String last_name;

    // 无参数构造函数
    public Users() {
    }

    // 排除 user_id 的参数化构造函数
    public Users(String username, String password, String first_name, String last_name) {
        this.username = username;
        this.password = password;
        this.first_name = first_name;
        this.last_name = last_name;
    }

    // Getter 和 Setter 方法
    public int getUser_id() {
        return user_id;
    }

    public void setUser_id(int user_id) {
        this.user_id = user_id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    public String getFirst_name() {
        return first_name;
    }

    public void setFirst_name(String first_name) {
        this.first_name = first_name;
    }

    public String getLast_name() {
        return last_name;
    }

    public void setLast_name(String last_name) {
        this.last_name = last_name;
    }
}

			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
				
						 
package org.studyeasy.entity;
 
import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.Id;
import javax.persistence.Column;
 
@Entity(name = "users")
@Table(name = "users")
public class Users {
 
    @Id
    @Column(name = "user_id")
    private int user_id;
 
    @Column(name = "username")
    private String username;
 
    @Column(name = "password")
    private String password;
 
    @Column(name = "first_name")
    private String first_name;
 
    @Column(name = "last_name")
    private String last_name;
 
    // 无参数构造函数
    public Users() {
    }
 
    // 排除 user_id 的参数化构造函数
    public Users(String username, String password, String first_name, String last_name) {
        this.username = username;
        this.password = password;
        this.first_name = first_name;
        this.last_name = last_name;
    }
 
    // Getter 和 Setter 方法
    public int getUser_id() {
        return user_id;
    }
 
    public void setUser_id(int user_id) {
        this.user_id = user_id;
    }
 
    public String getUsername() {
        return username;
    }
 
    public void setUsername(String username) {
        this.username = username;
    }
 
    public String getPassword() {
        return password;
    }
 
    public void setPassword(String password) {
        this.password = password;
    }
 
    public String getFirst_name() {
        return first_name;
    }
 
    public void setFirst_name(String first_name) {
        this.first_name = first_name;
    }
 
    public String getLast_name() {
        return last_name;
    }
 
    public void setLast_name(String last_name) {
        this.last_name = last_name;
    }
}
 
					
				
			
		


代码解释

包声明:

    



		
		
			
			
Java
			
			
package org.studyeasy.entity;
    
			
				
					
				
					1
2
3
				
						 
package org.studyeasy.entity;
    
					
				
			
		



    定义 Users 类的命名空间。
  
导入:

    



		
		
			
			
Java
			
			
import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.Id;
import javax.persistence.Column;
    
			
				
					
				
					1
2
3
4
5
6
				
						 
import javax.persistence.Entity;
import javax.persistence.Table;
import javax.persistence.Id;
import javax.persistence.Column;
    
					
				
			
		



    导入 Java 持久化 API（JPA）所需的注解。
  
Entity 和 Table 注解:

    



		
		
			
			
Java
			
			
@Entity(name = "users")
@Table(name = "users")
    
			
				
					
				
					1
2
3
4
				
						 
@Entity(name = "users")
@Table(name = "users")
    
					
				
			
		



@Entity：用名称 "users" 标记类作为 Hibernate 实体。
@Table：指定实体映射到数据库表名 "users"。


类定义:

    



		
		
			
			
Java
			
			
public class Users {
    // 类属性和方法
}
    
			
				
					
				
					1
2
3
4
5
				
						 
public class Users {
    // 类属性和方法
}
    
					
				
			
		



    定义 Users 类，代表数据库中的 "users" 表。
  
带有注解的属性定义:

    



		
		
			
			
Java
			
			
@Id
@Column(name = "user_id")
private int user_id;

@Column(name = "username")
private String username;

@Column(name = "password")
private String password;

@Column(name = "first_name")
private String first_name;

@Column(name = "last_name")
private String last_name;
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
				
						 
@Id
@Column(name = "user_id")
private int user_id;
 
@Column(name = "username")
private String username;
 
@Column(name = "password")
private String password;
 
@Column(name = "first_name")
private String first_name;
 
@Column(name = "last_name")
private String last_name;
    
					
				
			
		



每个属性对应 "users" 表中的一列。
@Id：标记 user_id 为主键。
@Column：将属性映射到表中的特定列名。
命名差异：即使属性名与列名不同（例如 firstName vs. first_name），@Column 注解也确保准确映射。


构造函数:

    



		
		
			
			
Java
			
			
public Users() {
}

public Users(String username, String password, String first_name, String last_name) {
    this.username = username;
    this.password = password;
    this.first_name = first_name;
    this.last_name = last_name;
}
    
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
				
						 
public Users() {
}
 
public Users(String username, String password, String first_name, String last_name) {
    this.username = username;
    this.password = password;
    this.first_name = first_name;
    this.last_name = last_name;
}
    
					
				
			
		



    提供一个无参数的构造函数和一个排除自动生成的 user_id 的参数化构造函数。
  
Getters 和 Setters:

    



		
		
			
			
Java
			
			
public int getUser_id() { return user_id; }
public void setUser_id(int user_id) { this.user_id = user_id; }
// 其他属性类似
    
			
				
					
				
					1
2
3
4
5
				
						 
public int getUser_id() { return user_id; }
public void setUser_id(int user_id) { this.user_id = user_id; }
// 其他属性类似
    
					
				
			
		



    允许受控访问类属性。
  


结论
创建结构良好的 Hibernate Entity Class 是在 Java 应用程序中实现有效 ORM 的基础。通过遵循命名规范、使用注解并确保属性映射的准确性，开发人员可以无缝地将 Java 对象与关系数据库集成。本电子书概述了设置实体类的基本步骤和最佳实践，为进一步探索和掌握 Hibernate 提供了坚实的基础。
本文为 AI 生成。