The following items are being worked for a Samples 2.1 release.
This is the first release of samples. Therefore, there are several issues/questions that must be addressed. What follows is a list of questions/issues and actions/statements regarding how we will proceed.
How often will samples be released?
We will release samples for each major Geronimo release. If possible, we will work to ensure that samples released for a major release (such as 2.1) will continue to work with subsequent minor releases (such as 2.1.1). However, if this cannot be achieved then we will release samples for each minor release as well.
How will samples be versioned?
The version of the released samples will match the intended major Geronimo release version.
Will all samples follow the archetype?
No. While the archetype is convenient to create new samples the structure of the samples that are created can be confusing at times if it is a web only application. This is because the archetype assumes it will create an enterprise application and always creates an ear structure. Where appropriate the archetype ear structure will be followed but for web only applications only a web structure will be released.
Should Jetty samples pre-req Jetty and Tomcat samples pre-req Tomcat?
This was initially the case. However, this was changed so that the plugins could be installed in a framework server without the jetty or tomcat prereq being present (the integration tests in trunk currently require this). There was opposition to restoring the defaults because it was thought a common mechnism to run the samples would be in the *-jetty/target directories.
Should we move the samples back into the server to ensure that they are released concurrently?
There was opposition to this suggestion. The primary argument seemed to be that the samples can be released independently and therefore should be released independently to demonstrate the plugin nature of Geronimo and avoid huge releases.
General Sample work items:
item |
person |
status |
---|---|---|
Upgrade to genesis 1.4 |
Joe Bohn |
|
Update legal files - validate headers |
Joe Bohn |
|
Remove async-http |
Joe Bohn |
|
Remove snapshot references |
Joe Bohn |
|
Make archetype work for plugins |
Joe Bohn |
|
Plugins for all samples |
Jarek Gawor |
|
Common datasource plugin |
David Jencks |
|
standardize naming conventions |
David Jencks |
|
eliminate unneeded ears |
David Jencks |
|
reformat code |
David Jencks |
|
eliminate table collision in samples |
Joe Bohn |
|
Individual Sample Status (please initial each status item):
Several folks have worked on various samples. The initial results below (JAB-init) reflect an initial, point in time status by Joe Bohn on 6/11. If you worked on one or more of these samples and validated them please update the respective fields indicating that you updated the sample/doc and that you verified it on the tomcat and jetty (removing my initials below where appropriate).
Sample |
Update Sample |
Validated in Jetty |
Validated in Tomcat |
Updated Doc |
issues/concerns |
---|---|---|---|---|---|
app-per-port - Running multiple web apps on different ports |
|
n/a |
JAB-init |
|
|
bank - EJB sample application |
|
JAB-init |
JAB-init |
|
|
calculator=stateless-pojo - Using EJB 3.0 functions |
|
JAB-init |
JAB-init |
|
|
dbtester - DB Pool Testing Sample application |
|
JAB-init |
JAB-init |
|
|
inventory - Simple Database Access Application |
|
JAB-init |
JAB-init |
|
|
jaxws-calculator - Simple Web Service 2. JAX-WS |
|
JAB-init |
JAB-init |
|
errors on jetty deploy and run |
jms-mdb-sample - JMS and MDB Sample Application |
|
JAB-init |
JAB-init |
|
|
ldap-sample-app - LDAP Sample Application |
|
JAB-init |
JAB-init |
|
|
myphonebook - Very Simple Entity EJB Example |
|
JAB-init |
JAB-init |
|
|
mytime - Very Simple Session EJB Example |
|
JAB-init |
JAB-init |
|
|
sendmail - Using Geronimo Default JavaMail Session |
|
JAB-init |
JAB-init |
|
|
timereport - Web Application Security Sample |
|
JAB-init |
JAB-init |
|
|
customer-service - JNDI example |
|
|
|
|
currently moved under questionable |
jsp-examples |
|
JAB-init |
JAB-init |
n/a |
view source has issues |
servlet-examples |
|
JAB-init |
JAB-init |
n/a |
view source has issues |