[CONF] Apache Cayenne Documentation > Tutorial

[confluence]

Tutorial Page edited by Andrus Adamchik Changes (2) {note}There's no Cayenne 3.1 tutorial yet, as 3.1 is still under active development. You may want to check [a tutorial for Cayenne 3.0|CAYDOC30:Tutorial] instead.{note} h2. Tutorial This is a step-by-step tutorial showing how to write a database application with Cayenne. When you are done with it, you should have an understanding of the basics of object-relational mapping using CayenneModeler and how to use the Cayenne framework in standalone (command-line or otherwise) and web applications. The tutorial uses Maven, Eclipse IDE and Derby database, however it can be easily recreated with another combination of a database, an IDE and a build system. Full tutorial source code in a form of Eclipse project is distributed with Cayenne (see {{"tutorials/tutorial"}} folder). {note:title=Note about Maven}The only potentially controversial choice here is Maven. Not everybody is familiar with Maven, and not everybody likes it. However we decided that the benefits of the setup simplicity outweigh any downsides. Note that the tutorial is using {{m2eclipse}} plugin and doesn't even require a command-line Maven installation. Moreover most of the useful Cayenne Maven hackery is presented in boxed inserts throughout the text, while a Maven-agnostic alternative is shown in the main text.{note} h3. Sections {excerpt} # [Setting up the environment...|Tutorial Setup] # Learning mapping basics ## [Starting a project...|Tutorial Starting Project] ## [Getting started with Object Relational Mapping (ORM)...|Tutorial Object Relational Mapping] ## [Creating Java classes...|Tutorial Java Classes] # Learning Cayenne API ## [Getting started with ObjectContext...|Tutorial ObjectContext] ## [Getting started with persistent objects...|Tutorial Persistent Objects] ## [Selecting objects...|Tutorial SelectQuery] ## [Deleting objects...|Tutorial Delete] # [Converting to web application...|Tutorial Webapp] {excerpt} Full Content Tutorial This is a step-by-step tutorial showing how to write a database application with Cayenne. When you are done with it, you should have an understanding of the basics of object-relational mapping using CayenneModeler and how to use the Cayenne framework in standalone (command-line or otherwise) and web applications. The tutorial uses Maven, Eclipse IDE and Derby database, however it can be easily recreated with another combination of a database, an IDE and a build system. Full tutorial source code in a form of Eclipse project is distributed with Cayenne (see "tutorials/tutorial" folder). Note about Maven The only potentially controversial choice here is Maven. Not everybody is familiar with Maven, and not everybody likes it. However we decided that the benefits of the setup simplicity outweigh any downsides. Note that the tutorial is using m2eclipse plugin and doesn't even require a command-line Maven installation. Moreover most of the useful Cayenne Maven hackery is presented in boxed inserts throughout the text, while a Maven-agnostic alternative is shown in the main text. Sections Setting up the environment... Learning mapping basics Starting a project... Getting started with Object Relational Mapping (ORM)... Creating Java classes... Learning Cayenne API Getting started with ObjectContext... Getting started with persistent objects... Selecting objects... Deleting objects... Converting to web application... Change Notification Preferences View Online | View Changes | Add Comment