Hibernate Tutorial

Why Object Relational Mapping (ORM)? When we work with an object-oriented systems, there's a mismatch between the object model and the relational database. RDBMSs represent data in a tabular format whereas objectoriented languages, such as Java or C# represent it as an interconnected graph of objects. Consider the following Java Class with proper constructors and associated public function:

package myApp; public class GuestBook { private Integer visitorNo; private String visitorName; private String message; private String messageDate; public GuestBook() { } public GuestBook(String visitorName, String message, String messageDate) {

this.visitorName=visitorName; this.message=message; this.messageDate=messageDate; }

public Integer getVisitorNo() { return visitorNo; }

public void setVisitorNo(Integer visitorNo) { this.visitorNo = visitorNo; }

public String getVisitorName() { return visitorName; }

public void setVisitorName(String visitorName) {

this.visitorName = visitorName; }

public String getMessage() { return message; }

public void setMessage(String message) { this.message = message; }

public String getMessageDate() { return messageDate; }

public void setMessageDate(String messageDate) { this.messageDate = messageDate; }

} Consider above objects need to be stored and retrieved into the following RDBMS table: CREATE

TABLE

GuestBook(VisitorNo

INT

Primary

Key

AUTO_INCREMENT, VisitorName varchar(50), Message varchar(100), MessageDate varchar(40)); First problem, what if we need to modify the design of our database after having developed few pages or our application? Second, Loading and storing objects in a relational database exposes us to the following five mismatch problems. Mismatch

Description

Granularity

Sometimes you will have an object model which has more classes than the number of corresponding tables in the database.

Inheritance

RDBMSs do not define anything similar to Inheritance which is a natural paradigm in object-oriented programming languages.

Identity

A RDBMS defines exactly one notion of 'sameness':

the primary key. Java, however, defines both object identity (a==b) and object equality (a.equals(b)).

Associations

Object-oriented languages represent associations using object references where as am RDBMS represents an association as a foreign key column.

Navigation

The ways you access objects in Java and in a RDBMS are fundamentally different.

The Object-Relational Mapping (ORM) is the solution to handle all the above impedance mismatches. What is ORM? ORM

stands

for Object-Relational Mapping

(ORM)

is

a

programming technique for converting data between relational databases and object oriented programming languages such as Java, C# etc. An ORM system has following advantages over plain JDBC S.N .

Advantages

1

Lets business code access objects rather than DB tables.

2

Hides details of SQL queries from OO logic.

3

Based on JDBC 'under the hood'

4

No need to deal with the database implementation.

5

Entities based on business concepts rather than database structure.

6

Transaction management and automatic key generation.

7

Fast development of application.

An ORM solution consists of the following four entities: S.N .

Solutions

1

An API to perform basic CRUD operations on objects of persistent classes.

2

A language or API to specify queries that refer to classes and properties of classes.

3

A configurable facility for specifying mapping metadata.

4

A technique to interact with transactional objects to perform dirty checking, lazy association fetching, and other

optimization functions.

Hibernate is an Object-Relational Mapping(ORM) solution for JAVA and it raised as an open source persistent framework created

by

Gavin

King

in

2001.

It

is

a

powerful,

high

performance Object-Relational Persistence and Query service for any Java Application. Hibernate maps Java classes to database tables and from Java data types to SQL data types and relieve the developer from 95% of common data persistence related programming tasks. Hibernate sits between traditional Java objects and database server to handle all the work in persisting those objects based on the appropriate O/R mechanisms and patterns.

Hibernate Advantages:  Hibernate takes care of mapping Java classes to database tables using XML files and without writing any line of code.  Provides simple APIs for storing and retrieving Java objects directly to and from the database.

 If there is change in Database or in any table then the only need to change XML file properties.  Abstract away the unfamiliar SQL types and provide us to work around familiar Java Objects.  Hibernate does not require an application server to operate.  Manipulates

Complex

associations

of

objects

of

your

database.  Minimize database access with smart fetching strategies.  Provides Simple querying of data. The Hibernate architecture is layered to keep you isolated from having to know the underlying APIs. Hibernate makes use of the database and configuration data to provide persistence services (and persistent objects) to the application. Following is a very high level view of the Hibernate Application Architecture.

Following is a detailed view of the Hibernate Application Architecture with few important core classes.

Hibernate uses various existing Java APIs, like JDBC, Java Transaction API(JTA), and Java Naming and Directory Interface (JNDI). JDBC provides a rudimentary level of abstraction of functionality common to relational databases, allowing almost any database with a JDBC driver to be supported by Hibernate. JNDI and JTA allow Hibernate to be integrated with J2EE application servers. Following section gives brief description of each of the class objects involved in Hibernate Application Architecture. Configuration Object: The Configuration object is the first Hibernate object you create in any Hibernate application and usually created only once during

application

initialization.

It

represents

a

configuration

or

properties file required by the Hibernate. The Configuration object provides two keys components:  Database Connection: This is handled through one or more configuration files supported by Hibernate. These files are hibernate.properties and hibernate.cfg.xml.  Class Mapping Setup This component creates the connection between the Java classes and database tables.. SessionFactory Object: Configuration object is used to create a SessionFactory object which inturn configures Hibernate for the application using the supplied configuration file and allows for a Session object to be instantiated. The SessionFactory is a thread safe object and used by all the threads of an application. The SessionFactory is heavyweight object so usually it is created during application start up and kept for later use. You would need one SessionFactory object per database using a separate configuration file. So if you are using multiple databases then you would have to create multiple SessionFactory objects. Session Object: A Session is used to get a physical connection with a database. The Session object is lightweight and designed to be instantiated

