Re: Work on Release 2.5: Maven Archetype and Tutorial Examples

Actually, it's 2.6 :-)

I didn't find time to fix the examples, I'll do that and move them to the Prevayler git; create the archetype and update the website, sometime next week.

I did however just released 2.6. The git repo is updated and targets should be available via Maven central <http://repo1.maven.org/maven2/org/prevayler/> within a few minutes, hours, days or so. Let's not "go public" until everything above is fixed.



		karl

10 jan 2013 kl. 04:24 skrev Klaus Wuestefeld:

> Karl, lets simply put the examples in Prevayler's test folder?
> 
> 
> On Thu, Jan 10, 2013 at 1:16 AM, Klaus Wuestefeld <[email protected]> wrote:
> Hi,
> 
> Below is a conversation I had with Karl Wettin, edited for brevity.
> 
> Klaus
> 
> 
> ----
> 
> Karl Wettin: i'll try to release 2.5 this weekend
> 
> Klaus Wuestefeld: Hi :)
> Klaus Wuestefeld: Whats in 2.5 again?
> 
> Karl Wettin: mainly Prevalyer<PrevalenceBase> and no food taster
> 
> Klaus Wuestefeld: ah nice
> 
> Karl Wettin: and I'll write something on the website how to set up using maven. perhaps even create an archetype that creates a maven project for you
> Karl Wettin: feel free to take a look at the examples i wrote in november if there is somehitng you think is missing, and if you want me to move it to the git.
> 
> Klaus Wuestefeld: maven archetype? how does that work?
> 
> Karl Wettin: https://github.com/karlwettin/prevayler-examples
> Karl Wettin: http://maven.apache.org/guides/introduction/introduction-to-archetypes.html
> Karl Wettin: basically you type
> mvn archetype-prevayler:generate
> Karl Wettin: and it will set up the project for you, create pom.xml, deps, directories, example code etc
> 
> Klaus Wuestefeld: Very nice!
> Klaus Wuestefeld: Im looking at the examples again now
> Klaus Wuestefeld: Why are they in the test folder? https://github.com/karlwettin/prevayler-examples/tree/master/src/test
> 
> Karl Wettin: because they are all demonstrated as unit tests with assertions etc
> Karl Wettin: but i'm listening if you have comments
> 
> Klaus Wuestefeld: Yes. I think it would be nice to have the examples in Prevayler's git
> Klaus Wuestefeld: Comments:
> Klaus Wuestefeld: e101 is too abstract
> Klaus Wuestefeld: People might think they have to use an "Entity" class or extend Entity or something like that.
> Klaus Wuestefeld: "Entity" is a kind of class you would expect in an implementation of a persistence framework. Not in app code. That will confuse people.
> Klaus Wuestefeld: Please take a look at 2.2 Storing Objects, for example: http://community.versant.com/Documentation/Reference/db4o-7.12/java/tutorial/
> Klaus Wuestefeld: 2) Lets make all tests pass, even the ones that "fail".
> Klaus Wuestefeld: With @Test(expected = Exception.class) //Note this test expects an exception
> Klaus Wuestefeld: Im talking about this: https://github.com/karlwettin/prevayler-examples/blob/master/src/test/java/org/prevayler/examples/e102/E102Test.java
> Klaus Wuestefeld: 3) Lets mention the possible sources of non-determinism: using new Date(), currenTimeMillis(), nanoTime(), hashCode(), etc.
> Klaus Wuestefeld: https://github.com/karlwettin/prevayler-examples/blob/master/src/test/java/org/prevayler/examples/e102/README.md
> Klaus Wuestefeld: I like the way you present each caveat as a test.
> Klaus Wuestefeld: 4) https://github.com/karlwettin/prevayler-examples/tree/master/src/test/java/org/prevayler/examples/e103
> Klaus Wuestefeld: "that your transactions shouldn't contain actual business objects, only their identities."
> Klaus Wuestefeld: "identities" is bad wording. Identity (as opposed to equality) often refers to the object itself. Lets change it to "...only a way to query for them, such as an id for example."
> Klaus Wuestefeld: preavlent -> prevalent
> Klaus Wuestefeld: "an aggregate of an business object to another business object" is too abstract. Lets choose a metaphor and run with it: "a pilot to a car", "a pet to the petstore", for example.
> Klaus Wuestefeld: Please, lets change the wording from "baptism problem" to "initiation problem". It's  more religion-neutral.
> Klaus Wuestefeld: user is baptised -> user is initiated
> 
> Karl Wettin: +1
> Karl Wettin: coming from a godless country and all, i've considered that before.
> 
> Klaus Wuestefeld: Is that the only comment you agree on? :D
> 
> Karl Wettin: hehe no, all great comments
> Karl Wettin: i'll fix them all
> 
> Klaus Wuestefeld: 5) On the sources of non determinism in E102 you can say: "See E104 on using timestamps"
> Klaus Wuestefeld: 6) E104: Not a caveat. It is a feature to help you cope with caveat E102 so you dont have to put your own timestamps in your transactions.
> Klaus Wuestefeld: 7) https://github.com/karlwettin/prevayler-examples/blob/master/src/test/java/org/prevayler/examples/e103/E103Test.java Do we need AbstractTest as a class? Cant it just be a method receiving the BaptismProblemUpdateEntityAggregate and UpdateEntityAggregate transaction objects?
> Klaus Wuestefeld: 8) https://github.com/karlwettin/prevayler-examples/tree/master/src/test/java/org/prevayler/examples "e102, Problems with non deterministic features in transactions."
> Klaus Wuestefeld: -> "e102, Problems with non deterministic features in business code."
> Klaus Wuestefeld: Same here: https://github.com/karlwettin/prevayler-examples/tree/master/src/test/java/org/prevayler/examples/e102
> Klaus Wuestefeld: 9) You can use assertSame()
> Klaus Wuestefeld: 10) finally: please delete E105. It is too alarming. In the end, it is the same as E101: You have to use transactions. Simply add a line of text to the description of E101: "If you change business objects directly without using transactions, those changes will not be persistent. You could, in theory, take a snapshot after every change but that is much slower."
> Klaus Wuestefeld: 11) Lets delete Prevayler demo1 (prime numbers) if it still exists.
> Klaus Wuestefeld: 12) Lets incorporate Prevayler demo2 (Bank Demo) in your examples project somehow, maybe in the main folder (instead of tests)
> Klaus Wuestefeld: 13) Lets remove javamatch from demo2 (Bank Demo) if we have not already done so.
> Klaus Wuestefeld: ------------------------------------------
> Klaus Wuestefeld: Very nice :)
> 
> ------------------------------------------------------------------------------
> Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS,
> MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current
> with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft
> MVPs and experts. ON SALE this month only -- learn more at:
> http://p.sf.net/sfu/learnmore_122712_______________________________________________
> To unsubscribe go to the end of this page: http://lists.sourceforge.net/lists/listinfo/prevayler-discussion
> _______________________________________________
> "Databases in Memoriam" -- http://www.prevayler.org

------------------------------------------------------------------------------
Master Visual Studio, SharePoint, SQL, ASP.NET, C# 2012, HTML5, CSS,
MVC, Windows 8 Apps, JavaScript and much more. Keep your skills current
with LearnDevNow - 3,200 step-by-step video tutorials by Microsoft
MVPs and experts. ON SALE this month only -- learn more at:
http://p.sf.net/sfu/learnmore_123012

_______________________________________________
To unsubscribe go to the end of this page: http://lists.sourceforge.net/lists/listinfo/prevayler-discussion
_______________________________________________
"Databases in Memoriam" -- http://www.prevayler.org