What's wrong with JavaServerFaces
When we click on the “homepage” link of the JSF entry in Maven Repository we are forwarded (from http://java.sun.com/javaee/javaserverfaces/ - I thought that company died long ago, but Oracle doesn’t bother fixing links) to
http://www.oracle.com/technetwork/java/index.html
which currently showcases a picutre of a young man in front of the computer
and we are told he is probabaly working with JSF & PrimeFaces (PrimeFaces is “a popular JavaServer Faces (JSF) UI framework” that is also used in my project, I hope I’ll get to cover that too).
Now, to me, he doesn’t look like he is happily working on something interesting but rather trying hard to finally get-that-bloody-thing to work (already in the exhaustion/resigning phase – “damn, why doesn’t it work!? :(“).
This is comes close to how I feel about the series of tools I am writing about here (1).
So let’s get started tinkering about this web framework.
- The website (Get Started subpage) uses a two nice gray color shades for both font and links, making it guesswork to spot links by hovering over everything. (“What you can’t distinguish rgb (51,51,51) from (85,85,85)? Your vision is terrible.”)
The Data Sheet (from the year 2010…, the latest jsf version 2.2 is from 2014 - who cares about documentation) they link to in the beginning of that page is offline, forcing me to read an even older one https://javaserverfaces.java.net/presentations/20090520-jsf2-datasheet.pdf
Once you’ve read that, continue here.
One of the best places to start is with the official documetation.(followed by link to version 2.0 javadoc, rendered with the very old javadoc and mixed with some pastel color: https://javaserverfaces.java.net/nonav/docs/2.0/javadocs/)
Wow, I cannot read on, obviously that webpage is not meant to be looked at when seriously trying to learn about jsf.
Looks like http://docs.oracle.com/javaee/7/tutorial/doc/javaeetutorial7.pdf is not too bad a place to start.
To be continued…
(1): Combined with the feeling that “it cannot be so hard to make this better, let me show you”
Written with StackEdit.
Comments
Post a Comment