Wednesday, February 12, 2014

JSF 2.0 New Feature Preview Series: Part 1: ProjectStage

08.06.2008
 | 29487 views | 
This will be the first of a small series of blogs covering proposed new features in JSF 2.0. Keep in mind that none of the features described are final, and may change, but this is a good opportunity to show the features as they exist now and illicit feedback.

We'll be starting to publish nightly builds of Mojarra 2.0.0 to the project site soon, but for the time being, you'll have to check out the sources and build the implementation yourself (luckily, the build is very easy).

So, what is the ProjectStage feature?  In short, the JSF 2.0 EG has given a nod to Ruby on Rails'RAILS_ENV functionality.

javax.faces.application.ProjectStage provides the following options:
  • Production
  • Development
  • UnitTest
  • SystemTest
  • Extension
These values are configured via a context init-parameter like so:
1.<context-param>
2.<param-name>javax.faces.PROJECT_STAGE</param-name>  
3.<param-value>Development</param-value>
4.</context-param>
At runtime, you can query the Application object for the configured value by calling Application.getProjectStage(). The return value will be one of the defined enums.  If not explicitly configured, then the default will be ProjectStage.Production.

All of the values outside of Extension are fairly self explanatory, so what is Extension for?  This allows the developer to leverage custom stages. So if a value is specified that doesn't match the existing enumerate values, then it will be the value for used.  When calling Application.getProjectStage() the Extension enum value will be returned.  Calling toString() on the return values at this point will return the value as configured in the web.xml.  This will be useful for developers building upon the JSF framework to add stages to affect behavior that is outside the scope of the predefined types.

Overall the idea here is to be able to affect the behavior of JSF based on these values. As an example of where this is useful:  consider a simple JSF view that has several validated input fields and validation fails.  If there is no h:messages component in the view, the page appears to do nothing.  I can't tell you how many forum postings I've run across where this type of thing occurs, and the first response is always 'add h:messages to your view and try again'.

Here is where ProjectStage comes in:  If the current stage is Development and no h:messages is present in the view, we'll add one automatically for the user. If the stage is Production we'd take no action (assuming the user would have
this all corrected - no need to try to modify the tree).

While this feature may seem relatively minor, I wanted to discuss it first as it impacts the feature I'll be discussing in my next entry - stay tuned!

UPDATE: 2/19/2008 - JNDI configuration implemented

Per the feedback provided to this blog entry, we've implemented the ability to configure ProjectStage via JNDI.  Then Application.getProjectStage() is first invoked, it will first check for a value from JNDI, if not found, it will then check
for  a context init parameter, finally defaulting to ProjectStage.Production if no configured value is found.  The JNDI name that is currently spec'd is java:comp/env/jsf/ProjectStage. 
Additionally, we've added a JNDI ObjectFactory to Mojarra to make it easy for developers to make a custom global JNDI resource to configure ProjectStage.
Here is an example of how to define this ObjectFactory in GlassFish:
The value of the stage property is what will be returned from the JNDI lookup.
It should be noted that mapping global JNDI resources to component resources (java:comp/env) is, unfortunately, an implementation specific process.  So, to continue using GlassFish as an example, you'd need to add a resource-ref
entry to the web.xml:
1.<resource-ref>
2.<res-ref-name>jsf/ProjectStage</res-ref-name>
3.<res-type>java.lang.String</res-type>
4.</resource-ref>
Then you need to map the res-ref-name to the global JNDI resource via the  sun-web.xml (also in /WEB-INF/):
1.<resource-ref>
2.<res-ref-name>jsf/ProjectStage</res-ref-name>
3.<jndi-name>javax.faces.PROJECT_STAGE</jndi-name>
4.</resource-ref>
Alternatively, the JNDI configuration could be done by a simple env-entry in the web.xml, but this doesn't allow you to configure ProjectStage for all applications without modifying the web.xml.
References
Published at DZone with permission of its author, Ryan Lubke. (source)

2 comments:

oakleyses said...

jordan pas cher, chanel handbags, nike outlet, michael kors pas cher, kate spade outlet, replica watches, longchamp pas cher, nike free, jordan shoes, christian louboutin shoes, nike free run, louis vuitton outlet, oakley sunglasses, ray ban sunglasses, polo ralph lauren, ugg boots, christian louboutin uk, air max, louis vuitton outlet, ugg boots, tiffany jewelry, polo ralph lauren outlet online, burberry pas cher, prada outlet, nike air max, gucci handbags, sac longchamp pas cher, ray ban sunglasses, louboutin pas cher, louis vuitton, uggs on sale, tiffany and co, oakley sunglasses, louis vuitton outlet, ray ban sunglasses, longchamp outlet, louis vuitton, longchamp outlet, replica watches, nike roshe, polo outlet, oakley sunglasses, cheap oakley sunglasses, oakley sunglasses wholesale, christian louboutin, christian louboutin outlet, tory burch outlet

oakleyses said...

ipad cases, beats by dre, iphone 6 cases, ferragamo shoes, wedding dresses, hollister clothing, p90x workout, instyler, asics running shoes, nike huaraches, hermes belt, north face outlet, s6 case, babyliss, nfl jerseys, hollister, iphone 6 plus cases, insanity workout, ralph lauren, iphone cases, iphone 6s plus cases, bottega veneta, new balance shoes, longchamp uk, iphone 6s cases, giuseppe zanotti outlet, nike roshe run, mont blanc pens, herve leger, oakley, lululemon, timberland boots, nike air max, iphone 5s cases, ghd hair, valentino shoes, louboutin, nike trainers uk, celine handbags, north face outlet, baseball bats, vans outlet, abercrombie and fitch, chi flat iron, soccer jerseys, mac cosmetics, mcm handbags, soccer shoes, jimmy choo outlet, reebok outlet