each time an interaction is needed with the database. Persistent objects are saved and retrieved through a Session object. The session objects should not be kept open for a long time because they are not usually thread safe and they should be created and destroyed them as needed. Transaction Object: A Transaction represents a unit of work with the database and most

of

the

Transactions

in

RDBMS

supports

Hibernate

are

transaction

handled

by

functionality. an

underlying

transaction manager and transaction (from JDBC or JTA). This is an optional object and Hibernate applications may choose not to use this interface, instead managing transactions in their own application code. Query Object: Query objects use SQL or Hibernate Query Language (HQL) string to retrieve data from the database and create objects. A Query instance is used to bind query parameters, limit the number of results returned by the query, and finally to execute the query. Criteria Object: Criteria object are used to create and execute object oriented criteria queries to retrieve objects. Hibernate requires to know in advance where to find the mapping information that defines how your Java classes relate to

the

database

tables.

Hibernate

also

requires

a

set

of

configuration settings related to database and other related parameters. All such information is usually supplied as a standard Java properties file called hibernate.properties, or as an XML file namedhibernate.cfg.xml. I will consider XML formatted file hibernate.cfg.xml to specify required Hibernate properties in my examples. Most of the properties take their default values and it is not required to specify them in the property file unless it is really required. This file is kept in the root directory of your application's classpath. Hibernate Properties: Following is the list of important properties you would require to configure for a databases in a standalone situation: S.N .

Properties and Description

1

hibernate.dialect This property makes Hibernate generate the appropriate SQL for the chosen database.

2

hibernate.connection.driver_class The JDBC driver class.

3

hibernate.connection.url

The JDBC URL to the database instance. 4

hibernate.connection.username The database username.

5

hibernate.connection.password The database password.

6

hibernate.connection.pool_size Limits the number of connections waiting in the Hibernate database connection pool.

7

hibernate.connection.autocommit Allows

autocommit

mode

to

be

used

for

the

JDBC

connection. If you are using a database along with an application server and JNDI then you would have to configure the following properties: S.N .

Properties and Description

1

hibernate.connection.datasource The JNDI name defined in the application server context you are using for the application.

2

hibernate.jndi.class The InitialContext class for JNDI.

3

hibernate.jndi. Passes any JNDI property you like to the JNDIInitialContext.

4

hibernate.jndi.url Provides the URL for JNDI.

5

hibernate.connection.username The database username.

6

hibernate.connection.password The database password.

Hibernate with MySQL Database: MySQL is one of the most popular open-source database systems available today. Let us create hibernate.cfg.xml configuration file and place it in the root of your application's classpath. You would have to make sure that you have testdb database available

in

your

MySQL

database

and

you

have

a

user test available to access the database. The XML configuration file must conform to the Hibernate 3 Configuration

DTD,

which

is

available

from

http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd.





A Session is used to get a physical connection with a database. The Session object is lightweight and designed to be instantiated each time an interaction is needed with the database. Persistent objects are saved and retrieved through a Session object. The session objects should not be kept open for a long time because they are not usually thread safe and they should be created and destroyed them as needed. The main function of the Session is to offer create, read and delete operations for instances of mapped entity classes. Instances may exist in one of the following three states at a given point in time:  transient: A new instance of a persistent class which is not associated with a Session and has no representation in the database and no identifier value is considered transient by Hibernate.  persistent: You can make a transient instance persistent by associating it with a Session. A persistent instance has a representation in the database, an identifier value and is associated with a Session.  detached: Once we close the Hibernate Session,

the

persistent instance will become a detached instance. A Session instance is serializable if its persistent classes are serializable. A typical transaction should use the following idiom:

Session session = factory.openSession(); Transaction tx = null; try { tx = session.beginTransaction(); // do some work ... tx.commit(); } catch (Exception e) { if (tx!=null) tx.rollback(); e.printStackTrace(); }finally { session.close(); } If the Session throws an exception, the transaction must be rolled back and the session must be discarded.

The entire concept of Hibernate is to take the values from Java class attributes and persist them to a database table. A mapping document helps Hibernate in determining how to pull the values from the classes and map them with table and associated fields. Java classes whose objects or instances will be stored in database tables are called persistent classes in Hibernate.

Hibernate works best if these classes follow some simple rules, also known as the Plain Old Java Object (POJO) programming model. There are following main rules of persistent classes, however, none of these rules are hard requirements.  All Java classes that will be persisted need a default constructor.  All classes should contain an ID in order to allow easy identification of your objects within Hibernate and the database. This property maps to the primary key column of a database table.  All attributes that will be persisted should be declared private and have getXXX and setXXX methods defined in the JavaBean style.  A central feature of Hibernate, proxies, depends upon the persistent

class

being

either

non-final,

or

the

implementation of an interface that declares all public methods.  All

classes

that

do

not

extend

or

implement

some

specialized classes and interfaces required by the EJB framework. The POJO name is used to emphasize that a given object is an ordinary Java Object, not a special object, and in particular not an Enterprise JavaBean.

org.hibernate.dialect.MySQLDialect com.mysql.jdbc.Drive r jdbc:mysql://localhost:3306/Gu estBook?zeroDateTimeBehavior=convertToNull root root