Thursday Feb 23, 2012

Java EE articles on OTN in 2011

2011 has been, with no doubt, a superb year for Java EE and there is no shortage of quality content for anyone interested in the latest version of the platform.

Here's a set of articles published by Oracle on OTN, the Java Magazine, and on java.net :

ALT_DESCR

Clustering GlassFish Version 3.1 (java.net)
Using Adobe Flex and JavaFX with JavaServer Faces 2.0 (otn/java)
Contexts and Dependency Injection in Java EE 6 (otn/java)
Introduction de RESTful Web Services (Java Magazine)
Templating with JSF 2.0 Facelets (otn/java)
Unit Testing for Java EE (otn/java)
Spring to Java EE Migration, Part 1 (otn/java)
Working with the XML Parser API — JSR 172 (otn/java)
New JavaServer Faces 2.2 Feature: The viewAction Component (otn/java)
Spring to Java EE Migration, Part 2 (otn/java)
Using Adobe Flex and JavaFX with JavaServer Faces 2.0 (Java Magazine)
Resource Injection with Java EE 6 (Java Magazine)
Stress Testing Java EE 6 Applications (Java Magazine)
Security and Performance Tuning of a REST and Ajax Application (otn/java)

Wednesday Jan 12, 2011

One more move : docs.sun.com

ALT DESCR

The entire docs.sun.com content is being moved to Oracle systems (download.oracle.com) before it is eventually shut down. This is another consolidation move to standardize on Oracle practices and systems and remove any duplication.

The content on docs.sun.com (DSC) was converted in December to the new format and has now been republished to the new home (Oracle GlassFish Server 3.0.1 documentation is here). The DSC site is scheduled to be shut down and a redirect put in place on January 14th is now operational.

All Sun-originated products have always been well documented and in the case of GlassFish 3.0.1, that's more than 30 different guides, ranging from the Installation Guide to the Application Development Guide or the Troubleshooting Guide.

Complete GlassFish 3.1 documentation will be posted when the product releases next month in PDF format for GlassFish Open Source Edition, and a choice of HTML and PDF for Oracle GlassFish Server. If you're looking for older Application Server-related documentation, check out this landing page.

Saturday Jan 24, 2009

Where to Look for GlassFish Documentation

Sun provides formal documentation on the GlassFish server but, with all the different versions, it may be hard to find the right document set. Some help is in BigAdmin's recent Locating Application Server Downloads and Documentation which includes a very comprehensive table that covers documentation and downloads - although GFv2.1 is not yet there.

ALT DESCR

The above article covers the formal docs but there is also a lot of other informal information (blogs, screencasts, webinars, wikis, etc). This information can be hard to discover and navigate we have talked about creating a master entry point; it would work at a kind of a master "Library"... but hopefully less scary than the Silent Library :-)

Wednesday Dec 03, 2008

The New Docs.Sun.Com

ALT DESCR

Docs.sun.com has been around for a long time and its look-and-feel had not been updated significantly for a bit. But today it sports a New Look and it looks very good! Check these out:

GFv2, GFv2 U1/U2, GFv3 Prelude
Portal 7.2, JavaCAPS, MQ, and much more
• Nice dynamic browsing and improved searching.
• Localized in 12 languages!

Very nice! I would only want to have the ability to annotate the documents, otherwise, this looks very good!

Added - Also check out Susan's Overview of the changes.

Thursday Oct 09, 2008

... JRuby Frameworks, GFv3 Docs, Japan, JRE in-place replacement, Blackberry storm

A compilation of today's news of interest:

Radio Receiver Icon

Jacob reports from JRuby-land that he is working on Support for More Frameworks in GlassFish, like merb. Others will follow, so let him know if you have preferences.

We are in the last few weeks before GlassFish v3 Prelude, and Paul has announced Final Review for Documentation. Review ends on Monday, so you don't have much time left.

