Very nice...I like the idea of standalone samples. Without getting
into the specs debate yet again ... but most likely will ... I like
the samples released with the version of the server so people can
pick up one version and know what its for. I think the organization
for now is great as we can get the actual work done on the samples
while we debate how to organize them for the next several months.
Good job ! :)
On Jan 19, 2007, at 12:22 PM, Prasad Kashyap wrote:
Encouraged by your kind words of appreciation for the Testsuite
framework, I put together a similar Samples Framework.
http://svn.apache.org/viewvc/geronimo/samples/
UseCase Scenario 1
-------------------------------
Actor: Geronimo user, JEE5 Developer.
Requirements:
* Actor wants to learn the new features of JEE5 by looking at
sample code
* He wants to play with sample code.
* He wants to learn how to develop applications on Geronimo.
* He may want to use the sample code as a template for his own
application.
Flow A (install downloaded sample binary)
* Actor downloads a Geronimo server binary and unpacks it.
* He then downloads a sample binary.
* He starts Geronimo server.
* He then deploys the sample artifact into running server.
* He goes to the sample app's home page (context-root).
Flow B: (build sample source and install)
* Actor downloads a sample source package.
* He installs Maven if he doesn't have it already.
* He builds the sample project using maven.
* Sample project automatically downloads the latest Geronimo
server, starts it, and deploys the newly built sample.
* It fires up a browser and brings up the sample home page (not
implemented yet).
See the following links in Firefox only !
Here is a page that gives a user instructions on working with samples.
Every sample download will also have a customized & relevant page like
this, say as a README.html
http://people.apache.org/~prasad/samples/index.html
Here is a sample sample page. Notice the javadoc and source tabs in
the top right corner of the page.
http://people.apache.org/~prasad/samples/sample.html
UseCase Scenario 2
-------------------------------
Actor: Geronimo Developer, JEE5 Spec Implementor
Interactions: Document Writer.
Requirements:
* Actor wants to create sample projects quickly without having to
deal too much with Maven.
Flow:
* Actor executes a sample-archetype-plugin.
* It creates a mvn project which will act as a template.
* He only has to write JEE5 code for the sample application.
* He then works with Document Writer to write the sample document.
Cheers
Prasad.
Matt Hogstrom
[EMAIL PROTECTED]
