It has now been almost two years since the development of RichFaces ended, however since people are still using it I just want to clear up a few things.

Showcases

The showcases were down earlier this year, I had to switch hosting and it didn't go as smoothly as expected. showcase.richfaces.org is now back up and should hopefully remain so for at least another year. Showcase for RF 3 is however not coming back, if you want to use it you will have to deploy it locally; it's just not feasible for me to get it up and running. I found out the demos that were hosted at exadel.com are now also down but I have no control over those.

JIRA, forums and other things

As far as I know there are no plans to shut down the current "infrastructure" (JIRA, source repositories, this whole site). That said I do not recommend using the JIRA, I'm generally ignoring it. If you want to get a hold of me the forum is the best place to do it. You can also try the RichFaces Twitter but I don't check it that often.

That's about it. Should things change I'll post an update. If you have any questions ask in the comments.

RichFaces 4.5.16.Final is available for download.

In this release we have fixed the "resetValues" attribute not working with MyFaces and we've fixed minor bugs and improved several components such as select, pickList and fileUpload.

Release Notes 

        Bug

• [RF-11063] -         rich:select is not at same level with text
• [RF-11735] -         [rich:tabPanel] activeItem doesn't work if attribute immediate is set to true
• [RF-12845] -         rich:menuItem does not work as composite component
• [RF-13776] -         a4j:ajax problem with hierarchical component IDs
• [RF-14252] -         @resetValues doesn't work with MyFaces
• [RF-14254] -         filtering is not working properly in rich:select component
• [RF-14255] -         Subtopic missing in processPreSubscriptionEvent
• [RF-14256] -         pickList doesn't fire onremoveitems when keepSourceOrder is true
• [RF-14257] -         rich:fileUpload not throwing the javascript event "onsizerejected" for global maxRequestSize
• [RF-14258] -         fileUpload: js events for error not trigger when same file selected twice
• [RF-14259] -         select: error class is not removed after selecting suggestion->type->delete
• [RF-14261] -         rich:orderingList broken with direction: rtl

        Component  Upgrade

• [RF-14253] -         Upgrade third-party libraries

        Enhancement

• [RF-12609] -         inplace input/select : controls are always visible
• [RF-14248] -         unify background colors and gradients
• [RF-14262] -         page-fragments: replace invoking of blur event
• [RF-14263] -         page-fragments: inplace input/select: replace invoking of edit event

        Task

• [RF-14264] -         Update documentation regarding file size handling in rich:fileUpload
• [RF-14265] -         update integration tests dependencies

        Sub-task

• [RF-14260] -         fileUpload: @onsizerejected: update attribute description (VDL doc)

RichFaces 4.5.14.Final is available for download.

In this release we've implemented a long-requested feature - a menu for hiding columns in rich:extendedDataTable (you can see it action in the Showcase). We've fixed ajax requests in rich:tree, rich:treeNode now inherits request-related attributes (oncomplete, data, …) from the parent tree. There were two updates that might cause issues with custom styles, the components affected are rich:contextMenu (style and styleClass now apply to a different element) and rich:popupPanel (style was being incorrectly applied in two places).

Release Notes 

        Bug

• [RF-10265] -         rich:tree - toggling fires @onbegin event handler, but omits @onbeforedomupdate and @oncomplete
• [RF-12097] -         Richfaces 4.2.0 invalid css entry for *.rf-insl-tt
• [RF-12295] -         Facelets exception on postback when partial state saving is off
• [RF-12979] -         rich:contextMenu inside rich:accordion displays incorrectly
• [RF-14159] -         Autosized popup panel has wrong size after re-render
• [RF-14225] -         Behavior of rich:select component with duplicate labels
• [RF-14229] -         rich:dragSource - error on dropover when using custom options
• [RF-14231] -         FocusManager: cannot focus on component inside iteration component
• [RF-14233] -         rich:dragSource - empty dragOptions cause error
• [RF-14235] -         rich:popupPanel - style attribute is applied twice

        Component  Upgrade