Kohsuke is now in Tokyo, starting his (Japan Trip. Check out the GeoMap on Japan: we have 140K hits there, not bad, but I'm sure we can do better with improved outreach, which is why Kohsuke is visiting.

A new JRE is brewing. The new Java SE 6 Update 10 has an in-place update for the JRE in your desktop. This is a big change that will reduce the download time and will simplify your disk management. The Intro at SDN News has a pointer to a dummy try-out program, consider checking it out to give us feedback on the new release.

And the BlackBerry Storm is out, with its new touch-screen, see: Vodafone, Hands-On and AppCenter. From reading the crackberry entry, it seems the store is for distributing apps from the carrier - which is more limited than the iPhone AppStore, but, since the store is not the only way to download an app, that's less critical.

Monday Jun 30, 2008

Official GlassFish Documentation on Comet, Reverse Ajax, Ajax Push

ALT DESCR

You may or may not know that Comet, Reverse Ajax, and Ajax Push are all synonyms and define a way to notify clients from a server. Jean-François has written many fine Comet blog entries, but this GlassFish v3 documentation on Comet is a very well written intro to the Comet paradigm and how to use it inside GlassFish v3 based on the Hidden example.

You may also hear from Jean-François on Comet in a recent interview from this past JavaOne as well as read Ted Goddard's slide deck on IceFaces and Grizzly Comet from last week's GlassFish Day at Jazoon.

The documentation also discusses the pros and cons of HTTP Streaming vs. Long Polling and explains how to code both.

Wednesday Jan 09, 2008

The GlassFish troubleshooting guide is yours to improve

map image

Some time before the holidays the Sun Java System Application Server Troubleshooting Guide was migrated to a wiki format. Of course this document applies equally to GlassFish v2.

With the recent releases of both GlassFish V2 ans V2 UR1, this is probably good timing. Of course the wiki format really means that we would like people to contribute to this document and have a better flow of information between this one-stop-shop document and the GlassFish User FAQ. Specifically, hands-on experience and troubleshooting tips on enterprise features such as clustering is welcome. Maybe an idea for the Community Awards Program?

Sunday Dec 16, 2007

The door between Hell and Heaven? Documentation! GlassFish Installation Experience

Dante's Hell

This was an interesting exchange. Jevgeni, of JavaRebel et al, wrote GlassFish Installation from Hell after trying out GlassFish and prompty got plenty of feedback. Most of the commenters pointed to RTFM (e.g. James's note) but I think we should not dismiss his feedback too quickly.

Jevgeni has several valid points: there are no installation instructions in the download itself and the download is a jar that requires extra flags (more heap size). We should be able to improve the situation even before GFv3; the heap size may be harder to remove, but even switching to a ZIP of the JAR + Instructions would help. Even just a sharper download page might help!

Note the installation experience of the Java EE SDK is quite different, but that installer is not Open Source and it is not used in the Java.Net Downloads.

PS. Jevgeni, do let us know when you get JavaRebel (and JSPWeaver?) running on GlassFish.

Wednesday Dec 05, 2007

What's on your wishlist for GlassFish v3 docs?

Radio Receiver Icon

Later today (8:30 PM Pacific), the Sun documentation team for GlassFish is holding a GlassFish v3 Documentation Meeting. This is your opportunity to provide yet more feedback on what documentation should be going forward.

• Meeting details are here.

Thursday Nov 22, 2007

GlasFish Developer FAQ Now Available

Screenshot of Developer FAQ

Gail has announced that there is now a Developer FAQ to complement the User FAQ.

Please contribute your Qs and your As.

Sunday Nov 04, 2007

Updated Documentation for Metro and JAXB

Radio Receiver Icon

From Kohsuke:

Metro and JAXB users guide gets syntax coloring.

Monday Sep 03, 2007

How to Provide Feedback on GlassFish Documentation

ALT DESCR

One more Call for Documentation Issues before finalizing the GlassFish v2 final release. The process that Paul has chosen has pretty low overhead: just go to the Master Docs Page and then check out the documentation you are interested. If there is an issue, enter it directly in the corresponding wiki page.

Some of the pages have a just a few comments ([1], [2], [3], [4], [5]). Others have many comments, like Developers Guide, Administration Reference and Upgrade Migration Guide.

Paul is being very responsive; provide your feedback and he will incorporate the fixes if at all possible.

Wednesday Jul 18, 2007

GlassFish documentation feedback wanted

no time to find a better image

Documentation is one of the strengths of glassfish but we want to improve it further. We already sped up the content at docs.sun.com and Paul is now soliciting feedback for the Online Help.

If you would like to provide feedback or simply read the latest documentation, please use the document comment wiki at the GlassFishDocs page.

Note that the deadline for feedback in time for GlassFish v2 FCS is just next week: July 23, 2007.

Wednesday Jul 11, 2007

docs.sun.com at full speed

docs.sun.com images

If you are a docs.sun.com user, you probably experienced some latency (or even worse) while navigating the site. We're glad to report docs.sun.com now hosted on a Sun external web-hosting environment with much improved performance. Try for yourself with Sun Java System Application Server 9.1 (GlassFish v2) beta documentation.

While blogs are great and show up prominently while searching the Internet, some of them become obsolete and official documentation is really what should preempt other content.

BTW - if you're interested in Internet and XML archeology, you can read how Jon Bosak (XML co-inventor, Sun employee) first implemented Solaris documentation about 10 years ago under the name AnswerBook2 with an all-XML background. This later became docs.sun.com.

Monday Jun 11, 2007

Java.Net GlassFish Forums - Now all in one Category

Java.Net logo

All the Java.Net forums that are related to GlassFish are now under one category; going to this Page now will show you all the most recent posts and threads.

GlassFish is showing good adoption ([1], [2]) but we think there is a lot of room for growth and we welcome your suggestions...

For example, we could split the development pages from the user pages in the GlassFish Wiki; that seems to be working well for OpenJFX. That might Encourage Participation in projects like this one? It might also help us better integrate the Sun's Doc Site with the community site.