You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by aa...@apache.org on 2014/08/16 13:59:29 UTC
svn commit: r1618343 [2/2] - in /cayenne/site/cms/trunk/content/docs/3.0: ./
images/icons/emoticons/
Modified: cayenne/site/cms/trunk/content/docs/3.0/tutorial-object-relational-mapping.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/tutorial-object-relational-mapping.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/tutorial-object-relational-mapping.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/tutorial-object-relational-mapping.html Sat Aug 16 11:59:28 2014
@@ -4,7 +4,7 @@ Title: Tutorial Object Relational Mappin
<P><SPAN class="image-wrap" style=""><IMG src="tutorial-object-relational-mapping.data/database-schema.jpg" style="border: 0px solid black"></SPAN></P>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Very often you'd have an existing database already, and it can be quickly imported in Cayenne via <TT>"Tools > Reengineer Database Schema"</TT>. This will save you lots of time compared to manual mapping. However understanding how to create the mapping by hand is important, so we are showing the "manual" approach below.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Very often you'd have an existing database already, and it can be quickly imported in Cayenne via <TT>"Tools > Reengineer Database Schema"</TT>. This will save you lots of time compared to manual mapping. However understanding how to create the mapping by hand is important, so we are showing the "manual" approach below.</TD></TR></TABLE></DIV>
<H3><A name="TutorialObjectRelationalMapping-MappingDatabaseTablesandColumns"></A>Mapping Database Tables and Columns</H3>
@@ -16,7 +16,7 @@ Title: Tutorial Object Relational Mappin
<P>Similarly add NAME VARCHAR(200) and DATE_OF_BIRTH DATE attributes. After that repeat this procedure for PAINTING and GALLERY entities to match DB schema shown above.</P>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Don't forget to save your project periodically to avoid losing your work. You will also have to refresh the project in Eclipse after every CayenneModeler save, as Eclipse is by default unaware of any changes made in the Modeler.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Don't forget to save your project periodically to avoid losing your work. You will also have to refresh the project in Eclipse after every CayenneModeler save, as Eclipse is by default unaware of any changes made in the Modeler.</TD></TR></TABLE></DIV>
<H3><A name="TutorialObjectRelationalMapping-MappingDatabaseRelationships"></A>Mapping Database Relationships</H3>
Modified: cayenne/site/cms/trunk/content/docs/3.0/tutorial-objectcontext.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/tutorial-objectcontext.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/tutorial-objectcontext.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/tutorial-objectcontext.html Sat Aug 16 11:59:28 2014
@@ -79,7 +79,7 @@ INFO: loaded map-ref: UntitledDomainMap.
INFO: finished configuration loading in 396 ms.</PRE>
</DIV></DIV>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>How to Configure Cayenne Logging</B><BR>You can tweak more or less detailed output by following the instructions in the <A href="configuring-logging.html" title="Configuring Logging">logging chapter</A>.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>How to Configure Cayenne Logging</B><BR>You can tweak more or less detailed output by following the instructions in the <A href="configuring-logging.html" title="Configuring Logging">logging chapter</A>.</TD></TR></TABLE></DIV>
<P>Nothing much happened here, but we've been able to create a working Cayenne stack. In the following chapters we'll use the ObjectContext for more interesting things.</P>
Modified: cayenne/site/cms/trunk/content/docs/3.0/tutorial-starting-project.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/tutorial-starting-project.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/tutorial-starting-project.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/tutorial-starting-project.html Sat Aug 16 11:59:28 2014
@@ -13,7 +13,7 @@ Title: Tutorial Starting Project
<P>Although later in this tutorial we'll be using Maven to include Cayenne runtime jars in the project, you'll still need to download Cayenne to get access to the CayenneModeler tool. </P>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>If you are really into Maven, you can <A href="maven2-modeler.html" title="maven2-modeler">start CayenneModeler from Maven</A> if you wish. We'll do it in a more traditional way here.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>If you are really into Maven, you can <A href="maven2-modeler.html" title="maven2-modeler">start CayenneModeler from Maven</A> if you wish. We'll do it in a more traditional way here.</TD></TR></TABLE></DIV>
<P>Download the latest release <A href="http://cayenne.apache.org/download.html" class="external-link" rel="nofollow">from here</A>. Unpack the distribution somewhere in the file system and start CayenneModeler, following <A href="running-cayennemodeler.html" title="Running CayenneModeler">platform-specific instructions</A>. On most platforms it is done simply by doubleclicking the Modeler icon. The welcome screen of the Modeler looks like this:</P>
@@ -35,7 +35,7 @@ Title: Tutorial Starting Project
</UL>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>We are creating an in-memory database here. So when you stop your application, all the data will be lost. In most real-life cases you'll be connecting to a database that actually persists its data on disk, but an in-memory DB will do for the simple tutorial.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>We are creating an in-memory database here. So when you stop your application, all the data will be lost. In most real-life cases you'll be connecting to a database that actually persists its data on disk, but an in-memory DB will do for the simple tutorial.</TD></TR></TABLE></DIV>
<P>Also you will need to change "Schema Update Strategy". Select <TT>"org.apache.cayenne.access.dbsync.CreateIfNoSchemaStrategy"</TT> from the dropdown, so that Cayenne creates a new schema on Derby based on the ORM mapping when the application starts.</P>
Modified: cayenne/site/cms/trunk/content/docs/3.0/tutorial.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/tutorial.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/tutorial.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/tutorial.html Sat Aug 16 11:59:28 2014
@@ -4,7 +4,7 @@ Title: Tutorial
<P>This is a step-by-step tutorial showing how to write a database application with Cayenne. When you are done with it, you should have an understanding of the basics of object-relational mapping using CayenneModeler and how to use the Cayenne framework in standalone (command-line or otherwise) and web applications. The tutorial uses Maven, Eclipse IDE and Derby database, however it can be easily recreated with another combination of a database, an IDE and a build system. Full tutorial source code in a form of Eclipse project is distributed with Cayenne (see <TT>"tutorials/tutorial"</TT> folder).</P>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Note about Maven</B><BR>The only potentially controversial choice here is Maven. Not everybody is familiar with Maven, and not everybody likes it. However we decided that the benefits of the setup simplicity outweigh any downsides. Note that the tutorial is using <TT>m2eclipse</TT> plugin and doesn't even require a command-line Maven installation. Moreover most of the useful Cayenne Maven hackery is presented in boxed inserts throughout the text, while a Maven-agnostic alternative is shown in the main text.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Note about Maven</B><BR>The only potentially controversial choice here is Maven. Not everybody is familiar with Maven, and not everybody likes it. However we decided that the benefits of the setup simplicity outweigh any downsides. Note that the tutorial is using <TT>m2eclipse</TT> plugin and doesn't even require a command-line Maven installation. Moreover most of the useful Cayenne Maven hackery is presented in boxed inserts throughout the text, while a Maven-agnostic alternative is shown in the main text.</TD></TR></TABLE></DIV>
<H3><A name="Tutorial-Sections"></A>Sections</H3>
Modified: cayenne/site/cms/trunk/content/docs/3.0/understanding-transactions.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/understanding-transactions.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/understanding-transactions.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/understanding-transactions.html Sat Aug 16 11:59:28 2014
@@ -101,7 +101,7 @@ domain.setTransactionDelegate(<SPAN clas
<P>If the application needs to define its own transactional scope (e.g. wrap more than one <TT>DataContext.commitChanges()</TT> in a single database transaction), an explict <TT>org.apache.cayenne.access.Transaction</TT> can be started. It will serve as a simple substitute for the JTA transactions (of course JTA UserTransaction can be used instead if desired).</P>
-<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>If the user code starts a Transaction, it <B>must</B> explicitly invoke "commit/rollback" methods and unbind the Transaction from the current thread when it is finished. Failure to do that may result in connection leaks. Of course if Cayenne starts an implicit transaction, it does the cleanup internally on its own.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>If the user code starts a Transaction, it <B>must</B> explicitly invoke "commit/rollback" methods and unbind the Transaction from the current thread when it is finished. Failure to do that may result in connection leaks. Of course if Cayenne starts an implicit transaction, it does the cleanup internally on its own.</TD></TR></TABLE></DIV>
<P>Below is an example of user-controlled Transaction code. First it obtains a new transaction from the DataDomain (alternatively users can create Transaction subclasses of their own):</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
Modified: cayenne/site/cms/trunk/content/docs/3.0/upgrade.html
URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/3.0/upgrade.html?rev=1618343&r1=1618342&r2=1618343&view=diff
==============================================================================
--- cayenne/site/cms/trunk/content/docs/3.0/upgrade.html (original)
+++ cayenne/site/cms/trunk/content/docs/3.0/upgrade.html Sat Aug 16 11:59:28 2014
@@ -17,7 +17,7 @@ Title: Upgrade
</UL>
-<DIV class="panelMacro"><TABLE class="warningMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Upgrading project XML files can make them unusable with earlier versions of Cayenne.</TD></TR></TABLE></DIV>
+<DIV class="panelMacro"><TABLE class="warningMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://cayenne.apache.org/docs/3.0/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>Upgrading project XML files can make them unusable with earlier versions of Cayenne.</TD></TR></TABLE></DIV>
<UL>
<LI>Pay attention to CayenneModeler validation warnings.</LI>