Return-Path: X-Original-To: apmail-cayenne-commits-archive@www.apache.org Delivered-To: apmail-cayenne-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 7CCB0D105 for ; Tue, 30 Oct 2012 05:44:27 +0000 (UTC) Received: (qmail 62543 invoked by uid 500); 30 Oct 2012 05:44:27 -0000 Delivered-To: apmail-cayenne-commits-archive@cayenne.apache.org Received: (qmail 62479 invoked by uid 500); 30 Oct 2012 05:44:26 -0000 Mailing-List: contact commits-help@cayenne.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cayenne.apache.org Delivered-To: mailing list commits@cayenne.apache.org Received: (qmail 62469 invoked by uid 99); 30 Oct 2012 05:44:26 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 30 Oct 2012 05:44:26 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 30 Oct 2012 05:44:00 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id B2AF32388B1B for ; Tue, 30 Oct 2012 05:42:50 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1403615 [6/48] - in /cayenne/site/cms/trunk/content: doc12/ doc20/ doc30/ Date: Tue, 30 Oct 2012 05:42:23 -0000 To: commits@cayenne.apache.org From: amaniatis@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20121030054250.B2AF32388B1B@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: cayenne/site/cms/trunk/content/doc12/documentation.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/documentation.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/documentation.html (original) +++ cayenne/site/cms/trunk/content/doc12/documentation.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » Documentation - - - -Apache Cayenne » Documentation - - - - - - - - - -
- - - -
- - - -
- -
-

Cayenne Documentation - v. 1.2 (STABLE)

-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/dvmodeler-gui-tool.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/dvmodeler-gui-tool.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/dvmodeler-gui-tool.html (original) +++ cayenne/site/cms/trunk/content/doc12/dvmodeler-gui-tool.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » DVModeler GUI Tool - - - -Apache Cayenne » DVModeler GUI Tool - - - - - - - - - -
- - - -
- - - -
- -
-

DVModeler is a Java GUI tool to work with DataViews configuration included in Cayenne projects. Steps needed to start DVModeler are similar to that of CayenneModeler. Main class is org.objectstyle.cayenne.dataview.dvmodeler.Main. For convenience Cayenne distribution provides run scripts to start DVModeler on Windows and UNIX platforms. To take advantage of these scripts, user must set CAYENNE_HOME (optional) and JAVA_HOME environment variables as described in Installation.

@@ -111,21 +16,3 @@ 
$CAYENNE_HOME/bin/dvmodeler.sh
-
- -
- -
- - - - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/entityresolver.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/entityresolver.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/entityresolver.html (original) +++ cayenne/site/cms/trunk/content/doc12/entityresolver.html Tue Oct 30 05:42:06 2012 @@ -1,120 +1,7 @@ +Title: Apache Cayenne » EntityResolver - - - -Apache Cayenne » EntityResolver - - - - - - - - - -
- - - -
- - - -
- -
-

In runtime the mapping metadata is accessed via a DataChannel in a form of org.objectstyle.cayenne.map.EntityResolver (EntityResolver available via ObjectContext is usually obtained from the channel behind the scenes). EntityResolver provides a single namespace for multiple DataMaps.

Another important function of the EntityResolver is providing access to the org.objectstyle.cayenne.property.ClassDescriptor instances for each persistent entity. Those a compiled by Cayenne on the fly using EntityResolver's org.objectstyle.cayenne.property.ClassDescriptorFactory.

-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/event-package.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/event-package.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/event-package.html (original) +++ cayenne/site/cms/trunk/content/doc12/event-package.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » Event Package - - - -Apache Cayenne » Event Package - - - - - - - - - -
- - - -
- - - -
- -
-

Cayenne includes a full-featured events mechanism. It allows creation of local and distributed event queues. It is very powerful and generic; it is not tied to Cayenne persistence features in any way and can be used in any application. The most important features are:

@@ -110,21 +15,3 @@
The most common error when using EventSubject is not storing a reference to it. This may result in a premature cleanup of a given subject, and automatic unregistering of all listeners. Good practice is to make subject a "public static final" variable of the event sender class if a subject is common for all instances of senders; or make it an ivar of a sender instance if subject is only related to this instance.
-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/executing-a-stored-procedure.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/executing-a-stored-procedure.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/executing-a-stored-procedure.html (original) +++ cayenne/site/cms/trunk/content/doc12/executing-a-stored-procedure.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » Executing a Stored Procedure - - - -Apache Cayenne » Executing a Stored Procedure - - - - - - - - - -
- - - - -
- -
- -
- - - - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/expression-factory-utilities.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/expression-factory-utilities.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/expression-factory-utilities.html (original) +++ cayenne/site/cms/trunk/content/doc12/expression-factory-utilities.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » Expression Factory Utilities - - - -Apache Cayenne » Expression Factory Utilities - - - - - - - - - -
- - - -
- - - -
- -
-

Sometimes there is a need to build an expression by combining other existing expressions. Also quiet often it is desirable to use strongly typed API instead of interpreted string expressions. The following sections describe ExpressionFactory and Expression methods that allow to construct expressions step by step via API calls.

