Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakartaee-examples-dev] [External] : Re: Volunteering for Jakarta Examples

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.

As far as I am aware, the most reliable way of reaching the official JavaDocs for a given release is through here:

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 ( - my web site) and the original here ( ).  (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.



On Fri, Jun 25, 2021 at 1:38 AM Ed Bratt <ed.bratt@xxxxxxxxxx> wrote:

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 application.

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.

-- Ed

On 6/24/2021 4:33 PM, Reza Rahman wrote:

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 about it?

Lastly, any contribution to Cargo Tracker is most welcome. Here are the current issues: I lead that project.

Reza Rahman
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 wrote:

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 (  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.

I've had a peek through the examples at and also at the cargo app. I have had a look at the issues for the examples project, but most content is getting on for over 2 years old.

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 know.

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 chime in!


Andy Gibson

jakartaee-examples-dev mailing list
To unsubscribe from this list, visit

jakartaee-examples-dev mailing list
To unsubscribe from this list, visit;!!ACWV5N9M2RV99hQ!fRzfk32o6m92LP3lD8vqgpxJO5ChvDqR5lsGrb58BIA-QMsRukYYjs4lL6OX-Ls$ 
jakartaee-examples-dev mailing list
To unsubscribe from this list, visit
jakartaee-examples-dev mailing list
To unsubscribe from this list, visit

Back to the top