/**

  * Copyright 2005-2011 The Kuali Foundation

  *

  * Licensed under the Educational Community License, Version 2.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/ecl2.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.krad.uif.container;

 import org.apache.commons.lang.StringUtils;

 import org.kuali.rice.krad.uif.component.Component;

 import org.kuali.rice.krad.uif.component.DataBinding;

 import org.kuali.rice.krad.uif.field.Field;

 import org.kuali.rice.krad.uif.field.FieldGroup;

 import org.kuali.rice.krad.uif.view.View;

 import org.kuali.rice.krad.uif.widget.Disclosure;

 import java.util.ArrayList;

 import java.util.HashSet;

 import java.util.List;

 import java.util.Set;

 /**

  * Container that holds a list of <code>Field</code> or other <code>Group</code>

  * instances

  * 

  * <p>

  * Groups can exist at different levels of the <code>View</code>, providing

  * conceptual groupings such as the page, section, and group. In addition, other

  * group types can be created to add behavior like collection support

  * </p>

  * 

  * <p>

  * <code>Group</code> implementation has properties for defaulting the binding

  * information (such as the parent object path and a binding prefix) for the

  * fields it contains. During the phase these properties (if given) are set on

  * the fields contained in the <code>Group</code> that implement

  * <code>DataBinding</code>, unless they have already been set on the field.

  * </p>

  * 

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

  */

 public class Group extends ContainerBase {

         private static final long serialVersionUID = 7953641325356535509L;

         private String fieldBindByNamePrefix;

         private String fieldBindingObjectPath;

         private Disclosure disclosure;

         private List<? extends Component> items;

         /**

          * Default Constructor

          */

         public Group() {

                 items = new ArrayList<Component>();

         }

         /**

          * The following actions are performed:

          * 

          * <ul>

          * <li>Sets the bindByNamePrefix if blank on any InputField and

          * FieldGroup instances within the items List</li>

          * </ul>

          * 

          * @see org.kuali.rice.krad.uif.component.ComponentBase#performInitialization(org.kuali.rice.krad.uif.view.View, java.lang.Object)

          */

     @Override

     public void performInitialization(View view, Object model) {

         super.performInitialization(view, model);

         for (Component component : getItems()) {

             // append group's field bind by name prefix (if set) to each

             // attribute field's binding prefix

             if (component instanceof DataBinding) {

                 DataBinding dataBinding = (DataBinding) component;

                 if (StringUtils.isNotBlank(getFieldBindByNamePrefix())) {

                     String bindByNamePrefixToSet = getFieldBindByNamePrefix();

                     if (StringUtils.isNotBlank(dataBinding.getBindingInfo().getBindByNamePrefix())) {

                         bindByNamePrefixToSet += "." + dataBinding.getBindingInfo().getBindByNamePrefix();

                     }

                     dataBinding.getBindingInfo().setBindByNamePrefix(bindByNamePrefixToSet);

                 }

                 if (StringUtils.isNotBlank(fieldBindingObjectPath) &&

                         StringUtils.isBlank(dataBinding.getBindingInfo().getBindingObjectPath())) {

                     dataBinding.getBindingInfo().setBindingObjectPath(fieldBindingObjectPath);

                 }

             }

             // set on FieldGroup's group to recursively set AttributeFields

             else if (component instanceof FieldGroup) {

                 FieldGroup fieldGroup = (FieldGroup) component;

                 if (fieldGroup.getGroup() != null) {

                     if (StringUtils.isBlank(fieldGroup.getGroup().getFieldBindByNamePrefix())) {

                         fieldGroup.getGroup().setFieldBindByNamePrefix(fieldBindByNamePrefix);

                     }

                     if (StringUtils.isBlank(fieldGroup.getGroup().getFieldBindingObjectPath())) {

                         fieldGroup.getGroup().setFieldBindingObjectPath(fieldBindingObjectPath);

                     }

                 }

             } else if (component instanceof Group) {

                 Group subGroup = (Group) component;

                 if (StringUtils.isNotBlank(getFieldBindByNamePrefix())) {

                     if (StringUtils.isNotBlank(subGroup.getFieldBindByNamePrefix())) {

                         subGroup.setFieldBindByNamePrefix(

                                 getFieldBindByNamePrefix() + "." + subGroup.getFieldBindByNamePrefix());

                     } else {

                         subGroup.setFieldBindByNamePrefix(getFieldBindByNamePrefix());

                     }

                 }

             }

         }

     }

         /**

          * @see org.kuali.rice.krad.uif.component.ComponentBase#getComponentsForLifecycle()

          */

         @Override

         public List<Component> getComponentsForLifecycle() {

                 List<Component> components = super.getComponentsForLifecycle();

                 components.add(disclosure);

                 return components;

         }

         /**

          * @see org.kuali.rice.krad.web.view.container.ContainerBase#getSupportedComponents()

          */

         @Override

         public Set<Class<? extends Component>> getSupportedComponents() {

                 Set<Class<? extends Component>> supportedComponents = new HashSet<Class<? extends Component>>();

                 supportedComponents.add(Field.class);

                 supportedComponents.add(Group.class);

                 return supportedComponents;

         }

         /**

          * @see org.kuali.rice.krad.uif.component.Component#getComponentTypeName()

          */

         @Override

         public final String getComponentTypeName() {

                 return "group";

         }

         /**

          * Binding prefix string to set on each of the groups <code>DataField</code> instances

      *

          * <p>

          * As opposed to setting the bindingPrefix on each attribute field instance,

          * it can be set here for the group. During initialize the string will then

          * be set on each attribute field instance if the bindingPrefix is blank and

          * not a form field

          * </p>

          * 

          * @return String binding prefix to set

          */

         public String getFieldBindByNamePrefix() {

                 return this.fieldBindByNamePrefix;

         }

         /**

          * Setter for the field binding prefix

          * 

          * @param fieldBindByNamePrefix

          */

         public void setFieldBindByNamePrefix(String fieldBindByNamePrefix) {

                 this.fieldBindByNamePrefix = fieldBindByNamePrefix;

         }

         /**

          * Object binding path to set on each of the group's

          * <code>InputField</code> instances

          * 

          * <p>

          * When the attributes of the group belong to a object whose path is

          * different from the default then this property can be given to set each of

          * the attributes instead of setting the model path on each one. The object

          * path can be overridden at the attribute level. The object path is set to

          * the fieldBindingObjectPath during the initialize phase.

          * </p>

          * 

          * @return String model path to set

          * @see org.kuali.rice.krad.uif.BindingInfo.getBindingObjectPath()

          */

         public String getFieldBindingObjectPath() {

                 return this.fieldBindingObjectPath;

         }

         /**

          * Setter for the field object binding path

          * 

          * @param fieldBindingObjectPath

          */

         public void setFieldBindingObjectPath(String fieldBindingObjectPath) {

                 this.fieldBindingObjectPath = fieldBindingObjectPath;

         }

         /**

          * Disclosure widget that provides collapse/expand functionality for the

          * group

          * 

          * @return Accordion instance

          */

         public Disclosure getDisclosure() {

                 return this.disclosure;

         }

         /**

          * Setter for the group's disclosure instance

          * 

          * @param disclosure

          */

         public void setDisclosure(Disclosure disclosure) {

                 this.disclosure = disclosure;

         }

         /**

          * @see org.kuali.rice.krad.uif.container.ContainerBase#getItems()

          */

         @Override

         public List<? extends Component> getItems() {

                 return this.items;

         }

         /**

          * Setter for the Group's list of components

          * 

          * @param items

          */

         @Override

         public void setItems(List<? extends Component> items) {

                 this.items = items;

         }

 }