- +

Creating beans from Torque objects creates a bridge between an environment which knows Torque and has access to a database, and another environment which dies not know anything about Torque and databases.

- +

For example, you might have a server using Torque, and a java client without database access where you want to use data supplied by - Torque, but do not want to include Torque in any way. + Torque, but do not want to include Torque in any way.

- +

If this is the case, you can create simple beans from Torque objects - in the server, send them over the network to your client, - manipulate them there, send them back over the network, + in the server, send them over the network to your client, + manipulate them there, send them back over the network, create Torque objects from the beans, and save the objects generated from the beans.

@@ -58,7 +58,7 @@ torque.generateBeans = true

- Then you just need to regenerate your object model to obtain an object model + Then you just need to regenerate your object model to obtain an object model with bean creation support enabled.

@@ -70,15 +70,15 @@ in the bean subpackage of your target package. E.g. in the bookstore example in the tutorial, the classes are generated in the com.kazmier.om package, so the beans will generated in the package com.kazmier.om.bean. - Each bean has getters and setters for all the properties defined - in the schema.xml. + Each bean has getters and setters for all the properties defined + in the schema.xml.

- Also, getters and setters for two boolean values, namely + Also, getters and setters for two boolean values, namely isNew(), setNew(), isModified() and setModified() are generated, which keep track of which changes have already made it into the - database. You should not normally need to use these. + database. You should not normally need to use these.

@@ -86,7 +86,7 @@

- If bean creation is enabled, every Torque object gets some + If bean creation is enabled, every Torque object gets some additional methods. E.g, the author class from the bookstore example in the tutorial gets the additional methods

@@ -103,13 +103,13 @@ - +

- If a bean is created from an object, the beans gets knowledge about + If a bean is created from an object, the beans gets knowledge about whether the object it was created from already exists in the database, - or whether it was changed after redaing it from the database + or whether it was changed after redaing it from the database (that is what the isNew() and isModified() methods are for). - So assuming we have at least one author stored in the database, + So assuming we have at least one author stored in the database, the following code works as expected

@@ -134,16 +134,16 @@

- + - +

- The bean creation process preserves object relations. + The bean creation process preserves object relations. Consider again the bookstore example from the tutorial: Each book has an author, and an author can have serveral books. - So if you have created an author-book relation, e.g. by + So if you have created an author-book relation, e.g. by

- + Author author = new Author(); // fill author data here @@ -154,19 +154,19 @@ AuthorBean authorBean = author.getBean();

- then the related bookBean is automatically created, + then the related bookBean is automatically created, and can be retrieved by

- + BookBean bookBean = (BookBean) authorBean.getBookBeans().get(0); - +

This is also true in the reverse direction. If you create an - author from this authorBean, the corresponding book can also + author from this authorBean, the corresponding book can also be retrieved:

- + Author authorFromBean = Author.createAuthor(authorBean); Book bookFromBean = (Book) author.getBooks().get(0); @@ -174,14 +174,14 @@

Note that only newly created or cached related objects are cosnidered in bean creation. - To elaborate that, consider the case where one author which is related + To elaborate that, consider the case where one author which is related to several books is stored in the database.

- +

The following code will NOT transfer the related books into the bean:

- + List authorList = AuthorPeer.doSelect(new Criteria()); Author author = (Author) authorList.get(0); @@ -189,11 +189,11 @@

This is because the related books are never read from the database, - and thus are not included in bean conversion. To include the - related books into the author bean, you have to assure that the + and thus are not included in bean conversion. To include the + related books into the author bean, you have to assure that the related books are read into memory. This can be done as follows:

- + List authorList = AuthorPeer.doSelect(new Criteria()); Author author = (Author) authorList.get(0); --------------------------------------------------------------------- To unsubscribe, e-mail: torque-dev-unsubscribe@db.apache.org For additional commands, e-mail: torque-dev-help@db.apache.org