Mantis - Resin
Viewing Issue Advanced Details
1048 text always 04-12-06 04:48 04-14-06 10:16
keith  
ferg  
normal  
closed  
fixed  
none    
none 3.0.19  
0001048: Website EJB3 documentation inconsistent & mail lists not searchable
Please take this as constructive criticism, it should really help fellow resin newbies!

I found the EJB3.0 documentation a bit lacking, especially with regard to entity beans

This page:
http://www.caucho.com/resin-3.0/ejb3/cmp-table.xtp [^]

Has this section with links to entity bean examples which are broken:

START PAGE EXCERPT
See Also

See Basic tutorial for a complete single-table example.
See Many-to-one tutorial for basic relations.
END PAGE EXCERPT


Also its not really clear which versions of the EJB3 spec resin follow, it seems like it follows all of them :-)

@Inject seems to work but is no longer part of the spec, I found this in a tutorial

@Id(generate=AUTO) VS.
@Id(generate=GeneratorType.AUTO)

@JoinTable VS.
@AssociationTable

Also, something that took me ages to discover is that the 'Amber' link on the left of the documentation page contains way more info on EJB3 than the EJB3 link! and Amber is not mentioned in the EJB3 link! I just stumbled across!


I'm no EJB3 expert but some of the tutorials are making it extra hard due to these inconsistencies, especially if you mix it with non-caucho EJB3 tutorials (such as JBoss - which I'm running away from)

One more tip - the mailing lists hold a wealth of information but are not searchable. The forums are relatively quiet, I suggest closing integrating the mailing into the forums and then making the whole lot searchable.

Other than that I've very happy with resin, I may achieve my utopia of an EJB3 business and persistence layers with a thin PHP presentation layer!




Notes
(0001091)
ferg   
04-14-06 10:16   
3.0.19 is upgrading Amber to the most recent draft specification, so there are a good number of changes. The internal copy of the documentation has been upgraded as has the wiki. The main caucho website will be updated with the 3.0.19 release.