/*

  * Copyright 2007 The Kuali Foundation

  *

  * Licensed under the Educational Community License, Version 1.0 (the "License");

  * you may not use this file except in compliance with the License.

  * You may obtain a copy of the License at

  *

  * http://www.opensource.org/licenses/ecl1.php

  *

  * Unless required by applicable law or agreed to in writing, software

  * distributed under the License is distributed on an "AS IS" BASIS,

  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  * See the License for the specific language governing permissions and

  * limitations under the License.

  */

 package org.kuali.rice.kns.uif.field;

 import org.apache.commons.lang.StringUtils;

 import org.kuali.rice.kns.uif.core.BindingInfo;

 import org.kuali.rice.kns.uif.core.MethodInvokerConfig;

 import org.kuali.rice.kns.util.KNSUtils;

 import org.kuali.rice.kns.util.ObjectUtils;

 import org.springframework.util.MethodInvoker;

 import java.io.Serializable;

 import java.util.ArrayList;

 import java.util.HashMap;

 import java.util.List;

 import java.util.Map;

 /**

  * Holds configuration for executing a dynamic query on an <code>AttributeField</code> to

  * pull data for updating the UI

  *

  * <p>

  * There are two types of query types that can be configured and executed. The first is provided

  * completely by the framework using the <code>LookupService</code> and will perform a query

  * against the configured dataObjectClassName using the query parameters and return field mapping.

  * The second type will invoke a method that will perform the query. This can be configured using the

  * queryMethodToCall (if the method is on the view helper service), or using the queryMethodInvoker if

  * the method is on another class or object.

  * </p>

  *

  * @author Kuali Rice Team (rice.collab@kuali.org)

  */

 public class AttributeQuery implements Serializable {

     private static final long serialVersionUID = -4569905665441735255L;

     private String dataObjectClassName;

     private boolean renderNotFoundMessage;

     private String returnMessageText;

     private String returnMessageStyleClasses;

     private Map<String, String> queryFieldMapping;

     private Map<String, String> returnFieldMapping;

     private Map<String, String> additionalCriteria;

     private List<String> sortPropertyNames;

     private String queryMethodToCall;

     private List<String> queryMethodArgumentFieldList;

     private MethodInvokerConfig queryMethodInvokerConfig;

     public AttributeQuery() {

         renderNotFoundMessage = true;

         queryFieldMapping = new HashMap<String, String>();

         returnFieldMapping = new HashMap<String, String>();

         additionalCriteria = new HashMap<String, String>();

         sortPropertyNames = new ArrayList<String>();

         queryMethodArgumentFieldList = new ArrayList<String>();

     }

     /**

      * Adjusts the path on the query field mapping from property to match the binding

      * path prefix of the given <code>BindingInfo</code>

      *

      * @param bindingInfo - binding info instance to copy binding path prefix from

      */

     public void updateQueryFieldMapping(BindingInfo bindingInfo) {

         Map<String, String> adjustedQueryFieldMapping = new HashMap<String, String>();

         for (String toField : getQueryFieldMapping().keySet()) {

             String fromFieldPath = getQueryFieldMapping().get(toField);

             String adjustedFromFieldPath = bindingInfo.getPropertyAdjustedBindingPath(fromFieldPath);

             adjustedQueryFieldMapping.put(toField, adjustedFromFieldPath);

         }

         this.queryFieldMapping = adjustedQueryFieldMapping;

     }

     /**

      * Adjusts the path on the return field mapping to property to match the binding

      * path prefix of the given <code>BindingInfo</code>

      *

      * @param bindingInfo - binding info instance to copy binding path prefix from

      */

     public void updateReturnFieldMapping(BindingInfo bindingInfo) {

         Map<String, String> adjustedReturnFieldMapping = new HashMap<String, String>();

         for (String toFieldPath : getReturnFieldMapping().keySet()) {

             String adjustedToFieldPath = bindingInfo.getPropertyAdjustedBindingPath(toFieldPath);

             adjustedReturnFieldMapping.put(adjustedToFieldPath, getReturnFieldMapping().get(toFieldPath));

         }

         this.returnFieldMapping = adjustedReturnFieldMapping;

     }

     /**

      * Adjusts the path on the query method arguments field list to match the binding

      * path prefix of the given <code>BindingInfo</code>

      *

      * @param bindingInfo - binding info instance to copy binding path prefix from

      */

     public void updateQueryMethodArgumentFieldList(BindingInfo bindingInfo) {

         List<String> adjustedArgumentFieldList = new ArrayList<String>();

         for (String argumentFieldPath : getQueryMethodArgumentFieldList()) {

             String adjustedFieldPath = bindingInfo.getPropertyAdjustedBindingPath(argumentFieldPath);

             adjustedArgumentFieldList.add(adjustedFieldPath);

         }

         this.queryMethodArgumentFieldList = adjustedArgumentFieldList;

     }

     /**

      * Builds String for passing the queryFieldMapping Map as a Javascript object

      * parameter

      *

      * @return String js parameter string

      */

     public String getQueryFieldMappingJsString() {

         String queryFieldMappingJs = "{";

         for (String queryField : queryFieldMapping.keySet()) {

             if (!StringUtils.equals(queryFieldMappingJs, "{")) {

                 queryFieldMappingJs += ",";

             }

             queryFieldMappingJs += "\"" + queryField + "\":\"" + queryFieldMapping.get(queryField) + "\"";

         }

         queryFieldMappingJs += "}";

         return queryFieldMappingJs;

     }

     /**

      * Builds String for passing the returnFieldMapping Map as a Javascript object

      * parameter

      *

      * @return String js parameter string

      */

     public String getReturnFieldMappingJsString() {

         String returnFieldMappingJs = "{";

         for (String returnField : returnFieldMapping.keySet()) {

             if (!StringUtils.equals(returnFieldMappingJs, "{")) {

                 returnFieldMappingJs += ",";

             }

             returnFieldMappingJs += "\"" + returnField + "\":\"" + returnFieldMapping.get(returnField) + "\"";

         }

         returnFieldMappingJs += "}";

         return returnFieldMappingJs;

     }

     /**

      * Builds String for passing the queryMethodArgumentFieldList as a Javascript array

      *

      * @return String js parameter string

      */

     public String getQueryMethodArgumentFieldsJsString() {

         String queryMethodArgsJs = "[";

         for (String methodArg : queryMethodArgumentFieldList) {

             if (!StringUtils.equals(queryMethodArgsJs, "{")) {

                 queryMethodArgsJs += ",";

             }

             queryMethodArgsJs += "\"" + methodArg + "\"";

         }

         queryMethodArgsJs += "]";

         return queryMethodArgsJs;

     }

     /**

      * Indicates whether this attribute query is configured to invoke a custom

      * method as opposed to running the general object query. If either the query method

      * to call is given, or the query method invoker is not null it is assumed the

      * intention is to call a custom method

      *

      * @return boolean true if a custom method is configured, false if not

      */

     public boolean hasConfiguredMethod() {

         boolean configuredMethod = false;

         if (StringUtils.isNotBlank(getQueryMethodToCall())) {

             configuredMethod = true;

         } else if (getQueryMethodInvokerConfig() != null) {

             configuredMethod = true;

         }

         return configuredMethod;

     }

     /**

      * Class name for the data object the query should be performed against

      *

      * @return String data object class name

      */

     public String getDataObjectClassName() {

         return dataObjectClassName;

     }

     /**

      * Setter for the query data object class name

      *

      * @param dataObjectClassName

      */

     public void setDataObjectClassName(String dataObjectClassName) {

         this.dataObjectClassName = dataObjectClassName;

     }

     /**

      * Configures the query parameters by mapping fields in the view

      * to properties on the data object class for the query

      *

      * <p>

      * Each map entry configures one parameter for the query, where

      * the map key is the field name to pull the value from, and the

      * map value is the property name on the object the parameter should

      * populate.

      * </p>

      *

      * @return Map<String, String> mapping of query parameters

      */

     public Map<String, String> getQueryFieldMapping() {

         return queryFieldMapping;

     }

     /**

      * Setter for the query parameter mapping

      *

      * @param queryFieldMapping

      */

     public void setQueryFieldMapping(Map<String, String> queryFieldMapping) {

         this.queryFieldMapping = queryFieldMapping;

     }

     /**

      * Maps properties from the result object of the query to

      * fields in the view

      *

      * <p>

      * Each map entry configures one return mapping, where the map

      * key is the field name for the field to populate, and the map

      * values is the name of the property on the result object to

      * pull the value from

      * </p>

      *

      * @return Map<String, String> return field mapping

      */

     public Map<String, String> getReturnFieldMapping() {

         return returnFieldMapping;

     }

     /**

      * Setter for the return field mapping

      *

      * @param returnFieldMapping

      */

     public void setReturnFieldMapping(Map<String, String> returnFieldMapping) {

         this.returnFieldMapping = returnFieldMapping;

     }

     /**

      * Fixed criteria that will be appended to the dynamic criteria generated

      * for the query. Map key gives name of the property the criteria should

      * apply to, and the map value is the value (literal) for the criteria. Standard

      * lookup wildcards are allowed

      *

      * @return Map<String, String> field name/value pairs for query criteria

      */

     public Map<String, String> getAdditionalCriteria() {

         return additionalCriteria;

     }

     /**

      * Setter for the query's additional criteria map

      *

      * @param additionalCriteria

      */

     public void setAdditionalCriteria(Map<String, String> additionalCriteria) {

         this.additionalCriteria = additionalCriteria;

     }

     /**

      * List of property names to sort the query results by. The sort

      * will be performed on each property in the order they are contained

      * within the list. Each property must be a valid property of the

      * return query object (the data object in case of the general query)

      *

      * @return List<String> property names

      */

     public List<String> getSortPropertyNames() {

         return sortPropertyNames;

     }

     /**

      * Setter for the list of property names to sort results by

      *

      * @param sortPropertyNames

      */

     public void setSortPropertyNames(List<String> sortPropertyNames) {

         this.sortPropertyNames = sortPropertyNames;

     }

     /**

      * Indicates whether a message should be added to the query result

      * object and displayed when the query return object is null

      *

      * @return boolean true if not found message should be added, false otherwise

      */

     public boolean isRenderNotFoundMessage() {

         return renderNotFoundMessage;

     }

     /**

      * Setter for the render not found message indicator

      *

      * @param renderNotFoundMessage

      */

     public void setRenderNotFoundMessage(boolean renderNotFoundMessage) {

         this.renderNotFoundMessage = renderNotFoundMessage;

     }

     /**

      * Message text to display along with the query result

      *

      * @return String literal message text

      */

     public String getReturnMessageText() {

         return returnMessageText;

     }

     /**

      * Setter for the return message text

      *

      * @param returnMessageText

      */

     public void setReturnMessageText(String returnMessageText) {

         this.returnMessageText = returnMessageText;

     }

     /**

      * CSS Style classes that should be applied to the return message.

      * Multiple style classes should be delimited by a space

      *

      * @return String style classes

      */

     public String getReturnMessageStyleClasses() {

         return returnMessageStyleClasses;

     }

     /**

      * Setter for the return messages style classes

      *

      * @param returnMessageStyleClasses

      */

     public void setReturnMessageStyleClasses(String returnMessageStyleClasses) {

         this.returnMessageStyleClasses = returnMessageStyleClasses;

     }

     /**

      * Configures the name of the method that should be invoked to perform

      * the query

      *

      * <p>

      * Should contain only the method name (no parameters or return type). If only

      * the query method name is configured it is assumed to be on the <code>ViewHelperService</code>

      * for the contained view.

      * </p>

      *

      * @return String query method name

      */

     public String getQueryMethodToCall() {

         return queryMethodToCall;

     }

     /**

      * Setter for the query method name

      *

      * @param queryMethodToCall

      */

     public void setQueryMethodToCall(String queryMethodToCall) {

         this.queryMethodToCall = queryMethodToCall;

     }

     /**

      * List of field names that should be passed as arguments to the query method

      *

      * <p>

      * Each entry in the list maps to a method parameter, in the other contained within

      * the list. The value for the field within the view will be pulled and passed

      * to the query method as an argument

      * </p>

      *

      * @return List<String> query method argument list

      */

     public List<String> getQueryMethodArgumentFieldList() {

         return queryMethodArgumentFieldList;

     }

     /**

      * Setter for the query method argument list

      *

      * @param queryMethodArgumentFieldList

      */

     public void setQueryMethodArgumentFieldList(List<String> queryMethodArgumentFieldList) {

         this.queryMethodArgumentFieldList = queryMethodArgumentFieldList;

     }

     /**

      * Configures the query method target class/object and method name

      *

      * <p>

      * When the query method is not contained on the <code>ViewHelperService</code>, this

      * can be configured for declaring the target class/object and method. The target class

      * can be set in which case a new instance will be created and the given method invoked.

      * Alternatively, the target object instance for the invocation can be given. Or finally

      * a static method can be configured

      * </p>

      *

      * @return MethodInvokerConfig query method config

      */

     public MethodInvokerConfig getQueryMethodInvokerConfig() {

         return queryMethodInvokerConfig;

     }

     /**

      * Setter for the query method config

      *

      * @param queryMethodInvokerConfig

      */

     public void setQueryMethodInvokerConfig(MethodInvokerConfig queryMethodInvokerConfig) {

         this.queryMethodInvokerConfig = queryMethodInvokerConfig;

     }

 }