cayenne-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From aadamc...@apache.org
Subject svn commit: r488202 [14/19] - in /incubator/cayenne/main/trunk/assembly/cayenne-generic: ./ src/doc/ src/doc/confluence/ src/doc/confluence/Documentation/ src/doc/confluence/Documentation/JPA Guide/ src/doc/confluence/Documentation/JPA Guide/JPA Agent/...
Date Mon, 18 Dec 2006 10:24:42 GMT
Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-driver-1_1.dtd
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20Features/cayenne-driver-1_1.dtd?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-driver-1_1.dtd (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-driver-1_1.dtd Mon Dec 18 02:24:19 2006
@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+
+<!-- =================================================== -->
+<!-- Cayenne Driver DTD,  v 1.1                          -->
+<!--                                                     -->
+<!-- Describes Cayenne JDBC driver configuration files   -->
+<!-- usually called *.driver.xml. Note that driver files -->
+<!-- are only used when DataSource is NOT provided by    -->
+<!-- container.                                          -->
+<!-- =================================================== -->
+
+<!ELEMENT driver (url, connectionPool?, login?)>
+<!ATTLIST driver
+	class CDATA #REQUIRED
+>
+
+<!ELEMENT url EMPTY>
+<!ATTLIST url
+	value CDATA #REQUIRED
+>
+
+<!ELEMENT connectionPool>
+<!ATTLIST connectionPool
+	min CDATA #REQUIRED
+	max CDATA #REQUIRED
+>
+
+<!ELEMENT login>
+<!ATTLIST login
+	userName CDATA #REQUIRED
+	password CDATA #REQUIRED
+>

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-project-1_1.dtd
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20Features/cayenne-project-1_1.dtd?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-project-1_1.dtd (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/cayenne-project-1_1.dtd Mon Dec 18 02:24:19 2006
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<!-- =================================================== -->
+<!-- Cayenne Project DTD, v 1.1                          -->
+<!--                                                     -->
+<!-- Cayenne project files described by this DTD are     -->
+<!-- normally called "cayenne.xml" and describe          -->
+<!-- Cayenne deployment configuration for a particular   -->
+<!-- application.                                        -->
+<!-- =================================================== -->
+
+<!ELEMENT domains (domain*)>
+<!ATTLIST domains
+	project-version CDATA
+>
+
+<!ELEMENT domain (property*, map*, node*, view*)>
+<!ATTLIST domain
+	name CDATA #REQUIRED
+>
+
+<!ELEMENT property>
+<!ATTLIST property
+	name CDATA #REQUIRED
+	value CDATA #REQUIRED
+>
+
+<!ELEMENT map>
+<!ATTLIST map
+	name CDATA #REQUIRED
+	location CDATA #REQUIRED
+>
+
+<!ELEMENT node (map-ref*)>
+<!ATTLIST node
+	name CDATA #REQUIRED
+	factory CDATA #REQUIRED
+	datasource CDATA #REQUIRED
+	adapter CDATA #IMPLIED 
+>
+
+<!ELEMENT view>
+<!ATTLIST view
+	name CDATA #REQUIRED
+	location CDATA #REQUIRED
+>
+
+<!ELEMENT map-ref>
+<!ATTLIST map-ref
+	name CDATA #REQUIRED
+>
+

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20Features/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,207 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - Guide to 1.1 Features</title>
+    <style type="text/css">@import "../../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">Guide to 1.1 Features</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/Acknowledgments/index.html">Acknowledgments</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/License/index.html">License</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html">Guide to 1.1 Features</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a></li>
+<li><a href="../../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Cayenne version 1.1 introduces a large number of new features and enhancements over 1.0. This chapter lists most of them, providing the links to more detailed information about each feature.</p>
+
+<h3><a name="Guideto1.1Features-DTDAdditions."></a>DTD Additions.</h3>
+
+<p>"cayenne.xml" and "*.map.xml" file formats were updated to support new features. 1.1 DTD files are located here:</p>
+<ul>
+	<li><span class="nobr"><a href="cayenne-project-1_1.dtd?version=2" title="cayenne-project-1_1.dtd attached to Guide to 1.1 Features">cayenne-project-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+	<li><span class="nobr"><a href="cayenne-data-map-1_2.dtd?version=2" title="cayenne-data-map-1_2.dtd attached to Guide to 1.1 Features">cayenne-data-map-1_2.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+	<li><span class="nobr"><a href="cayenne-data-view-1_1.dtd?version=2" title="cayenne-data-view-1_1.dtd attached to Guide to 1.1 Features">cayenne-data-view-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+	<li><span class="nobr"><a href="cayenne-driver-1_1.dtd?version=2" title="cayenne-driver-1_1.dtd attached to Guide to 1.1 Features">cayenne-driver-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+</ul>
+
+
+<table cellpadding='5' width='85%' cellspacing='8px' class='warningMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../../images/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b class="strong">Upgrade Warning</b><br />Saving projects with CayenneModeler v.1.1 will render them uneditable with CayenneModeler v.1.0.</td></tr></table>
+
+<h3><a name="Guideto1.1Features-AdvancedLocalandDistributedCaching"></a>Advanced Local and Distributed Caching</h3>
+
+<p>Cayenne now provides a way to share its object cache between DataContexts in the same JVM and across JVMs. The following chapters in the user guide describe this feature:</p>
+<ul>
+	<li><a href="../../../../Documentation/User Guide/Design/Object Caching/index.html" title="Object Caching">Object Caching</a></li>
+	<li><a href="../../../../Documentation/User Guide/Queries/Caching Query Results/index.html" title="Caching Query Results">Caching Query Results</a></li>
+	<li><a href="../../../../Documentation/User Guide/Performance Tuning/Caching Lookup Tables/index.html" title="Caching Lookup Tables">Caching Lookup Tables</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-OptimisticLocking"></a>Optimistic Locking</h3>
+
+<p>ObjAttributes and ObjRelationships can be marked to be used for "optimistic" locking. If an corresponding columns of the underlying database row are externally modified, an attempt to save an object results in OptimisticLockingException.</p>
+
+<h3><a name="Guideto1.1Features-DataObjectUtilsaneasywaytomapobjectsbyPK"></a>DataObjectUtils - an easy way to map objects by PK</h3>
+
+<p><a href="../../../../Documentation/User Guide/DataObjects/DataObjectUtils/index.html" title="DataObjectUtils">DataObjectUtils</a> is an often requested feature for easy retrieval of an object primary key, or locating an object for a known key. It works in a generic way for any type of DataObjects, even if a PK is not a class property.</p>
+
+<h3><a name="Guideto1.1Features-EntityInheritance"></a>Entity Inheritance</h3>
+
+<p>Cayenne now supports entity inheritance for entities rooted in the same DB table (single table inheritance).</p>
+
+<h3><a name="Guideto1.1Features-DataViewsandDVModeler"></a>Data Views and DVModeler</h3>
+
+<p><a href="../../../../Documentation/User Guide/DataViews/index.html" title="DataViews">DataViews</a> is a completely new addition to Cayenne. This is a framework and a Swing modeler tool to quickly build Swing applications based on Cayenne.</p>
+
+<h3><a name="Guideto1.1Features-GenericMultithreadedandDistributedEventsMechanism"></a>Generic Multithreaded and Distributed Events Mechanism</h3>
+
+<p>Cayenne now includes a generic <a href="../../../../Documentation/User Guide/Design/Runtime Components/Event Package/index.html" title="Event Package">event package</a> "org.objectstyle.cayenne.event" for registering listeners and sending events, both locally and remotely. It supports both blocking and non-blocking listeners and dispatches. Supported remote transports include JMS and JavaGroups.</p>
+
+<h3><a name="Guideto1.1Features-DataObjectsValidation"></a>DataObjects Validation</h3>
+
+<p>DataContext now performs validation of DataObjects before committing them. There is a set of default validation checks being executed, based on the DataMap information. Developers can override DataObject validation methods to provide custom validation checks.</p>
+
+<p>See user guide chapter on <a href="../../../../Documentation/User Guide/DataObjects/DataObject Validation/index.html" title="DataObject Validation">object validation</a>.</p>
+
+<h3><a name="Guideto1.1Features-ExpressionAPIEnhancements"></a>Expression API Enhancements</h3>
+
+<p>There is a new expression parser that allows creation of complex expressions from strings ("Expression.fromString(..)"). This greatly reduces the amount of code needed to build an expression.</p>
+
+<p>In-memory evaluation API is improved, and now supports both boolean conditions (via "Expression.match" method) and generic expressions evaluation (via "Expression.evaluate" method), it also includes support for arithmetic operations.</p>
+<ul>
+	<li><a href="../../../../Documentation/User Guide/Expressions/index.html" title="Expressions">Expressions</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-SQLTemplateADynamicRawSQLQuery"></a>SQLTemplate - A Dynamic Raw SQL Query</h3>
+
+<p>SQLTemplate replaces SqlSelectQuery and SqlModifyQuery and is a scriptable parameterized raw SQL query. It supports DataObjects and other features declared in GenericSelectQuery interface.</p>
+<ul>
+	<li><a href="../../../../Documentation/User Guide/Queries/SQLTemplate Query/index.html" title="SQLTemplate Query">SQLTemplate Query</a></li>
+	<li><a href="../../../../Documentation/User Guide/Queries/Scripting SQLTemplate/index.html" title="Scripting SQLTemplate">Scripting SQLTemplate</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-DataContextAPIforRunningParameterizedNamedQueries"></a>DataContext API for Running Parameterized Named Queries</h3>
+
+<p>DataContext now provides simple API to run SelectQuery, SQLTemplate and ProcedureQuery by name if such queries are mapped via CayenneModeler:</p>
+<ul>
+	<li><a href="../../../../Documentation/User Guide/DataContext/index.html" title="DataContext">DataContext Query API Overview</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-SupportforSharedMappingNamespace"></a>Support for Shared Mapping Namespace</h3>
+
+<p>DataDomain now provides a shared mapping namespace. This means that all mapping objects can reference other mapping objects outside their DataMaps. For example two DbEntities can be located in different DataMaps and still have relationships to each other.</p>
+
+<p>Temporary limitation of the shared mapping namespace is that Queries stored in the DataMap can't have a "root" from a different DataMap.</p>
+
+<h3><a name="Guideto1.1Features-SnapshotEvents"></a>SnapshotEvents</h3>
+
+
+<h3><a name="Guideto1.1Features-DataContextDelegate"></a>DataContextDelegate</h3>
+
+
+<h3><a name="Guideto1.1Features-EntityRestrictingQualifier"></a>Entity Restricting Qualifier</h3>
+
+<p>ObjEntities now can hold a qualifier expression that is automatically appended to any query qualifiers, thus creating a global data filter for a given entity. This feature is used for inheritance mapping, however it has nothing to do with inheritance as such and can be used all by itself.</p>
+
+<h3><a name="Guideto1.1Features-ExplicitTransactionAPIandContainerManagedTransactions"></a>Explicit Transaction API and Container Managed Transactions</h3>
+
+<p>Cayenne now supports container-managed transactions. As a result it can be used inside EJBs out of the box. It also allows a high degree of transactions customization. The following user guide chapter explains Transactions design and behavior in details:</p>
+<ul>
+	<li><a href="http://cwiki.apache.org/confluence/confluence/display/CAYDOC/Design#Design-CayenneTransactions" title="Cayenne Transactions on Design">Understanding Transactions</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-VariousPerformanceEnhancements"></a>Various Performance Enhancements</h3>
+
+<ul>
+	<li>Lazy Relationship Creation - when new objects are fetched, their relationships are not initialized immediately; a Fault singleton is used isntead as a placeholder. Of course in the past Cayenne also had "lazy" relationships, meaning that they didn't get resolved via a DB query until accessed. Current optimization goes further - it prevents a number of Java objects (such as empty Lists for to-many relationship, or "hollow" DataObjects for to-ones) from being created until absolutely necessary.</li>
+	<li>To-many relationships do not have to be fully resolved on modification - if an unresolved to-many relationship is modified (i.e. an object is added or removed from it), it is not resolved until the next "read" (i.e. until a call to "size()" or "iterator()" method). This is especially helpful with bi-directional one-to-many relationships. E.g. "painting.addToArtist(artist)" used to trigger the fetch of all paintings that belong to an artist. Not anymore.</li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-MoreDatabasesHaveCustomDbAdapters"></a>More Databases Have Custom DbAdapters</h3>
+
+<p>Cayenne features new database adapters:</p>
+<ul>
+	<li>OpenBase Adapter</li>
+	<li>MS SQL Server Adapter</li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-SupportforToOneRelationshipsNotPointingtoaPK."></a>Support for To-One Relationships Not Pointing to a PK.</h3>
+
+<p>Added support for one-to-one relationships between PK and non-PK columns of related tables. In the past this could only be modeled as one-to-many. CayenneModeler will create UNIQUE constraint for a non-PK columns during schema generation.</p>
+
+<h3><a name="Guideto1.1Features-SupportforQueriesinDataMapDTD."></a>Support for Queries in DataMap DTD.</h3>
+
+<p>Queries are made first-class mapping objects. They can be modeled in CayenneModeler and stored in DataMaps. Application code can then reuse such queries.</p>
+<ul>
+	<li><a href="../../../../Documentation/Modeler Guide/Modeling Queries/index.html" title="Modeling Queries">Modeling Queries</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1Features-NonrefreshingSelectQueries"></a>Non-refreshing Select Queries</h3>
+
+
+<h3><a name="Guideto1.1Features-CayenneModelerEnhancements."></a>CayenneModeler Enhancements.</h3>
+
+<p>The following is an incomplete list of enhancements: new professional look and feel, preference engine, reenginnering of stored procedures, local DataSources, configurable locations of JDBC drivers, custom class generation templates, etc. A number of Modeler tasks and dialogs have been redesigned and improved to be more user-friendly and consistent.</p>
+
+<p>Also CayenneModeler supports mapping of all the new 1.1 framework features, such as DataMap queries, cache synchronization configuration, etc.</p></div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/Guide%20to%201.2%20Features/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,223 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - Guide to 1.2 Features</title>
+    <style type="text/css">@import "../../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">Guide to 1.2 Features</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/Acknowledgments/index.html">Acknowledgments</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/License/index.html">License</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html">Guide to 1.1 Features</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a><ul>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a></li>
+<li><a href="../../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent">
+<p>This page describes new features and other changes introduced in 1.2 release.</p>
+
+<h2><a name="Guideto1.2Features-CoreFramework"></a>Core Framework </h2>
+
+<h4><a name="Guideto1.2Features-RemoteObjectPersistenceRemoteObjectPersistenceGuide"></a><a href="../../../../Documentation/Remote Object Persistence Guide/index.html" title="Remote Object Persistence Guide">Remote Object Persistence</a> </h4>
+
+<p>Cayenne Remote Object Persistence is a low-overhead web services-based technology that provides lightweight  generic object persistence and data query functionality to 'remote' applications. It allows to use the same object model and the same context capabilities in a system with more than one Java tier. Now persistence features can be implemented consistently across a set of collaborating applications with different responsibilities and security context.</p>
+
+
+<h4><a name="Guideto1.2Features-ObjectContextAPIObjectContext"></a><a href="../../../../Documentation/User Guide/Design/Runtime Components/ObjectContext/index.html" title="ObjectContext">ObjectContext API</a></h4>
+
+<p><a href="../../../../Documentation/User Guide/Design/Runtime Components/ObjectContext/index.html" title="ObjectContext">ObjectContext</a> is a new interface that is a generalization of the traditional DataContext. In fact DataContext is one of its main implementors. Another implementation is <tt>CayenneContext</tt> used on remote clients.</p>
+
+<h4><a name="Guideto1.2Features-QueryEnhancements"></a>Query Enhancements</h4>
+
+<ul>
+	<li><a href="../../../../Documentation/User Guide/Performance Tuning/Prefetching/index.html" title="Prefetching">Prefetching</a>
+	<ul>
+		<li>Cayenne now supports prefetching of flattened relationships.</li>
+		<li>New "joint" prefetch semantics is introduced.</li>
+		<li>Semantics of prefetching now can be customized by users via <tt>PrefetchTreeNode</tt> API.</li>
+		<li>SQLTemplate and ProcedureQuery can be configured to emulate joint prefetching behavior.</li>
+	</ul>
+	</li>
+</ul>
+
+
+<ul>
+	<li><a href="../../../../Documentation/User Guide/Queries/Customizing Queries/index.html" title="Customizing Queries">Customizing Queries</a>: In 1.2 Queries can have behavior in addition to storing query parameters. Now queries can route themselves and also handle their own execution at the JDBC level. This opens endless possibilities for custom extensions.</li>
+</ul>
+
+
+<ul>
+	<li>New Query Types: <a href="../../../../Documentation/User Guide/Queries/Customizing Queries/index.html" title="Customizing Queries">Customizing Queries</a> support in the access stack made it possible to include new useful types of queries:
+	<ul>
+		<li><a href="../../../../Documentation/User Guide/Queries/QueryChain/index.html" title="QueryChain">QueryChain</a></li>
+		<li><a href="../../../../Documentation/User Guide/Queries/ObjectIdQuery/index.html" title="ObjectIdQuery">ObjectIdQuery</a></li>
+		<li><a href="../../../../Documentation/User Guide/Queries/RelationshipQuery/index.html" title="RelationshipQuery">RelationshipQuery</a></li>
+		<li><a href="../../../../Documentation/User Guide/Queries/NamedQuery/index.html" title="NamedQuery">NamedQuery</a></li>
+	</ul>
+	</li>
+</ul>
+
+
+<ul>
+	<li>More consistent <a href="../../../../Documentation/User Guide/Queries/Caching Query Results/index.html" title="Caching Query Results">cache/refresh API</a></li>
+</ul>
+
+
+<h4><a name="Guideto1.2Features-GeneratedColumns"></a><a href="../../../../Documentation/User Guide/Design/Primary Key Generation/Generated Columns/index.html" title="Generated Columns">Generated Columns</a></h4>
+
+<p>Cayenne now supports auto-increment/identity columns as an alternative mechanism for primary key generation.</p>
+
+<h4><a name="Guideto1.2Features-DTDChanges"></a>DTD Changes</h4>
+
+<p>...</p>
+
+<h4><a name="Guideto1.2Features-JDK1.5FeaturesSupport"></a>JDK 1.5 Features Support</h4>
+
+<ul>
+	<li>Mapping Properties as Enums. Numeric or character database columns can now be mapped as custom Enums. Cayenne supports this out of the box without any special configuration. Assumption is made that character columns store the <b>name</b> of a given Enum object, while numeric columns store a position of a given Enum object in the Enum class.</li>
+</ul>
+
+
+<h4><a name="Guideto1.2Features-GenericPersistentClass"></a><a href="../../../../Documentation/User Guide/DataObjects/Generic Persistent Class/index.html" title="Generic Persistent Class">Generic Persistent Class</a></h4>
+
+<p>Cayenne allows CayenneDataObject (or its subclass) to be used as a generic persistent object, skipping class generation and compilation steps. Use only when appropriate!</p>
+
+<h4><a name="Guideto1.2Features-WebApplicationContextFilter"></a>WebApplicationContextFilter</h4>
+
+<p>A Servlet Specification 2.3 compatible way to bind DataContext to the request thread. See chapter 12.2.4 of the new User Guide shipped with 1.2 milestones for details.</p>
+
+<h4><a name="Guideto1.2Features-DBCPDataSourceFactory%3ADBCPPoolSupport"></a>DBCPDataSourceFactory: DBCP Pool Support</h4>
+
+<p>A connection pool from jakarta-commons DBCP project is now supported via the modeler - just select DBCPDataSourceFactory from the DataSource factories dropdown. The new factory loads its configuration from a specified properties file (see DBCPDataSourcefactory Javadocs for supported properties). DBCP connection pool is much more advanced than the one provided by Cayenne and supports a dozen or so runtime parameters. See Javadocs for org.objectsyle.cayenne.conf.DBCPDataSourceFactory for details.</p>
+
+<h4><a name="Guideto1.2Features-DatabaseAdapterImprovements%2FNewAdapters"></a>Database Adapter Improvements/New Adapters</h4>
+
+<ul>
+	<li>New adapter for Cloudscape/Derby</li>
+	<li>New adapter for FrontBase</li>
+	<li>New adapter for Ingres</li>
+	<li>MySQL adapter is improved to support referential integrity constraints for InnoDB tables.</li>
+	<li>Adapter Auto Detection. Users no longer need to specify DbAdapter in the Modeler. All standard adapters are "guessed" by Cayenne in runtime using database metadata. Only custom adapters need to be set explicitly, using the new "Adapter" tab in the DataNode Editor panel. This simplifies configuration, makes deployment more transparent, and allows Cayenne to dynamically tweak adapter settings depending on the underlying database version and runtime parameters.</li>
+	<li><span class="nobr"><a href="http://objectstyle.org/cayenne/userguide/access-stack/extended-types.html" title="Visit page outside Confluence" rel="nofollow">Extended type mechanism<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> now allows mapping a persistent property as an interface. This can be achieved via ExtendedTypeFactory API. A custom <tt>ExtendedTypeFactory</tt> is registered in a manner similar to ExtendedType with adapter's <tt>ExtendedTypeMap</tt>: <tt>extendedTypeMap.addFactory(myFactory)</tt>. Cayenne already takes advantage of this API by providing a factory that handles an arbitrary JDK 1.5 Enum via reflection.</li>
+</ul>
+
+
+
+<h4><a name="Guideto1.2Features-DataContextImprovements"></a>DataContext Improvements</h4>
+
+<ul>
+	<li>User Properties Map. DataContext now maintains an internal map of user-defined values. This allows users to associate certain data with a given DataContext.</li>
+</ul>
+
+
+<ul>
+	<li><a href="../../../../Documentation/User Guide/DataContext/DataContextFactory/index.html" title="DataContextFactory">DataContextFactory</a>. DataContext allows to register an optional factory class (via the Modeler or in the API) that will be used to create DataContexts. This way users can implement DataContext subclasses that will seamlessly integrate in  the existing Cayenne stack.</li>
+</ul>
+
+
+<ul>
+	<li><a href="../../../../Documentation/User Guide/DataContext/Nested DataContexts/index.html" title="Nested DataContexts">DataContexts Nesting</a> that allows to perform partial in-memory commits/rollbacks.</li>
+</ul>
+
+
+<h4><a name="Guideto1.2Features-XMLSerializationCAY%3AXMLSerialization"></a><a href="http://cwiki.apache.org/confluence/confluence/display/CAY/XML+Serialization" title="XML Serialization">XML Serialization</a></h4>
+
+<p>A new package <tt>org.objectstyle.cayenne.xml</tt> provides a way to encode arbitrary Java objects to XML and decode them from XML. It allows a great degree of control over the XML structure, thus simplifying integration with third party XML message systems. M5 features the first usable release of this feature. However there may be more changes in the course of 1.2.</p>
+
+<p><em>Need to document this better, for now see Javadocs for <tt>org.objectstyle.cayenne.xml.XMLEncoder</tt> and <tt>org.objectstyle.cayenne.xml.XMLDecoder</tt>.</em></p>
+
+<h4><a name="Guideto1.2Features-LoadingJNDIDataNodesfromLocalPreferencesUsingJNDI"></a><a href="../../../../Documentation/User Guide/Deployment/Using JNDI/index.html" title="Using JNDI">Loading JNDI DataNodes from Local Preferences</a></h4>
+
+<p>If a DataNode is configured to use JNDIDataSourceFactory, you can setup a "Local DataSource" via Modeler preferences with the name matching the JNDI name. After that when you run your application locally without a JNDI container, Cayenne would use local preferences database.</p>
+
+<h4><a name="Guideto1.2Features-WebObjectsIntegration"></a>WebObjects Integration</h4>
+
+<p>EOModel importer now correctly imports EOFetchSpecification qualifiers, prefetches and a number of other previously ignored parameters.</p>
+
+<h2><a name="Guideto1.2Features-Tools%3ACayenneModeler%2CAntTools"></a>Tools: CayenneModeler, Ant Tools</h2>
+
+<h4><a name="Guideto1.2Features-GeneralUIRework"></a>General UI Rework</h4>
+
+<p>CayenneModeler is significantly more user friendly compared to 1.1.</p>
+
+<ul>
+	<li>Modeler is packaged as a native application for Windows and Mac OS X.</li>
+	<li>Entity editors have their own "local" toolbars for working with attributes and relationships instead of trying to locate a needed button in the common top toolbar.</li>
+	<li>There are two history navigation buttons allowing to quickly return back to the places that you've recently visited.</li>
+	<li>There are new PK generator options at the DbEntity level.</li>
+	<li>A class generator dialog is completely redesigned to provide a number of advanced options and better general usability.</li>
+	<li>A number of visual bug fixes, new icons, etc.</li>
+	<li>A number of performance enhancements.</li>
+</ul>
+
+
+
+<h4><a name="Guideto1.2Features-AntTaskImprovements"></a>Ant Task Improvements</h4>
+
+<ul>
+	<li>Antlib descriptor for Cayenne Ant Tasks</li>
+	<li>Vastly extended and improved <tt>cgen</tt>. See <tt>cgen</tt> task documetation in the user guide shipped with release for more details. Note that cgen maybe split in two tasks to make it simpler.</li>
+	<li>New <tt>cdbgen</tt> task</li>
+	<li>New <tt>cdataport</tt> database data porting task. <em>(moved from examples with improvements)</em></li>
+</ul>
+
+
+<h4><a name="Guideto1.2Features-CodeGenerationImprovements"></a>Code Generation Improvements</h4>
+
+<ul>
+	<li>Customizable Encoding Of Generated Files. Desired encoding for generated Java files can be specified in the Modeler in Preferences and as an "encoding" attribute of the cgen Ant task. This is helpful in cross-platform development situations.</li>
+</ul>
+</div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/License/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/License/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/License/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/License/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,274 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - License</title>
+    <style type="text/css">@import "../../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">License</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/Acknowledgments/index.html">Acknowledgments</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/License/index.html">License</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html">Guide to 1.1 Features</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a></li>
+<li><a href="../../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>This software is distributed and should be used on terms of Apache 2.0 software license. In short, it is free of charge, and unrestricted for commercial use. Here is the full license text:</p>
+
+<div class="preformatted"><div class="preformattedContent">
+<pre>                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+</pre>
+</div></div></div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/License/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Introduction/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,85 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - Introduction</title>
+    <style type="text/css">@import "../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">Introduction</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../Documentation/User Guide/Introduction/Acknowledgments/index.html">Acknowledgments</a></li>
+<li><a href="../../../Documentation/User Guide/Introduction/License/index.html">License</a></li>
+<li><a href="../../../Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html">Guide to 1.1 Features</a></li>
+<li><a href="../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a></li>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a></li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a></li>
+<li><a href="../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent">
+<p>Cayenne is a mature, powerful, full-featured open source Object/Relational Mapping (ORM) framework. Cayenne is written in Java and is intended for Java developers working with relational databases. Cayenne has been successfully deployed in production environments on high volume sites.</p>
+
+<p>Cayenne allows to reduce the development time in any database project by creating an object-oriented abstraction of the database schema. Development teams using Cayenne will be able to concentrate on the core business requirements and the data model instead of the SQL details.</p>
+
+<p>Cayenne features include management of persistent Java objects mapped to relational databases, single method call queries and updates (including atomic updates of all modified objects), seamless integration of multiple databases into a single virtual data source, remote object persistence, etc. Cayenne is distributed with CayenneModeler - a complete GUI mapping tool that supports reverse-engineering of RDBMS schema, editing database mappings and generation of Java source code for the persistent objects.</p>
+
+<p>Cayenne comes with a comprehensive set of HTML documentation and full source code, including source code for the GUI tools. Free support is provided via user mailing lists. Commerical support and consulting services are also available. </p>
+
+<h3><a name="Introduction-Sections"></a>Sections</h3>
+<ul>
+	<li><a href="../../../Documentation/User Guide/Introduction/Acknowledgments/index.html" title="Acknowledgments">Acknowledgments</a></li>
+	<li><a href="../../../Documentation/User Guide/Introduction/License/index.html" title="License">License</a></li>
+	<li><a href="../../../Documentation/User Guide/Introduction/Guide to 1.1 Features/index.html" title="Guide to 1.1 Features">Guide to 1.1 Features</a></li>
+	<li><a href="../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html" title="Guide to 1.2 Features">Guide to 1.2 Features</a></li>
+</ul>
+
+
+</div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Introduction/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Lifecycle Callbacks/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Lifecycle%20Callbacks/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Lifecycle Callbacks/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Lifecycle Callbacks/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,162 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - Lifecycle Callbacks</title>
+    <style type="text/css">@import "../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">Lifecycle Callbacks</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a><ul>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a></li>
+<li><a href="../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p><em>(in 3.0 since 9/21/2006)</em></p>
+
+<p><em>TODO: annotations, default callback for all entities, Modeler support</em></p>
+
+<p>Users can register callback methods that will be invoked during the lifecycle of persistent objects. Callback mechanism matches closely the one defined in the <a href="../../../Documentation/JPA Guide/index.html" title="JPA Guide">JPA Specification</a> (except that it works with JDK 1.4 and allows preconfigured listeners). There are seven lifecycle callbacks described below (PrePersist, PostPersist, PreUpdate, PostUpdate, PreRemove, PostRemove, PostLoad). There are two types of invocations for each one of them: <b>callback on a persistent object</b> itself or a <b>callback on  an arbitrary listener object</b>.</p>
+
+<table cellpadding='5' width='85%' cellspacing='8px' class='noteMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../images/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b class="strong">Callbacks feature supercedes the following 1.2/2.0 features:</b><br />
+<ul>
+	<li>Interception of object state transitions inside <tt>"Persistent.setPersistenceState()"</tt>.</li>
+	<li>Event mechanism defined in <tt>"org.apache.cayenne.access.event"</tt> package. Scheduled for removal in 3.0.</li>
+	<li><tt>"DataObject.validateForX"</tt> - it is a good idea to use it strictly for validation; updating the state before commit should be done via callbacks.</li>
+	<li><tt>"DataObject.fetchFinished()"</tt> - scheduled for removal in 3.0</li>
+</ul>
+</td></tr></table>
+
+<h2><a name="LifecycleCallbacks-CallbackMethodSemantics"></a>Callback Method Semantics</h2>
+
+<ul>
+	<li>No formal interface is required to mark a method to be used for callback.</li>
+	<li>A callback method signature looks like <tt>"void someMethod()"</tt> for persistent classes.</li>
+	<li>It looks like <tt>"void method(Type entityObject)"</tt> for listener classes.</li>
+	<li>A callback method can have an arbitrary name.</li>
+	<li>A callback method can use public, private, protected or default access.</li>
+	<li>They must NOT be static.</li>
+	<li>Callback methods are polymorphic - registering a callback on a superclass (even if the superclass does not map to an entity) will ensure the callback will be invoked on all entity subclasses, using the overriding subclass method if applicable.</li>
+</ul>
+
+
+<p>Callback on persistent object example:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java"><span class="code-keyword">public</span> class Artist { 
+   ...
+
+   <span class="code-comment">// a vaid callback method
+</span>   <span class="code-keyword">protected</span> void setDefaultProperties() {
+      ...
+   }
+}</pre>
+</div></div>
+
+
+<p>Callback on a listener class example:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java"><span class="code-keyword">public</span> class MyListener { 
+   ...
+
+   <span class="code-comment">// a vaid callback method
+</span>   <span class="code-keyword">public</span> void initArtist(Artist a) {
+      ...
+   }
+}</pre>
+</div></div>
+
+<h2><a name="LifecycleCallbacks-TypesofCallbacks"></a>Types of Callbacks</h2>
+
+<table class='confluenceTable'><tbody>
+<tr>
+<th class='confluenceTh'>Callback</th>
+<th class='confluenceTh'>Invoked...</th>
+</tr>
+<tr>
+<td class='confluenceTd'>PrePersist</td>
+<td class='confluenceTd'>Within <tt>"ObjectContext.newObject()"</tt> after ObjectId and ObjectContext are set.</td>
+</tr>
+<tr>
+<td class='confluenceTd'>PreRemove</td>
+<td class='confluenceTd'>Before an object is deleted inside <tt>"ObjectContext.deleteObject()"</tt>; also includes all objects that will be deleted as a result of CASCADE delete rule.</td>
+</tr>
+<tr>
+<td class='confluenceTd'>PreUpdate</td>
+<td class='confluenceTd'>Prior to commit (and prior to "validateFor*") within <tt>"ObjectContext.commitChanges()"</tt> and <tt>"ObjectContext.commitChangesToParent()"</tt></td>
+</tr>
+<tr>
+<td class='confluenceTd'>PostPersist</td>
+<td class='confluenceTd'>Within <tt>"ObjectContext.commitChanges()"</tt>, after commit of a new object is done.</td>
+</tr>
+<tr>
+<td class='confluenceTd'>PostRemove</td>
+<td class='confluenceTd'>Within <tt>"ObjectContext.commitChanges()"</tt>, after commit of a deleted object is done.</td>
+</tr>
+<tr>
+<td class='confluenceTd'>PostUpdate</td>
+<td class='confluenceTd'>Within <tt>"ObjectContext.commitChanges()"</tt>, after commit of a modified object is done.</td>
+</tr>
+<tr>
+<td class='confluenceTd'>PostLoad</td>
+<td class='confluenceTd'><ul>
+	<li>Within <tt>"ObjectContext.performQuery()"</tt> after the object is fetched.</li>
+	<li>Within <tt>"ObjectContext.rollbackChanges()"</tt> after the object is reverted.</li>
+	<li>Anytime a faulted object is resolved (i.e. if a relationship is fetched.</li>
+</ul>
+</td>
+</tr>
+</tbody></table>
+
+<h2><a name="LifecycleCallbacks-EnablingCallbacks"></a>Enabling Callbacks</h2>
+
+<p>TODO</p></div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Lifecycle Callbacks/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Maven2 Plugins/index.html
URL: http://svn.apache.org/viewvc/incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User%20Guide/Maven2%20Plugins/index.html?view=auto&rev=488202
==============================================================================
--- incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Maven2 Plugins/index.html (added)
+++ incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Maven2 Plugins/index.html Mon Dec 18 02:24:19 2006
@@ -0,0 +1,104 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one
+   or more contributor license agreements.  See the NOTICE file
+   distributed with this work for additional information
+   regarding copyright ownership.  The ASF licenses this file
+   to you under the Apache License, Version 2.0 (the
+   "License"); you may not use this file except in compliance
+   with the License.  You may obtain a copy of the License at
+ 
+     http://www.apache.org/licenses/LICENSE-2.0
+ 
+   Unless required by applicable law or agreed to in writing,
+   software distributed under the License is distributed on an
+   "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+   KIND, either express or implied.  See the License for the
+   specific language governing permissions and limitations
+   under the License.
+-->
+<html>
+  <head>
+    <title>Apache Cayenne Documentation - Maven2 Plugins</title>
+    <style type="text/css">@import "../../../style.css";</style>
+  </head>
+<body>
+  <div class="header">
+    <div style="float: left;"><a href="http://incubator.apache.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+    <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+    <span class="pagetitle">Maven2 Plugins</span>
+  </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Lifecycle Callbacks/index.html">Lifecycle Callbacks</a></li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Caching and Fresh Data/index.html">Caching and Fresh Data</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Maven2 Plugins/index.html">Maven2 Plugins</a><ul>
+<li><a href="../../../Documentation/User Guide/Maven2 Plugins/maven2-cgen/index.html">maven2-cgen</a></li>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/Customizing/index.html">Customizing</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><table cellpadding='5' width='85%' cellspacing='8px' class='noteMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../images/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>
+<p>This documentation is very much work-in-progress and subject to change.</p></td></tr></table>
+
+<p>Cayenne ships with Maven 2 plugins that provide Maven 2 frontend to a number of useful operations in Cayenne. The following tasks are included:</p>
+
+<ul>
+	<li><b><a href="../../../Documentation/User Guide/Maven2 Plugins/maven2-cgen/index.html" title="maven2-cgen">maven2&#45;cgen</a></b> - Java class generator</li>
+	<li><b><span class="nobr"><a href="/confluence/pages/createpage.action?spaceKey=CAYDOC&amp;title=maven2-cdbgen&amp;linkCreation=true&amp;fromPageId=28627" title="Create Page: maven2-cdbgen" class="createlink">maven2&#45;cdbgen<sup><img class="rendericon" src="../../../images/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></b> - Database schema generator</li>
+	<li><b><span class="nobr"><a href="/confluence/pages/createpage.action?spaceKey=CAYDOC&amp;title=maven2-cdeploy&amp;linkCreation=true&amp;fromPageId=28627" title="Create Page: maven2-cdeploy" class="createlink">maven2&#45;cdeploy<sup><img class="rendericon" src="../../../images/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></b> - Deployment configurator</li>
+	<li><b><span class="nobr"><a href="/confluence/pages/createpage.action?spaceKey=CAYDOC&amp;title=maven2-cdataport&amp;linkCreation=true&amp;fromPageId=28627" title="Create Page: maven2-cdataport" class="createlink">maven2&#45;cdataport<sup><img class="rendericon" src="../../../images/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></b> - Data porting tool.</li>
+</ul>
+
+
+<h3><a name="Maven2Plugins-ImportingCayennePlugininpom.xml"></a>Importing Cayenne Plugin in pom.xml</h3>
+<p>In order to use the Cayenne Maven 2 plugin, you must first add the appropriate repository information to your pom.xml.  If you already are using Cayenne via Maven 2, then you will have already performed this step and thus may skip it.  Otherwise, please add the following to your pom.xml:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java">&lt;repositories&gt;
+  &lt;repository&gt;
+    &lt;releases/&gt;
+    &lt;id&gt;apache.incubating.snapshots&lt;/id&gt;
+    &lt;url&gt;http:<span class="code-comment">//people.apache.org/repo/m2-incubating-repository/&lt;/url&gt;
+</span>  &lt;/repository&gt;
+&lt;/repositories&gt;</pre>
+</div></div>
+
+<p>Next, you need to add the Cayenne plugin to your project by adding the following:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java">&lt;build&gt;
+  &lt;plugins&gt;
+    &lt;plugin&gt;
+       &lt;groupId&gt;org.apache.cayenne.plugins&lt;/groupId&gt;
+       &lt;artifactId&gt;cayenne-maven-plugin&lt;/artifactId&gt;
+       &lt;version&gt;3.0-incubating-SNAPSHOT&lt;/version&gt;
+    &lt;/plugin&gt;
+  &lt;/plugins&gt;
+&lt;/build&gt;</pre>
+</div></div>
+
+</div>
+</div>
+  <div class="clearer">.</div>
+  <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+  <div class="smalltext copyright">
+    Copyright &copy;2001-2006 Apache Software Foundation
+  </div>
+
+</body>
+</html>

Propchange: incubator/cayenne/main/trunk/assembly/cayenne-generic/src/doc/confluence/Documentation/User Guide/Maven2 Plugins/index.html
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message