summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorMarko Gronroos <magi@vaadin.com>2016-06-09 16:31:28 +0300
committerMarko Grönroos <magi@vaadin.com>2016-06-10 10:25:08 +0000
commitbf4ad03b203a6957ab10bd98ec1ac4e0d50b660a (patch)
treefb93776536b7cc506977948f818a0ed22fdffcf1 /documentation
parent039b39dc6891afc0e08932f5f7d6f643b78595b2 (diff)
downloadvaadin-framework-bf4ad03b203a6957ab10bd98ec1ac4e0d50b660a.tar.gz
vaadin-framework-bf4ad03b203a6957ab10bd98ec1ac4e0d50b660a.zip
Added a note to JPAContainer chapter that it is no longer recommended.
Change-Id: I4fcc1af9916fa84523531d7886812e3a6d2af0fc
Diffstat (limited to 'documentation')
-rw-r--r--documentation/jpacontainer/jpacontainer-overview.asciidoc11
1 files changed, 6 insertions, 5 deletions
diff --git a/documentation/jpacontainer/jpacontainer-overview.asciidoc b/documentation/jpacontainer/jpacontainer-overview.asciidoc
index a622c0509d..44f33b5a09 100644
--- a/documentation/jpacontainer/jpacontainer-overview.asciidoc
+++ b/documentation/jpacontainer/jpacontainer-overview.asciidoc
@@ -7,6 +7,12 @@ layout: page
[[jpacontainer.overview]]
= Overview
+NOTE: Using JPAContainer is no longer recommended.
+While it works for simple data models, it is not as easy to use as it should be.
+It also has architectural weaknesses and performance issues that cause problems in building more complex applications.
+Instead, we recommend using JPA directly, while hiding it from your UI logic behind a DAO or service class.
+In UI code, you should mainly handle beans and collections of beans, bound to a [classname]#BeanItemContainer#. You should also note the https://vaadin.com/directory#!addon/viritin[Viritin] add-on, which provides data binding features that help with JPA.
+
Vaadin JPAContainer add-on makes it possible to bind user interface components
to a database easily using the Java Persistence API (JPA). It is an
implementation of the [interfacename]#Container# interface described in
@@ -116,8 +122,3 @@ following documentation about JPAContainer:
* JPAContainer AddressBook Demo
* JPAContainer Demo
-
-
-
-
-