January 17th, 2011 by Team

PrettyFaces 3.2.0 is Released – URL Rewriting for Servlet, Java EE, and JSF

PrettyFaces is an OpenSource Filter-based Servlets extension with enhanced support for JavaServer Faces – JSF 1.1, 1.2 and 2.0 – enabling creation of bookmark-able, pretty URLs. PrettyFaces solves the “RESTful URL” problem elegantly, including features such as: page-load actions, seamless integration with faces navigation, dynamic view-id assignment, managed parameter parsing, and configuration-free compatibility with other web frameworks.

Major Changes

  • PrettyFaces is now licensed under the Apache Software License v2.0 (http://www.apache.org/licenses/LICENSE-2.0.html)
  • Added ‘parentId’ for Hierarchical Mappings in pretty-config.xml (#72)
  • Can now be run in a pure servlet environment (without JSF and related JARs)

Features & Enhancements:

  • Added ‘onPostback’ configuration parameter for query parameters (#24)
  • Added code-completion support for Eclipse Helios
  • Added ‘pretty:location’ client behavior
  • Added ‘onPostback’ configuration parameter for path parameters (#24)
  • New method PrettyContext.sendError() to send custom HTTP status codes (#66)
  • Added SPI hooks for ConfigurationProvider and ConfigurationPostProcessor
  • New @URLMappings annotation to declare multiple mappings on a single class

Regression impact:

  • Changed some method signatures in PrettyContext
  • PrettyFilter no longer wraps application exceptions in ServletException
  • PrettyException no longer extends javax.faces.FacesException
  • Began deprecation of <view-id>/view.jsp</view-id> in favor of <view-id value=”/view.jsp” />
  • com.ocpsoft.pretty.faces.el.BeanNameResolver SPI has moved to com.ocpsoft.pretty.faces.spi.ELBeanNameResolver
  • URL-mapping order is now properly respected in pretty-config.xml (and other config sources.)
  • Began deprecation of PrettyURLBuilder methods without the new ‘encodeUrl’ argument.


  • Fixed compatibility with Java 1.5
  • Fixed handling of non-ASCII characters in URLs
  • Fixed EL method invocation in JSF 1.1 branch.
  • Removed HttpSession accesses that could potentially create an unwanted user session. (#62)
  • Prevent downloading of web.xml DTDs during configuration
  • Fixed FacesConfigBeanNameResolver regarding space characters in URLs
  • PrettyFacesWrappedResponse no longer depends on FacesContext (#78)
  • PrettyFaces no longer injects values into EL if the response has been marked complete (#79)
  • Added documentation specifying the need to “double-escape” backslashes in custom regexes (#83)
  • Fixed annotation scanning if application is run with jetty-maven-plugin

Posted in PrettyFaces


  1. […] creation of bookmark-able, pretty URLs. PrettyFaces solves the “RESTful URL” problem… [full post] admin OcpSoft prettyfaces 0 0 0 0 0 [17 Jan […]

  2. […] Story: PrettyFaces 3.2.0 is Released – URL Rewriting for Servlet, Java EE, and JSF | OcpSoft) This entry was posted in web2.0 and tagged jsf. Bookmark the permalink. ← University of […]

Leave a Comment

Please note: In order to submit code or special characters, wrap it in

[code lang="xml"][/code]
(for your language) - or your tags will be eaten.

Please note: Comment moderation is enabled and may delay your comment from appearing. There is no need to resubmit your comment.