openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [CONF] OpenJPA > Quick Start
Date Wed, 11 Aug 2010 14:34:00 GMT
    <base href="">
            <link rel="stylesheet" href="/confluence/s/1810/9/5/_/styles/combined.css?spaceKey=openjpa&amp;forWysiwyg=true"
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
    <h2><a href="">Quick
    <h4>Page <b>edited</b> by             <a href="">Donald
        <div id="versionComment">
        added link to tools<br />
                         <h4>Changes (1)</h4>
<div id="page-diffs">
            <table class="diff" cellpadding="0" cellspacing="0">
            <tr><td class="diff-snipped" >...<br></td></tr>
            <tr><td class="diff-unchanged" > <br> <br></td></tr>
            <tr><td class="diff-added-lines" style="background-color: #dfd;">h2.
Tools <br> <br>OpenJPA provides several design-time and runtime tools, to perform
such tasks as entity enhancement, schema mapping, generating metamodel classes and to help
migrate from other JPA providers.  Please checkout the [Tools] page for more details. <br>
<br> <br></td></tr>
            <tr><td class="diff-unchanged" >h2. FAQ <br> <br></td></tr>
            <tr><td class="diff-snipped" >...<br></td></tr>
</div>                            <h4>Full Content</h4>
                    <div class="notificationGreySide">

<h1><a name="QuickStart-QuickStartGuide"></a>Quick Start Guide</h1>

<p>We know it can be hard to find the right help sometimes and search engines can be
overwhelming, so we will try to put the most commonly asked for topics with some overview
and links to more in-depth resources here for you to checkout, before wasting your time searching
through our <a href="/confluence/display/openjpa/Documentation" title="Documentation">Documentation</a>
and <a href="/confluence/display/openjpa/Mailing+Lists" title="Mailing Lists">Mailing
Lists</a> for help.</p>

<h2><a name="QuickStart-RuntimeDependencies"></a>Runtime Dependencies</h2>

<p>To use OpenJPA as a stand-alone Java component or with a lightweight non-Java EE
framework, please refer to the following <a href="/confluence/display/openjpa/Build+and+Runtime+Dependencies"
title="Build and Runtime Dependencies">Build and Runtime Dependencies</a> page for
the supported levels of Java SE.</p>

<p>To use OpenJPA in a Java EE application server, please refer to the following <a
href="/confluence/display/openjpa/Integration" title="Integration">Integration</a>
page for the known platforms that either include OpenJPA or have been tested with OpenJPA.</p>

<h2><a name="QuickStart-JPAExamples"></a>JPA Examples</h2>

<p>OpenJPA provides some simple examples as part of the binary distribution on the <a
href="/confluence/display/openjpa/Downloads" title="Downloads">Downloads</a> page.
 The following <a href="/confluence/display/openjpa/Samples" title="Samples">Samples</a>
page provides quick start instructions on how to build and run these samples, along with pointers
to other JPA samples from the Apache Geronimo project.</p>

<h2><a name="QuickStart-EnhancingEntities"></a>Enhancing Entities</h2>

<p>The JPA spec requires some type of monitoring of Entity objects, but the spec does
not define how to implement this monitoring. Some JPA providers auto-generate new subclasses
or proxy objects that front the user's Entity objects at <b>runtime</b>, while
others use byte-code weaving technologies to enhance the actual Entity class objects at <b>build
time</b>.  OpenJPA supports both <a href="/confluence/display/openjpa/Entity+Enhancement"
title="Entity Enhancement">enhancement</a> methods, but strongly suggests only using
the <b>build time</b> enhancement.  The following <a href="/confluence/display/openjpa/Entity+Enhancement"
title="Entity Enhancement">Entity Enhancement</a> page includes more details on both
enhancement types, along with examples on how to setup <b>build time</b> enhancement
in ANT, Maven and Eclipse environments.</p>

<h2><a name="QuickStart-Tools"></a>Tools</h2>

<p>OpenJPA provides several design-time and runtime tools, to perform such tasks as
entity enhancement, schema mapping, generating metamodel classes and to help migrate from
other JPA providers.  Please checkout the <a href="/confluence/display/openjpa/Tools" title="Tools">Tools</a>
page for more details.</p>

<h2><a name="QuickStart-FAQ"></a>FAQ</h2>

<p>Some common questions concerning the history, architecture and usage of OpenJPA can
be found on the <a href="/confluence/display/openjpa/FAQ" title="FAQ">FAQ</a>

<h2><a name="QuickStart-TaketheRedPill"></a>Take the Red Pill</h2>

<p>If you want to dive into the rabbit-hole (Hey, It's open source!), then checkout
the <a href="/confluence/display/openjpa/Found+a+Bug" title="Found a Bug">Found a Bug</a>
page, which covers everything from posting questions to our mailing lists, to getting the
source code and building it, and creating bug patches....</p>

<p><br class="atl-forced-newline" /></p>

        <div id="commentsSection" class="wiki-content pageSection">
        <div style="float: right;">
            <a href=""
class="grey">Change Notification Preferences</a>
        <a href="">View
        <a href="">View
        <a href=";showCommentArea=true#addcomment">Add

View raw message