To be honest, these parts of Jakarta EE have not had any significant contribution for a while so anything is a positive step.
Personally I think not having an equivalent of the Spring Boot Getting Started Guides is hurting the cause of getting new Jakarta EE developers. The tutorial is basically the equivalent of the Spring Framework reference guide and First Cup is far too basic and really just an accompaniment of the tutorial.
On the other hand, there is definite merit to improving the usability of the examples in their current form and also merging the various confusing forks including the one Arun encouraged a few years ago.
It’s best to stick to Java SE versions the platform specification endorses. For Jakarta EE 8/9 that is Java SE 8. For Jakarta EE 9.1 it is Java SE 11. There is value to uniformly upgrading all the examples to Jakarta EE 9.1.
As far as I am aware, the official examples project has no particular preference for CDI vs EJB. I think either really depends on the use case. It is best to stick to specification defined behavior, which often means EJB is the most sensible path at the moment. That might change in Jakarta EE 10 or later when there is more of a focus to supersede EJB.
Happy to have a call once you get yourself orientated. It sounds like you will need a few weeks to do that still. There is certainly a lot to review so it is certainly understandable. Happy to answer questions here in the meantime.
On Jun 27, 2021, at 8:51 PM, Andy Gibson <contact@xxxxxxxxxxxxxx> wrote:
Thanks both for your thoughts. Ed, your points were interesting because I didn't know how the different examples fit together, or which were still relevant, which I guess is something that we should look at. Maybe a single page linking the different example options with a description. You may already have this, if so it's pretty well hidden :-), but it would be great if many of the jakarta projects could reference that page in their ReadMe. This would get some exposure to the examples and give developers the confidence that the links are still relevant and updated.
I did take the liberty of looking at the firstcup tutorial and despite being asciidoc, the end result doesn't have that typical asciidoc look or layout. I played around trying to get it looking how most asciidoc projects work, and how the jakarta tutorial project looks by basing it off the jakarta tutorial pom instead. You can see a working implementation of that here (http://www.andygibson.net/blog/firstcup/ - my web site) and the original here (https://eclipse-ee4j.github.io/jakartaee-firstcup/toc.html ). (disclaimer, I have not completely read the altered site so if there are big errors, I haven't found them yet) I think the new version looks much cleaner and it uses practically the same pom as the jakarta tutorial - opportunity for some code reuse there and creating a standard template for jakarta docs, maybe even some custom theming across the board later on. It would be nice to make a standard archetype of jakarta docs.
Quick questions -
What is the minimum version of Java that the examples should require? I know a lot of people are still on 1.8, but do we aim to use at least 11 or later?
Are we still looking to remove ejbs and rely mostly on CDI? Most of the JPA examples utilised an Ejb to do any work for example.
I did find it difficult to get examples running, partly because there are no instructions, and partly because just starting a server and dropping the war in there didn't work.
Is there an empirical reference to the Jakarta EE API Javadocs anywhere? If I wanted to provide a link to the @Column or @Inject annotations, is there somewhere I can point to that is semi-permanent?
I would be open to having a call to discuss, push it back a bit so I can get a better look around some more of the pieces before we talk.
I think there is always room for improvement in the EE examples
and sample code.
The collection of material is pretty extensive -- and it's
evolved over different time periods. Generally, one might start
with the "First
Cup" tutorial -- this just shows a user how to download and
start using Jakarta EE -- From there, a user might want to venture
into the Jakarta
EE Tutorial -- probably picking and choosing the sections or
technologies they have any interest in -- interspersed in these,
that user would want to be learning the details of their favorite
IDE, and their favorite EE Application Server (e.g. GlassFish
Samples and GlassFish product
documentation) -- From there, the EE
examples are intended to provide specific, targeted use
cases and as you've seen, they aren't showing much about a
cohesive, complete application. From there, (or perhaps at the
same time) something like CargoTracker
can be used to show a more complete and modern application -- and
there are other example applications can be used to illustrate how
to pull a multitude of EE technologies together into a non-trivial
The Java EE Samples (what became Jakarta EE Examples) project was
forked and became JavaEE Samples
several years ago and that fork has been evolved beyond what is
included here in the Jakarta EE collection. If these samples are
worth someone's time and effort to expand upon, we might want to
consider if there would be any benefit in trying to merge these
efforts back together. We could open a discussion with the
relevant parties, if you have any interest in pursuing this.
There's no need to stick with GlassFish, or with a particular IDE
-- and, it would be great if there was more diversity in these
documents but, this is what was inherited and the community hasn't
evolved the network of this material much.
As Reza said, we welcome your input.
I'd be happy to help you as well.
On 6/24/2021 4:33 PM, Reza Rahman
Welcome back to the ecosystem Andy!
I think the Jakarta EE Examples need a major overhaul to be far
more use-case driven much like the Spring Boot starters.
The current format has a certain use, but honestly it is more
helpful to people who are not really newcomers but want to see a
certain feature in action. That said, even that could use
serious help including better readmes and better index pages.
I am happy to brainstorm and contribute to this if you and
others are interested. Maybe we can schedule a call to talk
Jakarta EE Ambassador, Author, Blogger, Speaker
Please note views expressed here are my own as an individual
community member and do not reflect the views of my employer.
On 6/24/2021 7:15 PM, Andy Gibson
I'm a long time Java developer and would like to volunteer
some time to J2EE, or Jakarta EE as it is now. I thought I
might ease back into it with some work on examples and/or
docs. I've previously worked with JPA, CDI, and JSF mostly and
blogged quite a bit about it a few years ago (https://www.andygibson.net/blog/tag/java-ee/).
I've long been an advocate for J2EE and making it accessible
through those blog posts and I'd like to continue that by way
of contributing to the Jakarta projects themselves.
My first impressions would be that most of the examples are
minimalist, consisting of a couple of classes showing a
particular feature, which is OK, it shows people just the bits
they need to add to a class to get a feature working. There
isn't much accompanying documentation to describe what that
feature does or how it can be used. I noticed there is an
issue #8 to Describe the JPA examples which might be a good
place to start. Most of those issues don't have much info in
them so if anyone has thoughts on what they should do, let me
I'm also wondered whether there is interest in another larger
application which showcases the more modern features of JEE
and Java. It could include documenting the features showing
why they are used as well as how. I'm looking for a bit of a
project to take on, and that might fit the bill, but for now,
I can start by working with some of the existing examples or
writing any missing one.
If you have any thoughts or ideas on where to start, please
_______________________________________________ jakartaee-examples-dev mailing list jakartaee-examples-dev@xxxxxxxxxxx To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/jakartaee-examples-dev