tag	60b3ae9cabd3338c9d54d76baa8076464574e155
tagger	Nikita Timofeev <stariy95@gmail.com>	Wed Jul 11 17:30:19 2018 +0300
object	58eb3c3654c88dbb113dc92ebfff141c16160643

commit	58eb3c3654c88dbb113dc92ebfff141c16160643	[log] [tgz]
author	Nikita Timofeev <stariy95@gmail.com>	Wed Jul 11 17:30:13 2018 +0300
committer	Nikita Timofeev <stariy95@gmail.com>	Wed Jul 11 17:30:13 2018 +0300
tree	79ec30f83c4b77766e8fcc815c4fd120fb9051b0
parent	327eadc7d9f27dbb5034f01d7f5b6dc9f1e148b5 [diff]

tree: 79ec30f83c4b77766e8fcc815c4fd120fb9051b0

README.md

Apache Cayenne

Apache Cayenne is an open source persistence framework licensed under the Apache License, providing object-relational mapping (ORM) and remoting services.

Quick Start

Modeler GUI application

To create Cayenne project you will need Cayenne Modeler. You can download it from https://cayenne.apache.org/download/

See tutorial https://cayenne.apache.org/docs/4.0/getting-started-guide/

Include Cayenne into project

Maven

<dependencies>
    <dependency>
        <groupId>org.apache.cayenne</groupId>
        <artifactId>cayenne-server</artifactId>
        <version>4.0.RC1</version>
    </dependency>
    <dependency>
        <groupId>org.apache.cayenne</groupId>
        <artifactId>cayenne-java8</artifactId>
        <version>4.0.RC1</version>
    </dependency>
</dependencies>

Gradle

compile group: 'org.apache.cayenne', name: 'cayenne-server', version: '4.0.RC1'
compile group: 'org.apache.cayenne', name: 'cayenne-java8', version: '4.0.RC1'

Create Cayenne Runtime

ServerRuntime cayenneRuntime = ServerRuntime.builder()
    .addConfig("cayenne-project.xml")
    .build();

Create New Objects

ObjectContext context = cayenneRuntime.newContext();

Artist picasso = context.newObject(Artist.class);
picasso.setName("Pablo Picasso");
picasso.setDateOfBirth(LocalDate.of(1881, 10, 25));

Painting girl = context.newObject(Painting.class);
girl.setName("Girl Reading at a Table");
girl.setArtist(picasso);

context.commitChanges();

Select Objects

// Single object select with order
Artist artist = ObjectSelect.query(Artist.class)
        .orderBy(Artist.NAME.asc())
        .selectFirst(context);

// Select with join
List<Painting> paintings = ObjectSelect.query(Painting.class)
        .where(Painting.ARTIST.dot(Artist.DATE_OF_BIRTH).lt(LocalDate.of(1900, 1, 1)))
        .select(context);

// Select count
long count = ObjectSelect.query(Painting.class)
        .where(Painting.ESTIMATED_PRICE.gt(10000))
        .selectCount(context);

Documentation

About

With a wealth of unique and powerful features, Cayenne can address a wide range of persistence needs. Cayenne seamlessly binds one or more database schemas directly to Java objects, managing atomic commit and rollbacks, SQL generation, joins, sequences, and more. With Cayenne's Remote Object Persistence, those Java objects can even be persisted out to clients via Web Services.

Cayenne is designed to be easy to use, without sacrificing flexibility or design. To that end, Cayenne supports database reverse engineering and generation, as well as a Velocity-based class generation engine. All of these functions can be controlled directly through the CayenneModeler, a fully functional GUI tool. No cryptic XML or annotation based configuration is required! An entire database schema can be mapped directly to Java objects within minutes, all from the comfort of the GUI-based CayenneModeler.

Cayenne supports numerous other features, including caching, a complete object query syntax, relationship pre-fetching, on-demand object and relationship faulting, object inheritance, database auto-detection, and generic persisted objects. Most importantly, Cayenne can scale up or down to virtually any project size. With a mature, 100% open source framework, an energetic user community, and a track record of solid performance in high-volume environments, Cayenne is an exceptional choice for persistence services.

License

Cayenne is available as free and open source under the Apache License, Version 2.0.