doc: howto-create-entity tutorial updated for 2.0 usage Only one change, use Module instead of UnitOfWorkFactory. We could also reduce the number of files but some parts of the tutorial should then be rewritten.
Project: http://git-wip-us.apache.org/repos/asf/zest-qi4j/repo Commit: http://git-wip-us.apache.org/repos/asf/zest-qi4j/commit/e423ffc7 Tree: http://git-wip-us.apache.org/repos/asf/zest-qi4j/tree/e423ffc7 Diff: http://git-wip-us.apache.org/repos/asf/zest-qi4j/diff/e423ffc7 Branch: refs/heads/develop Commit: e423ffc73ae33287a729ceaf485bf7e00f4945ac Parents: 6ab86be Author: Paul Merlin <[email protected]> Authored: Fri Jan 23 11:38:56 2015 +0100 Committer: Paul Merlin <[email protected]> Committed: Fri Jan 23 11:38:56 2015 +0100 ---------------------------------------------------------------------- manual/src/docs/tutorials/howto-create-entity.txt | 8 ++++---- .../manual/recipes/createEntity/CarEntityFactoryMixin.java | 8 ++++---- 2 files changed, 8 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/e423ffc7/manual/src/docs/tutorials/howto-create-entity.txt ---------------------------------------------------------------------- diff --git a/manual/src/docs/tutorials/howto-create-entity.txt b/manual/src/docs/tutorials/howto-create-entity.txt index 11d8035..3541c1e 100644 --- a/manual/src/docs/tutorials/howto-create-entity.txt +++ b/manual/src/docs/tutorials/howto-create-entity.txt @@ -151,11 +151,11 @@ source=manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactor tag=carFactoryMixin1 ----------- -And doing that, first of all we need to request Qi4j runtime to give us the UnitOfWorkFactory associated with the Module +And doing that, first of all we need to request Qi4j runtime to give us the Module that our code belongs to, and the UnitOfWork current context the execution is happening in. Injections that are related to the Visibility rules are handled by the @Structure annotation. And the easiest way for us -to obtain a UnitOfWorkFactory is simply to; +to obtain a Module is simply to; [snippet,java] ----------- @@ -163,7 +163,7 @@ source=manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactor tag=carFactoryMixin2 ----------- -Here Qi4j will inject the member uowf with the correct UnitOfWorkFactory. In case we only need the UnitOfWorkFactory +Here Qi4j will inject the member module with the correct Module. In case we only need the Module during the construction, we can also request it in the same manner as constructor argument. [snippet,java] @@ -222,7 +222,7 @@ tag=assembler2 == The UnitOfWork == -If you notice, there is a couple of calls to UnitOfWorkFactory.currentUnitOfWork(), but what is current UnitOfWork, and +If you notice, there is a couple of calls to Module.currentUnitOfWork(), but what is current UnitOfWork, and who is setting that up? Well, the domain layer should not worry about UoW, it is probably the responsibility of the application/service layer http://git-wip-us.apache.org/repos/asf/zest-qi4j/blob/e423ffc7/manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactoryMixin.java ---------------------------------------------------------------------- diff --git a/manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactoryMixin.java b/manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactoryMixin.java index 6242339..a04c4a2 100644 --- a/manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactoryMixin.java +++ b/manual/src/main/java/org/qi4j/manual/recipes/createEntity/CarEntityFactoryMixin.java @@ -2,8 +2,8 @@ package org.qi4j.manual.recipes.createEntity; import org.qi4j.api.entity.EntityBuilder; import org.qi4j.api.injection.scope.Structure; +import org.qi4j.api.structure.Module; import org.qi4j.api.unitofwork.UnitOfWork; -import org.qi4j.api.unitofwork.UnitOfWorkFactory; // START SNIPPET: carFactoryMixin2 // START SNIPPET: carFactoryMixin1 @@ -13,10 +13,10 @@ public class CarEntityFactoryMixin // END SNIPPET: carFactoryMixin1 @Structure - UnitOfWorkFactory uowf; + Module module; // END SNIPPET: carFactoryMixin2 // START SNIPPET: carFactoryMixin3 - public CarEntityFactoryMixin( @Structure UnitOfWorkFactory uowf ) + public CarEntityFactoryMixin( @Structure Module module ) { } @@ -24,7 +24,7 @@ public class CarEntityFactoryMixin // START SNIPPET: createCar public Car create(Manufacturer manufacturer, String model) { - UnitOfWork uow = uowf.currentUnitOfWork(); + UnitOfWork uow = module.currentUnitOfWork(); EntityBuilder<Car> builder = uow.newEntityBuilder( Car.class ); Car prototype = builder.instance();
