Using the ajaxKeys attribute for <rich:dataList>

    The following simple example demonstrates how to update a price for a specific car from the list.

    Here is the code:


         <h:selectOneMenu id="select" value="#{carBean.currentItem}">
              <f:selectItems value="#{carBean.selectsList}"/>
         <h:inputText id="newprice" value="#{carBean.newPrice}" />
         <a4j:commandButton action="#{carBean.updateCarPrice}" reRender="price" value="Submit"/>
         <rich:dataList var="car" value="#{carBean.listOfCars}" id="list" 
              rows="6" type="disc" ajaxKeys="#{carBean.keyToUpdate}">
              <h:outputText value="#{car.make} #{car.model}"/><br/>
              <h:outputText value="Price: " styleClass="label" />
              <h:outputText id="price" value="#{car.price}" />


    There is no point in updating the whole component to change a price for a single

    car. Using the ajaxKeys attribute we can choose which item to update.


    The car model contains the next properties: a car title, model and price. :


     public class Car {
          private String make;
          private String model;
          private BigDecimal price = new BigDecimal(0);
          public Car() {}
          public Car(String make, String model, BigDecimal price) {
              this.make = make;
              this.model = model;
              this.price = price;
         /* --- getters and setters ----*/



    In the example you see a list of cars. To change a price for a car, choose in the select menu the car which you want to re-set the price for, type a new price in the input field and press the Sumbmit button to update the value.


    In the example, the <a4j:commandButton/> has the reRender attribute bound to the <h:outputText/> that outputs the price using the id attribute. While the ajaxKeys of  <rich:dataList/>  points to the list item to be updated.


    The bean used in the example looks like this:

    public class CarBean {
          private  List<Car> listOfCars;
          private BigDecimal newPrice;
          public List<SelectItem> selectsList = new ArrayList<SelectItem>();
          private Integer currentItem;
          private Set<Integer> keyToUpdate;
          public CarBean(){
               keyToUpdate = new HashSet<Integer>();
               listOfCars = new ArrayList<Car>();
               listOfCars.add( new Car("Chevrolet", "Corvette", new BigDecimal(18500)));
               listOfCars.add( new Car("Chevrolet", "Malibu", new BigDecimal(20500)));
               listOfCars.add( new Car("Chevrolet", "Tahoe", new BigDecimal(17890)));
               listOfCars.add( new Car("Ford", "Taurus", new BigDecimal(18580)));
               listOfCars.add( new Car("Ford", "Explorer", new BigDecimal(21540)));
               listOfCars.add( new Car("Nissan", "Maxima", new BigDecimal(15900)));
               SelectItem item;
               for(Car car : listOfCars){
                     item = new SelectItem(listOfCars.indexOf(car), car.getMake() + "
                   " + car.getModel());
    public void updateCarPrice(){
                keyToUpdate = Collections.singleton(currentItem);
          /* --- getters and setters ----*/




    In the example we use ajaxKeys to update  only one item. Actually, it’s possible to update multiple items: ajaxKeys contains an Object (java.util.Set) that holds keys of all items needed to be updated after an Ajax request.