幸せのちから

下面列出的是checkbox示例的完整代碼。想要強調的主要事情是表標簽form屬性設置為presForm，它參照被稱為presForm的form元素。

同時請注意表標簽的autoIncludeParameters屬性。進行排序、過濾、分頁時，默認的eXtremeTable將保持所有傳至JSP頁面的參數。 這個特性對于內部其他的form進行排序、過濾、分頁時，用于高效復制form元素同樣有效。可以設置 autoIncludeParameters屬性為false來固定它。

在這個form使用id屬性是因為xhtm標準的要求，同時你也可以使用form的name屬性。

<form id="presForm" action="<c:url value="selectedPresidentsListedController.run"/>" method="post">

 Enter your name: 
 <input 
  type="text" 
  name="userName" 
  style="font-family:verdana,arial,helvetica,sans-serif;font-size:11px;"
  value="<c:out value="${param.userName}"/>"
  />

 <ec:table 
  items="presidents"
  action="${pageContext.request.contextPath}/selectedPresidentsController.run"  
  view="compact"
  imagePath="${pageContext.request.contextPath}/images/table/compact/*.gif"
  rowsDisplayed="8"
  autoIncludeParameters="false"
  form="presForm"
  >
  <ec:exportPdf 
    fileName="output.pdf" 
    tooltip="Export PDF" 
    headerColor="black" 
    headerBackgroundColor="#b6c2da" 
    headerTitle="Presidents"
   />
  <ec:row>
   <ec:column 
      alias="checkbox"
      title=" " 
      width="5px" 
      filterable="false" 
      sortable="false" 
      viewsAllowed="compact"
      cell="selectedPresident"
      />
   <ec:column property="fullName" title="Name"/>
   <ec:column property="nickName" />
   <ec:column property="term" />
  </ec:row>
 </ec:table>

 <input
     type="button"
     name="sel"
     class="button"
     value="List Selected Presidents"
     onclick="document.forms.presForm.submit();"
     />

   <script type="text/javascript">
   function setPresidentState(chkbx) {
    //make sure that always know the state of the checkbox
    if (chkbx.checked) {
     eval('document.forms.presForm.chkbx_' + chkbx.name).value='SELECTED';
    } else {
     eval('document.forms.presForm.chkbx_' + chkbx.name).value='UNSELECTED';
    }
   }
   </script>

</form>

column.cell.selectedPresident=org.extremesite.cell.SelectedPresidentCell

<ec:column 
      alias="checkbox"
      title=" " 
      width="5px" 
      filterable="false" 
      sortable="false" 
      viewsAllowed="compact"
      cell="org.extremesite.cell.SelectedPresidentCell"
      />

定制的cell被用來生成checkbox，另外它也創建一個隱藏元素用來表示這個checkbox元素是否被選中。 當用戶進行排序、過濾、分頁時，被選中的數據集合將被放到session里。

getExportDisplay()方法沒有返回值，因為治理只需要Html顯示。

public class SelectedPresidentCell implements Cell {
  public String getExportDisplay(TableModel model, Column column) {
      return null;
  }

  public String getHtmlDisplay(TableModel model, Column column) {
      HtmlBuilder html = new HtmlBuilder();
      
      CellBuilder.tdStart(html, column);
      
      try {
          Object bean = model.getCurrentRowBean();
          String presidentId = BeanUtils.getProperty(bean, "presidentId");
          
          Collection selectedPresidentsIds = (Collection)model.getContext().getSessionAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);
          if (selectedPresidentsIds != null && selectedPresidentsIds.contains(presidentId)) {
              html.input("hidden").name("chkbx_" + presidentId).value(SelectedPresidentsConstants.SELECTED).xclose();
              html.input("checkbox").name(BeanUtils.getProperty(bean, "presidentId"));
              html.onclick("setPresidentState(this)");
              html.checked();
              html.xclose();
          } else {
              html.input("hidden").name("chkbx_" + presidentId).value(SelectedPresidentsConstants.UNSELECTED).xclose();
              html.input("checkbox").name(BeanUtils.getProperty(bean, "presidentId"));
              html.onclick("setPresidentState(this)");
              html.xclose();
          }
      } catch (Exception e) {}
      
      CellBuilder.tdEnd(html);
      
      return html.toString();
  }
}

提示：Spring框架的Controller和Struts框架的Action非常相像。

當在另外的form中使用eXtremeTable時，你可能有1個或2個controllers。當form被提交時，你需要一個controller 來處理用戶的輸入并重新定向到另外的JSP頁面。當排序、過濾、分頁時，你可能有另外的controller來得到表使用的數據集合并重定向會本頁。或者你可以在同一個controller中分別處理。

checkbox示例里我使用一個controller來關聯表標簽的action屬性。我也使用另外一個controller來關聯form元素的動作。

SelectedPresidentsUtils.saveSelectedPresidentsIDs(request);
Collection presidents = presidentsService.getPresidents();
request.setAttribute("presidents", presidents);

Collection selectedPresidentsIds = SelectedPresidentsUtils.saveSelectedPresidentsIDs(request);
Collection selectedPresidents = SelectedPresidentsUtils.getSelectedPresidents(presidentsService.getPresidents(), selectedPresidentsIds);
request.setAttribute("selected", selectedPresidents);
request.getSession().removeAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);

public static Collection saveSelectedPresidentsIDs(HttpServletRequest request) {
    Collection presidents = (Collection) request.getSession().getAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS);
    
    if (presidents == null) {
        presidents = new ArrayList();
        request.getSession().setAttribute(SelectedPresidentsConstants.SELECTED_PRESIDENTS, presidents);
    }

    Enumeration parameterNames = request.getParameterNames();
    while (parameterNames.hasMoreElements()) {
        String parameterName = (String) parameterNames.nextElement();
        if (parameterName.startsWith("chkbx_")) {
            String presidentId = StringUtils.substringAfter(parameterName, "chkbx_");
            String parameterValue = request.getParameter(parameterName);
            if (parameterValue.equals(SelectedPresidentsConstants.SELECTED)) {
                if (!presidents.contains(presidentId)) {
                    presidents.add(presidentId);
                }
            } else {
                presidents.remove(presidentId);
            }
        }
    }

    return presidents;
}