Coverage Report - org.kuali.rice.kns.web.struts.form.MultipleValueLookupForm
 
Classes in this File Line Coverage Branch Coverage Complexity
MultipleValueLookupForm
0%
0/111
0%
0/32
1.476
 
 1  
 /*
 2  
  * Copyright 2007-2008 The Kuali Foundation
 3  
  * 
 4  
  * Licensed under the Educational Community License, Version 2.0 (the "License");
 5  
  * you may not use this file except in compliance with the License.
 6  
  * You may obtain a copy of the License at
 7  
  * 
 8  
  * http://www.opensource.org/licenses/ecl2.php
 9  
  * 
 10  
  * Unless required by applicable law or agreed to in writing, software
 11  
  * distributed under the License is distributed on an "AS IS" BASIS,
 12  
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 13  
  * See the License for the specific language governing permissions and
 14  
  * limitations under the License.
 15  
  */
 16  
 package org.kuali.rice.kns.web.struts.form;
 17  
 
 18  
 import java.util.Enumeration;
 19  
 import java.util.HashSet;
 20  
 import java.util.Map;
 21  
 import java.util.Set;
 22  
 
 23  
 import javax.servlet.http.HttpServletRequest;
 24  
 
 25  
 import org.apache.commons.lang.StringUtils;
 26  
 import org.kuali.rice.kns.lookup.HtmlData;
 27  
 import org.kuali.rice.kns.lookup.LookupUtils;
 28  
 import org.kuali.rice.kns.util.KNSConstants;
 29  
 import org.kuali.rice.kns.util.PagingBannerUtils;
 30  
 
 31  
 /**
 32  
  * Form to handle multiple value lookups 
 33  
  * 
 34  
  * @author Kuali Rice Team (rice.collab@kuali.org)
 35  
  *
 36  
  */
 37  
 public class MultipleValueLookupForm extends LookupForm {
 38  0
     private static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(MultipleValueLookupForm.class);
 39  
     
 40  
     private KualiTableRenderFormMetadata tableMetadata;
 41  
     
 42  
     private String lookupResultsSequenceNumber;
 43  
     
 44  
     /**
 45  
      * @see org.kuali.rice.kns.web.struts.form.LookupForm#addRequiredNonEditableProperties()
 46  
      */
 47  
     @Override
 48  
     public void addRequiredNonEditableProperties(){
 49  0
             super.addRequiredNonEditableProperties();
 50  0
             registerRequiredNonEditableProperty(KNSConstants.LOOKUP_RESULTS_SEQUENCE_NUMBER);
 51  0
             registerRequiredNonEditableProperty(KNSConstants.LOOKED_UP_COLLECTION_NAME);
 52  0
     }
 53  
     
 54  
     /**
 55  
      * The number of rows that match the query criteria
 56  
      */
 57  
     private int resultsActualSize;
 58  
     
 59  
     /**
 60  
      * The number of rows that match the query criteria or
 61  
      *  the max results limit size (if applicable), whichever is less
 62  
      */
 63  
     private int resultsLimitedSize;
 64  
     
 65  
     /**
 66  
      * when the looked results screen was rendered, the index of the column that the results were sorted on.  -1 for unknown, index numbers
 67  
      * starting at 0
 68  
      */
 69  
     private String previouslySortedColumnIndex;
 70  
     
 71  
     /**
 72  
      * Comment for <code>columnToSortIndex</code>
 73  
      */
 74  
     private int columnToSortIndex;
 75  
     
 76  
     /**
 77  
      * the name of the collection being looked up by the calling page.  This value will be returned unmodified to the 
 78  
      * calling page (indicated by super.getBackLocation()), which should use it to determine in which collection the 
 79  
      * selected results will be returned.
 80  
      */
 81  
     private String lookedUpCollectionName;
 82  
     
 83  
     /**
 84  
      * Those object IDs that were selected before the current page is rendered 
 85  
      */
 86  
     private Set<String> previouslySelectedObjectIdSet;
 87  
     /**
 88  
      * Those object IDs that are rendered on the current page
 89  
      */
 90  
     private Set<String> displayedObjectIdSet;
 91  
     /**
 92  
      * Those object IDs that are selected/checked on the current page
 93  
      */
 94  
     private Set<String> selectedObjectIdSet;
 95  
     /**
 96  
      * The object IDs that are selected after the struts action is complete; the obj IDs in the keys of this Map will be considered checked in the UI
 97  
      */
 98  
     private Map<String, String> compositeObjectIdMap;
 99  
     
 100  0
     public MultipleValueLookupForm() {
 101  0
         tableMetadata = new KualiTableRenderFormMetadata();
 102  0
         setHtmlDataType(HtmlData.INPUT_HTML_DATA_TYPE);
 103  0
     }
 104  
     
 105  
     @Override
 106  
     public void populate(HttpServletRequest request) {
 107  0
         super.populate(request);
 108  
         
 109  0
         if (StringUtils.isNotBlank(request.getParameter(KNSConstants.TableRenderConstants.VIEWED_PAGE_NUMBER))) {
 110  0
             setViewedPageNumber(Integer.parseInt(request.getParameter(KNSConstants.TableRenderConstants.VIEWED_PAGE_NUMBER)));
 111  
         }
 112  
         else {
 113  0
             setViewedPageNumber(0); // first page is page 0
 114  
         }
 115  
         
 116  0
         if (KNSConstants.TableRenderConstants.SWITCH_TO_PAGE_METHOD.equals(getMethodToCall())) {
 117  0
             final String paramPrefix = KNSConstants.DISPATCH_REQUEST_PARAMETER + "." + KNSConstants.TableRenderConstants.SWITCH_TO_PAGE_METHOD + ".";
 118  0
                 setSwitchToPageNumber(PagingBannerUtils.getNumbericalValueAfterPrefix(paramPrefix, request.getParameterNames()));
 119  0
             if (getSwitchToPageNumber() == -1) {
 120  0
                 throw new RuntimeException("Couldn't find page number");
 121  
             }
 122  
         }
 123  
         
 124  0
         if (KNSConstants.TableRenderConstants.SORT_METHOD.equals(getMethodToCall())) {
 125  0
             final String paramPrefix = KNSConstants.DISPATCH_REQUEST_PARAMETER + "." + KNSConstants.TableRenderConstants.SORT_METHOD + ".";
 126  0
             setColumnToSortIndex(PagingBannerUtils.getNumbericalValueAfterPrefix(paramPrefix, request.getParameterNames()));
 127  0
             if (getColumnToSortIndex() == -1) {
 128  0
                 throw new RuntimeException("Couldn't find column to sort");
 129  
             }
 130  
         }
 131  
         
 132  0
         setPreviouslySelectedObjectIdSet(parsePreviouslySelectedObjectIds(request));
 133  0
         setSelectedObjectIdSet(parseSelectedObjectIdSet(request));
 134  0
         setDisplayedObjectIdSet(parseDisplayedObjectIdSet(request));
 135  
 
 136  0
         setSearchUsingOnlyPrimaryKeyValues(parseSearchUsingOnlyPrimaryKeyValues(request));
 137  0
         if (isSearchUsingOnlyPrimaryKeyValues()) {
 138  0
             setPrimaryKeyFieldLabels(getLookupable().getPrimaryKeyFieldLabels());
 139  
         }
 140  0
     }
 141  
     
 142  
 
 143  
     
 144  
     /**
 145  
      * This method converts the composite object IDs into a String
 146  
      * @return
 147  
      */
 148  
     public String getCompositeSelectedObjectIds() {
 149  0
         return LookupUtils.convertSetOfObjectIdsToString(getCompositeObjectIdMap().keySet());
 150  
     }
 151  
 
 152  
     protected Set<String> parsePreviouslySelectedObjectIds(HttpServletRequest request) {
 153  0
         String previouslySelectedObjectIds = request.getParameter(KNSConstants.MULTIPLE_VALUE_LOOKUP_PREVIOUSLY_SELECTED_OBJ_IDS_PARAM);
 154  0
         return LookupUtils.convertStringOfObjectIdsToSet(previouslySelectedObjectIds);
 155  
     }
 156  
     
 157  
     protected Set<String> parseSelectedObjectIdSet(HttpServletRequest request) {
 158  0
         Set<String> set = new HashSet<String>();
 159  
         
 160  0
         Enumeration paramNames = request.getParameterNames();
 161  0
         while (paramNames.hasMoreElements()) {
 162  0
             String paramName = (String) paramNames.nextElement();
 163  0
             if (paramName.startsWith(KNSConstants.MULTIPLE_VALUE_LOOKUP_SELECTED_OBJ_ID_PARAM_PREFIX) && StringUtils.isNotBlank(request.getParameter(paramName))) {
 164  0
                 set.add(StringUtils.substringAfter(paramName, KNSConstants.MULTIPLE_VALUE_LOOKUP_SELECTED_OBJ_ID_PARAM_PREFIX));
 165  
             }
 166  0
         }
 167  0
         return set;
 168  
     }
 169  
     
 170  
     protected Set<String> parseDisplayedObjectIdSet(HttpServletRequest request) {
 171  0
         Set<String> set = new HashSet<String>();
 172  
         
 173  0
         Enumeration paramNames = request.getParameterNames();
 174  0
         while (paramNames.hasMoreElements()) {
 175  0
             String paramName = (String) paramNames.nextElement();
 176  0
             if (paramName.startsWith(KNSConstants.MULTIPLE_VALUE_LOOKUP_DISPLAYED_OBJ_ID_PARAM_PREFIX) && StringUtils.isNotBlank(request.getParameter(paramName))) {
 177  0
                 set.add(StringUtils.substringAfter(paramName, KNSConstants.MULTIPLE_VALUE_LOOKUP_DISPLAYED_OBJ_ID_PARAM_PREFIX));
 178  
             }
 179  0
         }
 180  0
         return set;
 181  
     }
 182  
     
 183  
     /**
 184  
      * Iterates through the request params, looks for the parameter representing the method to call in the format like
 185  
      * methodToCall.sort.1.(::;true;::).x, and returns the boolean value in the (::; and ;::) delimiters.
 186  
      * 
 187  
      * @see MultipleValueLookupForm#parseSearchUsingOnlyPrimaryKeyValues(String)
 188  
      * 
 189  
      * @param request
 190  
      * @return
 191  
      */
 192  
     protected boolean parseSearchUsingOnlyPrimaryKeyValues(HttpServletRequest request) {
 193  
         // the param we're looking for looks like: methodToCall.sort.1.(::;true;::).x , we want to parse out the "true" component
 194  0
         String paramPrefix = KNSConstants.DISPATCH_REQUEST_PARAMETER + "." + getMethodToCall() + ".";
 195  0
         for (Enumeration i = request.getParameterNames(); i.hasMoreElements();) {
 196  0
             String parameterName = (String) i.nextElement();
 197  0
             if (parameterName.startsWith(paramPrefix) && parameterName.endsWith(".x")) {
 198  0
                 return parseSearchUsingOnlyPrimaryKeyValues(parameterName);
 199  
             }
 200  0
         }
 201  
         // maybe doing an initial search, so no value will be present 
 202  0
         return false;
 203  
     }
 204  
     
 205  
     /**
 206  
      * Parses the method to call parameter passed in as a post parameter
 207  
      * 
 208  
      * The parameter should be something like methodToCall.sort.1.(::;true;::).x, this method will return the value
 209  
      * between (::; and ;::) as a boolean
 210  
      * 
 211  
      * @param methodToCallParam the method to call in a format described above
 212  
      * @return the value between the delimiters, false if there are no delimiters
 213  
      */
 214  
     protected boolean parseSearchUsingOnlyPrimaryKeyValues(String methodToCallParam) {
 215  0
         String searchUsingOnlyPrimaryKeyValuesStr = StringUtils.substringBetween(methodToCallParam, KNSConstants.METHOD_TO_CALL_PARM12_LEFT_DEL, KNSConstants.METHOD_TO_CALL_PARM12_RIGHT_DEL);
 216  0
         if (StringUtils.isBlank(searchUsingOnlyPrimaryKeyValuesStr)) {
 217  0
             return false;
 218  
         }
 219  0
         return Boolean.parseBoolean(searchUsingOnlyPrimaryKeyValuesStr);
 220  
     }
 221  
     
 222  
     public int getViewedPageNumber() {
 223  0
         return tableMetadata.getViewedPageNumber();
 224  
     }
 225  
 
 226  
     public void setViewedPageNumber(int pageNumberBeingViewedForMultivalueLookups) {
 227  0
         tableMetadata.setViewedPageNumber(pageNumberBeingViewedForMultivalueLookups);
 228  0
     }
 229  
 
 230  
     public String getLookupResultsSequenceNumber() {
 231  0
         return lookupResultsSequenceNumber;
 232  
     }
 233  
 
 234  
     public void setLookupResultsSequenceNumber(String lookupResultSequenceNumber) {
 235  0
         this.lookupResultsSequenceNumber = lookupResultSequenceNumber;
 236  0
     }
 237  
     
 238  
     public int getTotalNumberOfPages() {
 239  0
         return tableMetadata.getTotalNumberOfPages();
 240  
     }
 241  
 
 242  
     public void setTotalNumberOfPages(int totalNumberOfPages) {
 243  0
         tableMetadata.setTotalNumberOfPages(totalNumberOfPages);
 244  0
     }
 245  
 
 246  
     public int getFirstRowIndex() {
 247  0
         return tableMetadata.getFirstRowIndex();
 248  
     }
 249  
 
 250  
     public void setFirstRowIndex(int firstRowIndex) {
 251  0
         tableMetadata.setFirstRowIndex(firstRowIndex);
 252  0
     }
 253  
 
 254  
     public int getLastRowIndex() {
 255  0
         return tableMetadata.getLastRowIndex();
 256  
     }
 257  
 
 258  
     public void setLastRowIndex(int lastRowIndex) {
 259  0
         tableMetadata.setLastRowIndex(lastRowIndex);
 260  0
     }
 261  
 
 262  
     public int getSwitchToPageNumber() {
 263  0
         return tableMetadata.getSwitchToPageNumber();
 264  
     }
 265  
 
 266  
     protected void setSwitchToPageNumber(int switchToPageNumber) {
 267  0
         tableMetadata.setSwitchToPageNumber(switchToPageNumber);
 268  0
     }
 269  
 
 270  
     public Set<String> getPreviouslySelectedObjectIdSet() {
 271  0
         return previouslySelectedObjectIdSet;
 272  
     }
 273  
 
 274  
     public void setPreviouslySelectedObjectIdSet(Set<String> previouslySelectedObjectIds) {
 275  0
         this.previouslySelectedObjectIdSet = previouslySelectedObjectIds;
 276  0
     }
 277  
 
 278  
     public Set<String> getSelectedObjectIdSet() {
 279  0
         return selectedObjectIdSet;
 280  
     }
 281  
 
 282  
     public void setSelectedObjectIdSet(Set<String> selectedObjectIdSet) {
 283  0
         this.selectedObjectIdSet = selectedObjectIdSet;
 284  0
     }
 285  
 
 286  
     public Set<String> getDisplayedObjectIdSet() {
 287  0
         return displayedObjectIdSet;
 288  
     }
 289  
 
 290  
     public void setDisplayedObjectIdSet(Set<String> displayedObjectIdSet) {
 291  0
         this.displayedObjectIdSet = displayedObjectIdSet;
 292  0
     }
 293  
 
 294  
     public Map<String, String> getCompositeObjectIdMap() {
 295  0
         return compositeObjectIdMap;
 296  
     }
 297  
 
 298  
     public void setCompositeObjectIdMap(Map<String, String> compositeObjectIdMap) {
 299  0
         this.compositeObjectIdMap = compositeObjectIdMap;
 300  0
     }
 301  
 
 302  
     public int getColumnToSortIndex() {
 303  0
         return columnToSortIndex;
 304  
     }
 305  
 
 306  
     public void setColumnToSortIndex(int columnToSortIndex) {
 307  0
         this.columnToSortIndex = columnToSortIndex;
 308  0
     }
 309  
 
 310  
     public String getPreviouslySortedColumnIndex() {
 311  0
         return previouslySortedColumnIndex;
 312  
     }
 313  
 
 314  
     public void setPreviouslySortedColumnIndex(String previouslySortedColumnIndex) {
 315  0
         this.previouslySortedColumnIndex = previouslySortedColumnIndex;
 316  0
     }
 317  
 
 318  
     /**
 319  
      * gets the name of the collection being looked up by the calling page.  This value will be returned unmodified to the 
 320  
      * calling page (indicated by super.getBackLocation()), which should use it to determine in which collection the 
 321  
      * selected results will be returned.
 322  
      * 
 323  
      * @return
 324  
      */
 325  
     public String getLookedUpCollectionName() {
 326  0
         return lookedUpCollectionName;
 327  
     }
 328  
 
 329  
     /**
 330  
      * sets the name of the collection being looked up by the calling page.  This value will be returned unmodified to the 
 331  
      * calling page (indicated by super.getBackLocation()), which should use it to determine in which collection the 
 332  
      * selected results will be returned
 333  
      * 
 334  
      * @param lookedUpCollectionName
 335  
      */
 336  
     public void setLookedUpCollectionName(String lookedUpCollectionName) {
 337  0
         this.lookedUpCollectionName = lookedUpCollectionName;
 338  0
     }
 339  
 
 340  
     public int getResultsActualSize() {
 341  0
         return resultsActualSize;
 342  
     }
 343  
 
 344  
     public void setResultsActualSize(int resultsActualSize) {
 345  0
         this.resultsActualSize = resultsActualSize;
 346  0
     }
 347  
 
 348  
     public int getResultsLimitedSize() {
 349  0
         return resultsLimitedSize;
 350  
     }
 351  
 
 352  
     public void setResultsLimitedSize(int resultsLimitedSize) {
 353  0
         this.resultsLimitedSize = resultsLimitedSize;
 354  0
     }
 355  
     
 356  
     public void jumpToFirstPage(int listSize, int maxRowsPerPage) {
 357  0
         tableMetadata.jumpToFirstPage(listSize, maxRowsPerPage);
 358  0
     }
 359  
     
 360  
     public void jumpToLastPage(int listSize, int maxRowsPerPage) {
 361  0
         tableMetadata.jumpToLastPage(listSize, maxRowsPerPage);
 362  0
     }
 363  
     
 364  
     public void jumpToPage(int pageNumber, int listSize, int maxRowsPerPage) {
 365  0
         tableMetadata.jumpToPage(pageNumber, listSize, maxRowsPerPage);
 366  0
     }
 367  
 }