【Hibernate与MyBatis注解案例】：Java注解与ORM框架的无缝结合

# 1. Java注解和ORM框架基础

## 1.1 什么是注解
注解是Java语言中的一个特性，用于提供代码信息给编译器或其他工具。它类似于C/C++中的宏，但更加强大和类型安全。注解不会直接影响代码的逻辑，但可以通过反射技术在运行时读取。Java注解常见的应用包括元数据定义、依赖注入等。

## 1.2 ORM框架简介
对象关系映射（Object-Relational Mapping，ORM）框架的主要目的是简化Java对象与数据库表之间的映射。ORM框架隐藏了数据库操作的复杂性，使得开发者能够使用面向对象的方式操作关系数据库。Java中流行的ORM框架有Hibernate、MyBatis等。

## 1.3 注解在ORM中的作用
在ORM框架中，注解用来声明类与数据库表之间的映射关系，以及字段与列之间的映射。它减少了XML配置文件的使用，让代码更加清晰，并且易于维护。例如，Hibernate中使用@Entity来标记实体类，@Id来指定主键字段。

@Entity
public class User {
    @Id
    private Long id;
    private String name;
    // getter和setter方法
}

注解的使用简化了实体映射的过程，使开发者可以专注于业务逻辑的实现，而无需深入了解底层的SQL操作。接下来的章节中，我们将深入了解Hibernate和MyBatis框架中注解的具体用法和高级特性。

# 2. Hibernate注解使用详解

### 2.1 基本映射注解

#### 2.1.1 @Entity和@Table的使用

在Hibernate中，`@Entity`注解用于指示一个类是一个实体，并映射到一个数据库表。这个注解是创建实体类时必须使用的。而`@Table`注解则用来定义实体类映射到具体哪个数据库表，可以指定表的名字以及其它表级约束。

使用`@Entity`和`@Table`注解来声明实体和映射表，代码示例如下：

import javax.persistence.Entity;
import javax.persistence.Table;

@Entity
@Table(name = "users")
public class User {
    // 实体类的字段和映射细节
}

上述代码中，`User`类被声明为一个实体类，并映射到数据库中的`users`表。使用`@Table`注解可以自定义表名，如果省略该注解，则默认使用类名作为表名。

#### 2.1.2 @Column和@Id注解的应用

`@Column`注解用于映射实体类的属性到数据库表的列，可以指定列的名称、长度、是否唯一等特性。而`@Id`注解标识某个字段作为实体的唯一标识，相当于数据库表中的主键。

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

@Entity
@Table(name = "users")
public class User {
    @Id
    @Column(name = "user_id")
    private Long id;

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

    // 其他属性和方法
}

在上面的代码中，`id`字段被标识为`@Id`注解，表示这是主键。`@Column`注解则用来指定数据库中的列名，这里`user_id`和`user_name`分别映射到了`id`和`name`字段。

### 2.2 关系映射注解

#### 2.2.1 @OneToOne, @OneToMany注解

在Hibernate中，关系映射通过特定的注解来实现，比如`@OneToOne`用于一对一关系，`@OneToMany`用于一对多关系。

`@OneToOne`示例：

import javax.persistence.*;

@Entity
public class Passport {
    @Id
    private Long id;

    @OneToOne(mappedBy = "passport")
    private User user;
    // 其他属性和方法
}

在上面的例子中，`Passport`类和`User`类之间存在一对一的关系，`User`类中的`passport`字段与`Passport`类中的`user`字段相互映射。

`@OneToMany`示例：

import javax.persistence.*;
import java.util.List;

@Entity
public class User {
    @Id
    private Long id;

    @OneToMany(cascade = CascadeType.ALL, orphanRemoval = true)
    private List<Order> orders;
    // 其他属性和方法
}

在这里，一个用户（`User`）可以拥有多个订单（`Order`）。`CascadeType.ALL`表示所有相关的持久化操作都会级联到关联的订单上，而`orphanRemoval`设置为`true`表示当订单列表中移除某个订单时，该订单实例将会被从数据库中删除。

#### 2.2.2 @ManyToMany和@JoinTable的关联

`@ManyToMany`注解用于映射多对多的关系。当两个实体类之间存在多对多关系时，可以使用`@ManyToMany`，并且经常配合`@JoinTable`注解来定义中间表。

import javax.persistence.*;
import java.util.List;

@Entity
public class Course {
    @Id
    private Long id;

    @ManyToMany
    @JoinTable(name = "course_student",
        joinColumns = @JoinColumn(name = "course_id"),
        inverseJoinColumns = @JoinColumn(name = "student_id"))
    private List<Student> students;
    // 其他属性和方法
}

在上述代码中，`Course`实体和`Student`实体通过一个中间表`course_student`关联起来。`joinColumns`指定了中间表中代表`Course`实体的列，而`inverseJoinColumns`指定了代表`Student`实体的列。

### 2.3 高级注解特性

#### 2.3.1 @SecondaryTable多表映射

在某些情况下，实体的信息需要存储在多个表中。`@SecondaryTable`注解允许将一个实体类映射到多个表中。

import javax.persistence.*;

@Entity
@SecondaryTable(name = "user_details")
public class User {
    @Id
    private Long id;

    @Column(table = "user_details")
    private String address;
    // 其他属性和方法
}

在上面的类定义中，`User`实体除了映射到主表`users`外，还映射到了`user_details`这个表，并从该表中读取`address`字段。

#### 2.3.2 @Formula注解的自定义查询

`@Formula`注解允许我们在实体类中直接嵌入SQL片段，用于实现复杂的数据库查询逻辑，这些逻辑将直接插入到生成的SQL查询中。

import javax.persistence.*;

@Entity
public class Employee {
    @Id
    private Long id;
    @Formula("(SELECT avg(salary) FROM employees e2 WHERE e2.department_id = department_id)")
    private Double averageDepartmentSalary;
    // 其他属性和