Hibernate example source code file (Preface.xml)

This example Hibernate source code file (Preface.xml) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" ^TM.

Java - Hibernate tags/keywords

guide, hibernate, hibernate, however, java, java, jdbc, mapping, mapping, object/relational, see, sql, sql, started

The Hibernate Preface.xml source code

<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "Hibernate_Development_Guide.ent">
%BOOK_ENTITIES;
]>
<preface id="pref-Hibernate_Development_Guide-Preface">


    <title>Preface
    <para>
        Working with both Object-Oriented software and Relational Databases can be cumbersome and time consuming.
        Development costs are significantly higher due to a paradigm mismatch between how data is represented in
        objects versus relational databases.  Hibernate is an Object/Relational Mapping solution for Java environments.
        The term Object/Relational Mapping refers to the technique of mapping data from an object model representation
        to a relational data model representation (and visa versa).  See
        <ulink url="http://en.wikipedia.org/wiki/Object-relational_mapping"/> for a good high-level discussion.
    </para>

    <note>
        <para>
            While having a strong background in SQL is not required to use Hibernate, having a basic understanding of
            the concepts can greatly help you understand Hibernate more fully and quickly.  Probably the single
            best background is an understanding of data modeling principles.  You might want to consider these resources
            as a good starting point:
            <itemizedlist>
                <listitem>
                    <para>
                        <ulink url="http://www.agiledata.org/essays/dataModeling101.html"/>
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <ulink url="http://en.wikipedia.org/wiki/Data_modeling"/>
                    </para>
                </listitem>
            </itemizedlist>
        </para>
    </note>

    <para>
        Hibernate not only takes care of the mapping from Java classes to database tables (and from Java data types to
        SQL data types), but also provides data query and retrieval facilities. It can significantly reduce
        development time otherwise spent with manual data handling in SQL and JDBC.  Hibernate’s design goal is to
        relieve the developer from 95% of common data persistence-related programming tasks by eliminating the need for
        manual, hand-crafted data processing using SQL and JDBC.  However, unlike many other persistence solutions,
        Hibernate does not hide the power of SQL from you and guarantees that your investment in relational technology
        and knowledge is as valid as always.
    </para>

    <para>
        Hibernate may not be the best solution for data-centric applications that only use stored-procedures to
        implement the business logic in the database, it is most useful with object-oriented domain models and business
        logic in the Java-based middle-tier. However, Hibernate can certainly help you to remove or encapsulate
        vendor-specific SQL code and will help with the common task of result set translation from a tabular
        representation to a graph of objects.
    </para>

    <section>
        <title>Get Involved
        <itemizedlist>
            <listitem>
                <para>
                    Use Hibernate and report any bugs or issues you find. See
                    <ulink url="http://hibernate.org/issuetracker.html"/> for details.
                </para>
            </listitem>
            <listitem>
                <para>
                    Try your hand at fixing some bugs or implementing enhancements. Again, see
                    <ulink url="http://hibernate.org/issuetracker.html"/>.
                </para>
            </listitem>
            <listitem>
                <para>
                    Engage with the community using mailing lists, forums, IRC, or other ways listed at
                    <ulink url="http://hibernate.org/community.html"/>.
                </para>
            </listitem>
            <listitem>
                <para>
                    Help improve or translate this documentation. Contact us on
                    the developer mailing list if you have interest.
                </para>
            </listitem>
            <listitem>
                <para>
                    Spread the word. Let the rest of your organization know about the benefits of
                    Hibernate.
                </para>
            </listitem>
        </itemizedlist>
    </section>

    <section>
        <title>Getting Started Guide
        <para>
            New users may want to first look through the
            <citetitle pubwork="book">Hibernate Getting Started Guide for basic information as well as
            tutorials.  Even seasoned veterans may want to considering perusing the sections pertaining to
            build artifacts for any changes.
        </para>
    </section>

</preface>