• [RF-14226] -         Upgrade third-party libraries

        Enhancement

• [RF-14128] -         Add profile for WF 10
• [RF-14227] -         Incorrect information in Developer Guide
• [RF-14230] -         Provide better handling for RichFaces.ui.Droppable
• [RF-14239] -         provide better parent menu resolutions for menu items

        Feature Request

• [RF-7872] -         Tables: columns visibility

        Task

• [RF-14234] -         Add profile for EAP 6.4
• [RF-14240] -         photoalbum: stabilize tests
• [RF-14241] -         page-fragments: contextMenu: fix the page fragment after refactoring in contextMenu
• [RF-14242] -         showcase: integration-tests: contextMenu: fix locators

        Sub-task

• [RF-14232] -         Document @showColumnControl and add example to showcase

RichFaces 4.5.13.Final is available for download.

In this release we have fixed an issue with client-side validation in iteration components, fixed a4j:ajax listening to rowclick event and fixed an issue with a4j:status becoming stuck in certain situations. We have also upgraded jQuery to the latest version (1.12).

Release Notes

        Bug

• [RF-10813] -         Calendar: css class doesn't follow naming conventions
• [RF-11635] -         rich:calendar missing attribute title
• [RF-11915] -         MenuGroup with all items disabled or no items causes JS error
• [RF-11941] -         mobile showcase - a4j:queue - Warning generated on server side
• [RF-12092] -         a4j:poll : a4j:status never clears
• [RF-12337] -         rich:popupPanel impacts layout even if not shown
• [RF-12527] -         Drag indicator is not visible when popup panel is open
• [RF-12653] -         rich:autocomplete needs two clicks to hide popup
• [RF-12661] -         rich:tooltip causes NPE with null value
• [RF-13127] -         onvalid and oninvalide pass wrong element when using rich:element with String field
• [RF-13165] -         The rowclick event of the rich:dataTable is not recognized as a valid server-side event during an ajax postback
• [RF-13167] -         disabled contextMenu/dropDownMenu/menuGroup/menuItem is missing styleClass
• [RF-13441] -         contextMenu - when showEvent is dblclick then context menu disappear after invoking
• [RF-14200] -         mobile showcase: links to VDL doc and Component reference
• [RF-14213] -         fileUpload: custom progressBar is used only for the first item when uploading multiple items
• [RF-14215] -         extendedDataTable: keyboard navigation fails when using lower values of @clientRows
• [RF-14218] -         fileupload: error in browser console during upload

        Component  Upgrade

• [RF-14217] -         Upgrade third-party libraries

        Enhancement

