geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Prasad Kashyap" <goyathlay.geron...@gmail.com>
Subject New Samples Framework for Geronimo.
Date Fri, 19 Jan 2007 17:22:17 GMT
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.

Mime
View raw message