Глава 5. Основы O/R отображения

1. 5.1. Объявление отображения
   1. 5.1.1. Сущность
   2. 5.1.2. Идентификаторы
   3. 5.1.3. Свойства оптимистической блокировки (необязательно)
   4. 5.1.4. Свойство
   5. 5.1.5. Встроенные объекты (они же компоненты)
   6. 5.1.6. Стратегия наследования
   7. 5.1.7. Отображение ассоциаций один-к-одному и многие-к-одному
   8. 5.1.8. Естественный идентификатор (Natural-id)
   9. 5.1.9. Any
   10. 5.1.10. Свойства
   11. 5.1.11. Некоторые особенности hbm.xml
2. 5.2. Типы Hibernate
   1. 5.2.1. Сущности и значения
   2. 5.2.2. Основные типы значений
   3. 5.2.3. Пользовательские типы значений
3. 5.3. Отображение класса более одного раза
4. 5.4. Идентификаторы, цитируемые SQL
5. 5.5. Сгенерированные свойства
6. 5.6. Преобразователи столбцов: выражения для чтения и записи
7. 5.7. Вспомогательные объекты базы данных

5.1. Объявление отображения

Объектно-реляционные отображения могут быть определены тремя способами:

• используя аннотации Java 5 (через Java Persistence 2 annotations)
• используя дескрипторы развертывания JPA 2 XML (описанные в главе XXX)
• используя подход "Hibernate унаследованные XML-файлы", известные как hbm.xml

Аннотации разделены на две категории: аннотации логического отображения (описание объектной модели, связь между двумя объектами и т. д.) и аннотации физического отображения (описывающие физическую схему, таблицы, столбцы, индексы и т. д.). Мы будем смешивать аннотации из обеих категорий в следующих примерах кода.

Аннотации JPA находятся в пакете javax.persistence.*. Специальные расширения для Hibernate находятся в org.hibernate.annotations.*. Ваша любимая IDE может автоматически заполнять аннотации и их атрибуты (даже без специального плагина «JPA», поскольку аннотации JPA — это простые аннотации Java 5).

Вот пример отображения:

package eg;

@Entity 
@Table(name="cats") @Inheritance(strategy=SINGLE_TABLE)
@DiscriminatorValue("C") @DiscriminatorColumn(name="subclass", discriminatorType=CHAR)
public class Cat {
   @Id @GeneratedValue
   public Integer getId() { return id; }
   public void setId(Integer id) { this.id = id; }
   private Integer id;

   public BigDecimal getWeight() { return weight; }
   public void setWeight(BigDecimal weight) { this.weight = weight; }
   private BigDecimal weight;

   @Temporal(DATE) @NotNull @Column(updatable=false)
   public Date getBirthdate() { return birthdate; }
   public void setBirthdate(Date birthdate) { this.birthdate = birthdate; }
   private Date birthdate;

   @org.hibernate.annotations.Type(type="eg.types.ColorUserType")
   @NotNull @Column(updatable=false)
   public ColorType getColor() { return color; }
   public void setColor(ColorType color) { this.color = color; }
   private ColorType color;

   @NotNull @Column(updatable=false)
   public String getSex() { return sex; }
   public void setSex(String sex) { this.sex = sex; }
   private String sex;

   @NotNull @Column(updatable=false)
   public Integer getLitterId() { return litterId; }
   public void setLitterId(Integer litterId) { this.litterId = litterId; }
   private Integer litterId;

   @ManyToOne @JoinColumn(name="mother_id", updatable=false)
   public Cat getMother() { return mother; }
   public void setMother(Cat mother) { this.mother = mother; }
   private Cat mother;

   @OneToMany(mappedBy="mother") @OrderBy("litterId")
   public Set<Cat> getKittens() { return kittens; }
   public void setKittens(Set<Cat> kittens) { this.kittens = kittens; }
   private Set<Cat> kittens = new HashSet<Cat>();
}

@Entity @DiscriminatorValue("D")
public class DomesticCat extends Cat {

   public String getName() { return name; }
   public void setName(String name) { this.name = name }
   private String name;
}

@Entity
public class Dog { ... }

В подходе "Hibernate унаследованные XML-файлы" используется XML-схема, предназначенная для чтения и редактирования вручную. Язык отображения является Java-ориентированным, что означает, что отображения построены вокруг деклараций постоянных классов, а не деклараций таблиц.

Обратите внимание: несмотря на то, что многие пользователи Hibernate предпочитают писать XML вручную, существует ряд инструментов для создания отображения. К ним относятся XDoclet, Middlegen и AndroMDA.

Вот пример отображения:

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
      "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
          "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="eg">
    <class name="Cat"
        table="cats"
        discriminator-value="C">

        <id name="id">
            <generator class="native"/>
        </id>

        <discriminator 
            column="subclass"
            type="character"/>

        <property name="weight"/>

        <property name="birthdate"
            type="date"
            not-null="true"
            update="false"/>

        <property name="color"
            type="eg.types.ColorUserType"
            not-null="true"
            update="false"/>

        <property name="sex"
            not-null="true"
            update="false"/>

        <property name="litterId"
            column="litterId"
            update="false"/>

        <many-to-one name="mother"
            column="mother_id"
            update="false"/>

        <set name="kittens"
            inverse="true"
            order-by="litter_id">
                <key column="mother_id"/>
                <one-to-many class="Cat"/>
        </set>

        <subclass name="DomesticCat"
            discriminator-value="D">

                <property name="name"
                    type="string"/>
        </subclass>
    </class>

    <class name="Dog">
        <!-- отображение для Dog может быть здесь -->
    </class>
</hibernate-mapping>