• [RF-11705] -         showcase, rich:popupPanel - low contrast of close button
• [RF-14219] -         page-fragments: editor: 'type' method: append the text to the end of the content with Selenium 2.48
• [RF-14221] -         Incorrect description of "header" attribute in rich:panel tag doc (http://docs.jboss.org/richfaces/latest_4_5_X/vdldoc/)

        Task

• [RF-14024] -         rich:select - clarify usage of autoComplete
• [RF-14203] -         showcase: cleanup release profile
• [RF-14211] -         component reference: tree: add images for default node examples
• [RF-14212] -         vdl-doc: tree: add default value of @useDefaultNode
• [RF-14214] -         showcase: stabilize integration tests with tomcat+myfaces
• [RF-14220] -         component reference: select: add sample and more informations about using select in auto-completing mode
• [RF-14223] -         showcase: stabilize integration tests

RichFaces 4.5.11.Final is available for download.

In this release we have updated styling options for chart, notifyMessage and dataGrid and updated our VDL documentation with regards to default attribute values. We have also added an option to skip resource optimization during build (-Doptimization.skip)

Release Notes 

        Bug

• [RF-12098] -         PickList doesn't accept comma in string value
• [RF-13045] -         param and hashParam: attribute @rendered is not working
• [RF-13259] -         DataTable rowClasses with columnGroup is not rendered
• [RF-14163] -         showcase: correct references to bean
• [RF-14164] -         rich:notifyMessage, notifyMessages: attributes @style and @title are not applied to created message component
• [RF-14169] -         showcase: panel: bad description in lookCustomization sample
• [RF-14171] -         @resetValues was added to not listed components
• [RF-14172] -         validator: @event cannot be a ValueExpression
• [RF-14174] -         validator: @immediate does not work and has wrong description
• [RF-14175] -         calendar: unused attribute @weekDayLabels
• [RF-14176] -         chart: attribute @style does not work
• [RF-14178] -         validator: @onbeforesubmit cannot be used with MyFaces
• [RF-14179] -         VDL-doc: specified default values are not correct
• [RF-14194] -         Misprint in format string of MessageFormat.format in ResourceServletContainerInitializer
• [RF-14197] -         page-fragments: dataGrid: getRecordsInRow contains bad condition

        Component  Upgrade

• [RF-14170] -         Upgrade third-party libraries
• [RF-14182] -         Upgrade testing dependencies

        Enhancement

• [RF-14162] -         showcase: add missing links to VDL Documentation/Component Reference in some examples
• [RF-14168] -         showcase: collapsibleSubTable demo: wrong output in cars total count
• [RF-14183] -         page-fragments: inputNumberSlider: dragging the handle starts from wrong value
• [RF-14186] -         Hide @converter and @value in components extending UIOutput
• [RF-14190] -         Provide better contrast for selected items
• [RF-14192] -         showcase: focus: fix simple and delayed samples
• [RF-14193] -         Allow skipping resource optimization during build
• [RF-14196] -         page-fragments: dataGrid: make methods for returning of elements in advanced interactions public

        Feature Request

• [RF-10779] -         rich:dataGrid - support classes for header, footer, rows and columns
• [RF-14166] -         rich:calendar keyboard support to close calendar

        Task

• [RF-14157] -         showcase: fix integration tests
• [RF-14158] -         update VDL doc for notify's @sticky attribute
• [RF-14173] -         VDL-doc: validator: add missing documentation of attributes
• [RF-14189] -         Remove unused arquillian-warp test dependencies

        Sub-task

• [RF-14187] -         calendar: document keyboard support for closing the popup
• [RF-14195] -         vdl-doc: tables + dataGrid: add description to attributes

RichFaces 4.5.9.Final is available for download.

In this release we've added an option to use text-substitution in rich:contextMenu (more in documentation) and we've added focus() method to the JS API of input elements. We've also updated rich:componentControl to be able to use standard DOM methods.

Release Notes 

Bug

• [RF-11402] -         Metamer: rich:inplaceSelect: scroller disappear when move by mouse
• [RF-12488] -         detached contextmenu menu fails
• [RF-12510] -         jsFunction data called before completittion
• [RF-12759] -         rich:componentControl doesn't work on commandButton
• [RF-12820] -         AutoComplete Layout Table is broken
• [RF-12841] -         Tooltip: JavaScript Error with showDelay and partial update
• [RF-14081] -         Rerendering of drag indicator not reflected when dragging an element
• [RF-14102] -         orderingList, pickList: @collectionType can only be a String
• [RF-14119] -         page-fragments: status: status state is not returned correctly
• [RF-14120] -         page-fragments: editor: type method is changing editor's text even if in readonly mode
• [RF-14122] -         autocomplete: autofill does not work for upper case beginning letter
• [RF-14129] -         rich:select list doesn't opens, if first element in the list is empty (with solution)
• [RF-14133] -         mobile showcase with myfaces: cannot display any example
• [RF-14136] -         [rich:toolbar] hideDelay does not work
• [RF-14138] -         components/rich cannot be compiled with java 1.6

Component  Upgrade

• [RF-14113] -         Upgrade third-party libraries

Enhancement

• [RF-14101] -         Replace Showcase tests for a4j:status
• [RF-14115] -         page-fragments: editor: wait for inner frame to be visible before switching to it
• [RF-14121] -         showcase: editor: decrease autosaving frequency

Feature Request

• [RF-7824] -         Add "focus" method to focusable components
• [RF-11842] -         Support for macrosubstitutions in the contextMenu

Sub-task

• [RF-14118] -         Document text substitutions in rich:contextMenu
• [RF-14125] -         Add focus() to JS API documentation
• [RF-14131] -         Document @dragOptions for rich:dragSource

I've been recently made aware of a bug in the fileUpload component where the encoding of the filename would get corrupted during the upload. E.g. you can take a file named štěně.png (that's Czech for puppy) and after upload the name would be Å¡tÄ›nÄ›.png. It doesn't occur on servers that use Servlet 2.5 (e.g. JBoss EAP 6.4).

