Documentation

[LievenDoclo]

Recently, in the poll, the issue about the lack of documentation has been raised again. Since I was sick and tired of hearing the same thing over and over again, I decided to start writing...

Attached is a draft for a practical guide into Spring RCP. If some of you would be so kind to read the guide and give some comments, that would be great. The purpose of the document is to enable developers to start with RCP with at least a bit of a lifeline. There are still some point that need to be filled in or extended, but it gives you an idea of what it encompasses.

You can find the document here:

http://www.doclo.be/lieven/SpringRichClient.pdf

Cheers

Lieven

[Saboutai]

Great work.

I hope u will keep it up, since documentation prevents a lot of users from using RCP (but you already know that ).

[LievenDoclo]

Updated with an extra example for application windows with multiple toolbars

[Gergo]

Updated with an extra example for application windows with multiple toolbars

Hi,

Great! Thanks for spending your time with writing it!

As i see at the bottom of page 14 the CustomApplicationLifecycleAdvisor example can be seen twice and the creation of the application window is missing.

Anyway i keep up reading!

/Gergo

[LievenDoclo]

I've updated the document to take your remarks into account. The example should now be complete.

As for the rest of the document, are there other topics you'd like to see explained, or elaborations on the existing topics?

[Saboutai]

If it's possible i'd like a cross-field validation example included in the tutorial (usage of the abstractbinaryConstraint).

For my application i need to validate that if the a person's age is below 21 another field is optional otherwise it's required.

Also since i have 3 fields that need cross validation i created a multiplePropertiesConstraint where i can cross validate as many properties as i'd like.

Perhaps this is something you could include in the framework?

[LievenDoclo]

You can already do this out of the box, there is a class named RequiredIfTrue, which accepts a property and another propertyconstraint.

[Saboutai]

Aha didn't knew that. I'll adjust my code.

But i do believe, that this is something that should be in the manual.

Anyhow, thx for the pointer.

[LievenDoclo]

You're welcome, I've added an example to the "Dependent properties" section to show the usage of the RequiredIfTrue constraint. Haven't updated the documentation file on the site yet, will do that if some more new content is in there.

[Gergo]

Hi,

I had/have problems understanding the differeces between the ActionCommand and the commandExecutors. You may remember that i was not able to put the ExitCommand on to the toolbar. :-)

Other things i am working on. I would like to make a binding class for a template class ie. List<Person>, how can i add it to the constructor of CustomBinding?
(I would like to pass List<Person> as parameter to CustomBinding)


I guess it is not really Spring specific, but who knows. If somebody know the answer, please let me know.

Yes, i already made a Dummy class PersonList extends List<Person>. but then JPA complains that i can not annotate a member with OneToMany which is not really a Collection.

/Gergo