[jboss-dev-forums] [Design of Messaging on JBoss (Messaging/JBoss)] - Re: JBM 2.0 examples

[timfox]

Howard - good start...

Some initial comments:

1) Can you add them to the eclipse project (I assume you use eclipse) so we can browse them?

2) Each example needs a readme, structured in a standard way. We should create a template for this.

Each readme.html should be formatted and written as simply and clearly as possible on a single page if possible.

I suggest the following sections:

a) Name of example

b) Short description of example, e.g. This example demonstrates usage of a JMS durable subscription. Durable subscriptions are used when you wish to persist... blah blah blah. In this example you will create a durable subscription, send some messages to, consume some mesages, then close the subscriber, more messages will be sent when the subscriber is not connected, demonstrating the durable subscription's ability to collect messages when there is no subscriber. Then we demonstrate the subscriber reconnecting, and finally deleting the durable subscription. etc
(btw don't copy the above it was just an illustration)

c) Step by step of example

step 1, first we create the durable subscription, blah blah

step 2, now we send some messages

etc

each step should correspond to comments in the source code with the same step numbers.

There should also be more comments in the source.

Also the transactional example doesn't really demonstrate transactions - it just sends and consumes a single message so transactions are of no use. For a transaction example you should be sending multiple messages and stressing the point that the unit is atomic, also demonstrating rollback and how redelivery occurs on rollback.

View the original post : http://www.jboss.org/index.html?module=bb&op=viewtopic&p=4222226#4222226

Reply to the post : http://www.jboss.org/index.html?module=bb&op=posting&mode=reply&p=4222226