@@ -190,21 +95,3 @@ SelectQuery select = Copyright © 2001-2010 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. Privacy policy.

-
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/expressions.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/expressions.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/expressions.html (original) +++ cayenne/site/cms/trunk/content/doc12/expressions.html Tue Oct 30 05:42:06 2012 @@ -1,121 +1,8 @@ +Title: Apache Cayenne » Expressions - - - -Apache Cayenne » Expressions - - - - - - - - - -
- - - -
- - - -
- -
-

Cayenne defines a simple yet powerful object-based expression language. Cayenne expressions are database independent and are used as query qualifiers and orderings and also to perform in-memory evaluation with DataObjects (and generally any kind of Java Beans). BNF of Cayenne expression language is described here.

Expressions are broadly divided into the following categories: object property expressions (also called "path expressions"), arithmetic operations, and conditional expressions. Cayenne contains a parser to build expressions from strings, and also features explicit expression API. Various ways of creating and using expressions are described later in this chapter.

-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/extended-types.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/extended-types.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/extended-types.html (original) +++ cayenne/site/cms/trunk/content/doc12/extended-types.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » Extended Types - - - -Apache Cayenne » Extended Types - - - - - - - - - -
- - - -
- - - -
- -
-

JDBC specification defines a set of "standard" database column types (defined in java.sql.Types class) and a very specific mapping of these types to Java Object Types, such as java.lang.String, java.math.BigDecimal, etc. Sometimes there is a need to use a custom Java type not known to JDBC driver. CayenneModeler allows to configure an arbitrary Java class as an ObjAttribute type by simply entering a fully-qualified name such class in the type column of an ObjAttribute. However there is more to it than just that. Cayenne needs to know how to instantiate this type from a database "primitive" value, and conversly, how to transform an object of the custom type to a JDBC-compatible object.

@@ -118,21 +23,3 @@ DataNode node = domain.getNode(DbAdapters and Extended Types

As shown in the example above, ExtendedTypes are stored by DbAdapter. In fact DbAdapters often install their own extended types to address incompatibilities, incompletness and differences between JDBC drivers in handling "standard" JDBC types. For instance some drivers support reading large character columns (CLOB) as java.sql.Clob, but some other - as "character stream", etc. Adapters provided with Cayenne override configureExtendedTypes() method to install their own types, possibly substituting Cayenne defaults. Custom DbAdapters can use the same technique.

-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/flattened-relationships.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/flattened-relationships.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/flattened-relationships.html (original) +++ cayenne/site/cms/trunk/content/doc12/flattened-relationships.html Tue Oct 30 05:42:06 2012 @@ -1,119 +1,6 @@ +Title: Apache Cayenne » Flattened Relationships - - - -Apache Cayenne » Flattened Relationships - - - - - - - - - -
- - - -
- - - -
- -
-

Flattened relationships represent relationship between two types of DataObjects that is not direct in the underlying relational storage. Instead it is mapped across one or more "join" tables. Still from the application point of view there is no diffrence in working with flattened relationships compared to the "normal" ones. Cayenne internally figures out how to build the needed query joins to retrieve related objects. On adding or removing an object to/from a flattened relationship via a corresponding "addTo..." / "removeFrom..." method an appropriate join record is created or removed.

Flattened Relationships Limitations
Currently only many-to-many flattened relatationships with a single join table can be modified. All other types of flattened relationships can be used as "read-only". This is reflected in the DataObject code generated for such relationships - no set/addTo/RemoveFrom methods are created for read-only relationships.
-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/general-navigation.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/general-navigation.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/general-navigation.html (original) +++ cayenne/site/cms/trunk/content/doc12/general-navigation.html Tue Oct 30 05:42:06 2012 @@ -1,100 +1,5 @@ +Title: Apache Cayenne » General Navigation - - - -Apache Cayenne » General Navigation - - - - - - - - - -
- - - -
- - - -
- -
-

General Navigation

@@ -147,21 +52,3 @@
Query:

Cayenne allows to store queries in the DataMap. There are three types of Cayenne queries that can be created in the Modeler - object select query, raw SQL query, and procedure query.

-
- -
- -
- -
- - - - \ No newline at end of file Modified: cayenne/site/cms/trunk/content/doc12/general-preferences.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/doc12/general-preferences.html?rev=1403615&r1=1403614&r2=1403615&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/doc12/general-preferences.html (original) +++ cayenne/site/cms/trunk/content/doc12/general-preferences.html Tue Oct 30 05:42:06 2012 @@ -1,120 +1,7 @@ +Title: Apache Cayenne » General Preferences - - - -Apache Cayenne » General Preferences - - - - - - - - - -
- - - -
- - - -
- -
-

General Preferences

"General Preferences" panel currently supports configuration of a single parameter - "Preferences Save Interval". This parameter determines how often should the Modeler commit preference values that it collects automatically during normal operation (e.g. main window or panel sizes, etc.). Don't set this to a small value as this may sometimes degrade Modeler performance.

-
- -
- -
- -
- - - - \ No newline at end of file