The issue is caused by a difference in default encoding between two standards:

• HTTP/1.1 - the standard was published in 1999 so unfortunately the default encoding is iso-8859-1 (it is specified in chapter 3.4.1).
• XHR2 - the default encoding when using FormData is utf-8

When a request is sent to the server the headers may look like this:

1. Content-Length:426
2. Content-type:application/x-www-form-urlencoded;charset=UTF-8

A fileUpload request will look like this:

1. Content-Length:2970
2. Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryIbSCCmmqQBCJ5qSk

notice that the charset isn't specified, that's part of the XHR2 standard. When the request is parsed the server will use iso-8859-1 and the name gets corrupted.

Fortunately the default for HTTP can be changed, although if you change it to anything else than utf-8 - i.e. the encoding of the request - it will not work (we're getting this fixed in RichFaces 4.5.8).

• on Tomcat add this to web.xml

<filter>
    <filter-name>SetCharacterEncoding</filter-name>
    <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>SetCharacterEncoding</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

• on WildFly you can add <default-encoding>UTF-8</default-encoding> to jboss-web.xml

However this solution doesn't currently work on WildFly due to a bug in Undertow. The bug was reported and fixed, the fix will be available in the upcoming version. In the meantime if you encounter the issue you can fix the filename simply with

filename = new String(filename.getBytes("iso-8859-1"), "utf-8");

If you encounter an issue with the encoding after 4.5.8 is released please report it (if it's not on WildFly).

RichFaces 4.5.6.Final is available for download.

In this release we have enhanced file size handling for rich:fileUpload - you can now specify "maxFileSize" directly on the component and it will also serve to reject large files immediately on client-side. We've also added support for transparent color in custom skin properties.

Release Notes

        Bug

• [RF-11091] -         Autocomplete component is wrongly aligned
• [RF-11606] -         rich:select : doesn't cast selectItem value
• [RF-12054] -         TabPanel onitemchange of outer tab fired by inner tab
• [RF-12362] -         skin color parameters do not support "transparent"
• [RF-14025] -         Photoalbum login via social sites
• [RF-14035] -         Showcase context menu: JS error in console
• [RF-14039] -         Collapsible Panel Icon Regression
• [RF-14043] -         rich:tabPanel does not switch if rich:tab has number value name
• [RF-14044] -         push: error in browser console after push enabled/disabled

        Component  Upgrade

• [RF-14038] -         Upgrade third-party libraries

        Enhancement

• [RF-14023] -         rich:contextMenu - on ajax re-render the destroy function doesn`t clean up properly
• [RF-14034] -         PageFragments: Implement workaround for contextClick on PhantomJS

        Feature Request

• [RF-6524] -         maxRequestSize for richfile upload should be made configurable per component and not globally.
• [RF-12395] -         fileUpload validations must be done on client

        Task

• [RF-13882] -         Showcase-test failed on phantomJS
• [RF-14042] -         Create Arquillian profile for WildFly 9