First steps and detailed concepts Java Persistence api

import
java.util.List;
import
javax.persistence.*;
@Entity
@Table
(name = 
"TB_PERSON_02837"
)
9 of 60

---

JPA Mini Book
www.javacodegeeks.com
public
class
Person {
@Id
@GeneratedValue
(strategy = GenerationType.AUTO)
private
int
id;
@Basic
(fetch = FetchType.LAZY)
@Column
(name = 
"PERSON_NAME"
, length = 
100
, unique = 
true
, nullable = 
false
)
private
String name;
@OneToMany
private
List cars;
public
String getName() {
return
name;
}
public
void
setName(String name) {
this
.name = name;
}
}
In the code snippet above the following annotations are shown: @Entity, @Id and @OneToMany (we will see about 
this annotation later); these are considered logical annotations. Notice that these annotations do not define 
anything related to database, but define how a Java class will behave as an Entity.
Additionally in the code above we demonstrate another set of annotations: @Table, @Column and @Basic. These 
annotations will create the relationship between the database table and the entity. It is possible to define the table 
name, column name and other information regarding the database. This kind of annotations are known as Physical 
annotations, it is their job to “connect” the database to the JPA code.
Its out of the scope of this mini book to present every annotation supported by JPA, but it is very easy to find this 
information on the internet; e.g.: 
@Column(name = “PERSON_NAME”, length = 100, unique = true, nullable = false)
. 
The physical annotations are the easier to understand because it looks like database configuration.
Id Generation: Definition, using Identity or Sequence
As said in previous chapters, every entity must have an id. JPA has the option to automatically generate the entity 
id.
There are three options for automatic id generation:
•
Identity
•
Sequence
•
TableGenerator
10 of 60

---

JPA Mini Book
www.javacodegeeks.com
We must have in mind that every database has its own id generation mechanism. Oracle and Postgres databases 
use the Sequence approach, SqlServer and MySQL use the Identity approach. It is not possible to use an id 
generation approach in a server when the server does not support it.
The following Java types are allowed to be used for an id attribute: byte/Byte, int/Integer, short/Short, long/Long, 
char/Character, String, BigInteger, java.util.Date and java.sql.Date.
Identity
This is the simplest id generation approach. Just annotate the id field like below: