All Downloads are FREE. Search and download functionalities are using the official Maven repository.

de.tsl2.nano.bean.def.BeanCollector Maven / Gradle / Ivy

Go to download

TSL2 Framework Descriptor (currency-handling, generic formatter, descriptors for beans, collections, actions and values)

There is a newer version: 2.5.1
Show newest version
/*
 * File: $HeadURL$
 * Id  : $Id$
 * 
 * created by: Thomas Schneider
 * created on: Jul 20, 2012
 * 
 * Copyright: (c) Thomas Schneider 2012, all rights reserved
 */
package de.tsl2.nano.bean.def;

import java.io.IOException;
import java.io.Serializable;
import java.lang.reflect.Proxy;
import java.sql.Timestamp;
import java.text.Format;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Iterator;
import java.util.LinkedHashMap;
import java.util.LinkedHashSet;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;

import org.apache.commons.logging.Log;
import org.simpleframework.xml.Default;
import org.simpleframework.xml.DefaultType;
import org.simpleframework.xml.Transient;
import org.simpleframework.xml.core.Commit;

import de.tsl2.nano.action.CommonAction;
import de.tsl2.nano.action.IAction;
import de.tsl2.nano.action.IActivable;
import de.tsl2.nano.bean.BeanContainer;
import de.tsl2.nano.bean.BeanUtil;
import de.tsl2.nano.bean.IAttributeDef;
import de.tsl2.nano.bean.ValueHolder;
import de.tsl2.nano.collection.CollectionUtil;
import de.tsl2.nano.collection.Entry;
import de.tsl2.nano.collection.FilteringIterator;
import de.tsl2.nano.collection.MapEntrySet;
import de.tsl2.nano.core.ENV;
import de.tsl2.nano.core.IPredicate;
import de.tsl2.nano.core.ManagedException;
import de.tsl2.nano.core.Messages;
import de.tsl2.nano.core.cls.BeanAttribute;
import de.tsl2.nano.core.cls.BeanClass;
import de.tsl2.nano.core.cls.IAttribute;
import de.tsl2.nano.core.exception.Message;
import de.tsl2.nano.core.execution.Profiler;
import de.tsl2.nano.core.log.LogFactory;
import de.tsl2.nano.core.util.DateUtil;
import de.tsl2.nano.core.util.FormatUtil;
import de.tsl2.nano.core.util.NumberUtil;
import de.tsl2.nano.core.util.StringUtil;
import de.tsl2.nano.core.util.Util;
import de.tsl2.nano.util.DelegatorProxy;

/**
 * see {@link IBeanCollector}. the collector inherits from {@link BeanDefinition}.
 * 
 * @author Thomas Schneider
 * @version $Revision$
 */
@SuppressWarnings({ "rawtypes", "unchecked", "serial" })
@Default(value = DefaultType.FIELD, required = false)
public class BeanCollector, T> extends BeanDefinition implements
        IBeanCollector {

	public static final String ACTION_OPEN = "open";
	public static final String ACTION_NEW = "new";
    public static final String ACTION_DELETE = "delete";

	/** serialVersionUID */
    private static final long serialVersionUID = -5260557109700841750L;

    private static final Log LOG = LogFactory.getLog(BeanCollector.class);

    public static final String POSTFIX_COLLECTOR = ".collector";

    public static final String POSTFIX_QUICKSEARCH = "quicksearch";

    public static final String KEY_COMMANDHANDLER = "bean.commandhandler";

    /** static data or current data representation of this beancollector */
    protected transient COLLECTIONTYPE collection;
    protected transient boolean isStaticCollection = false;

    /** defines the data for this collector through it's getData() method */
    protected transient IBeanFinder beanFinder;
    /** holds the current selection */
    protected transient ISelectionProvider selectionProvider;

    /**
     * holds the connection to the composition parent. if not null, the beancollector will work only on items having a
     * connection to this composition (uml-composition where childs can't exist without it's parent!).
     */
    @Transient
    protected Composition composition;

    protected transient IAction newAction;
    protected transient IAction editAction;
    protected transient IAction deleteAction;
    /** the extending class has to set an instance for the ok action to set it as default button */
    protected transient IAction openAction;

    /** defines the behavior and the actions of the beancollector */
    @Transient
    protected int workingMode = MODE_EDITABLE | MODE_CREATABLE | MODE_SEARCHABLE;
    
    /**
     * search panel instructions.
     */
    protected transient IAction searchAction;
    protected transient IAction quickSearchAction;
    protected transient IAction resetAction;
    protected transient String searchStatus = INIT_SEARCH_STATUS;

    static final String INIT_SEARCH_STATUS = Messages.getString("tsl2nano.searchdialog.nosearch");

    /** whether to refresh data from beancontainer before opening edit-dialog */
    @Transient
    protected boolean reloadBean = true;

//    @ElementList(name = "column", inline = true, required = false/*, type=ValueColumn.class*/)
    private transient Collection columnDefinitions;

    /** temporary variable to hold the {@link #toString()} output (--> performance) */
    private transient String asString;

    /** on each activation, we do a count on the database */
    private transient long lastCount = -2;

    /**
     * the beancollector should listen to any change of the search-panel (beanfinders range-bean) to know which action
     * should have the focus
     */
    private transient Boolean hasSearchRequestChanged;

    /** pointer to the current row to be build/painted/evaluated */
    private transient Iterator iterator = null;

    /**
     * constructor. should only used by framework - for de-serialization.
     */
    public BeanCollector() {
        super();
    }

    /**
     * see constructor {@link #CollectionEditorBean(IBeanFinder, boolean, boolean, boolean)}.
     */
    public BeanCollector(Class beanType, int workingMode) {
        this(new BeanFinder(beanType), workingMode, null);
    }

    /**
     * see constructor {@link #CollectionEditorBean(IBeanFinder, boolean, boolean, boolean)}.
     */
    public BeanCollector(final COLLECTIONTYPE collection, int workingMode) {
        this(collection, workingMode, null);
    }

    /**
     * see constructor {@link #CollectionEditorBean(IBeanFinder, boolean, boolean, boolean)}.
     */
    public BeanCollector(final COLLECTIONTYPE collection, int workingMode, Composition composition) {
        this((Class) collection.iterator().next().getClass(), collection, workingMode, composition);
    }

    /**
     * see constructor {@link #CollectionEditorBean(IBeanFinder, boolean, boolean, boolean)}.
     */
    public BeanCollector(Class beanType, final COLLECTIONTYPE collection, int workingMode, Composition composition) {
        this(new BeanFinder(beanType), workingMode, composition);
        this.collection = collection;
        if (isStaticCollection || !hasMode(MODE_SEARCHABLE)) {
            this.searchStatus = "";
        }
    }

    /**
     * constructor
     * 
     * @param beanFinder implementation to evaluate the data
     * @param workingMode one of {@link IBeanCollector#MODE_EDITABLE}, {@link IBeanCollector#MODE_CREATABLE} etc. Please
     *            see {@link IBeanCollector} for more modes.
     */
    public BeanCollector(IBeanFinder beanFinder, int workingMode, Composition composition) {
        super(beanFinder.getType());
        init(null, beanFinder, workingMode, composition);
    }

    /**
     * init
     * 
     * @param beanFinder implementation to evaluate the data
     * @param workingMode one of {@link IBeanCollector#MODE_EDITABLE}, {@link IBeanCollector#MODE_CREATABLE} etc. Please
     *            see {@link IBeanCollector} for more modes.
     */
    protected void init(COLLECTIONTYPE collection,
            IBeanFinder beanFinder,
            int workingMode,
            Composition composition) {
//        setName(Messages.getString("tsl2nano.list") + " " + getName());
        this.isStaticCollection = !Util.isEmpty(collection) ||
            beanFinder == null || (!isPersistable());
        this.collection = collection != null ? collection : (COLLECTIONTYPE) new LinkedList();
        setBeanFinder(beanFinder);
        //TODO: the check for attribute can't be done here - perhaps attributes will be added later!
//        if (getAttributeDefinitions().size() == 0) {
//            LOG.warn("bean-collector without showing any attribute");
//            this.workingMode = 0;
//            searchStatus = Messages.getFormattedString("tsl2nano.login.noprincipal", "...", "...");
//        } else {
        this.workingMode = workingMode;
//        }
        if (isStaticCollection) {
            searchStatus =
                Messages.getFormattedString("tsl2nano.searchdialog.searchresultcount", this.collection.size());
        }
        this.composition = composition;
        if (composition != null && composition.getTargetType() == null) {
            if (hasMode(MODE_SEARCHABLE)) {
                LOG.warn("removing MODE_SEARCHABLE - because it is a composition");
                removeMode(MODE_SEARCHABLE);
            }
        }

//        if (beanFinder != null) {
        actions = new LinkedHashSet();
        if (hasMode(MODE_SEARCHABLE)) {
            createSearchAction();
            if (hasFilter()) {
                createResetAction();
            }
        }
        if (hasMode(MODE_EDITABLE)) {
            createOpenAction();
        }
        if (hasMode(MODE_CREATABLE)) {
            createNewAction();
            createDeleteAction();
        }
//        }
        assignColumnValues();
        if (ENV.get("beandef.autoinit", true))
            autoInit(name);
    }

    /**
     * the beancollector instance itself should not be saved - this is done by its underlaying beandefinition
     */
    @Override
    protected boolean isSaveable() {
        return false;//getClass().equals(BeanCollector.class) ? false : super.isSaveable();
    }

    /**
     * getBeanType
     * 
     * @return optional beanType (content type of collection)
     */
    protected Class getType() {
        //try to evaluate the collection content type
        if (beanFinder == null) {
            if (collection != null && collection.size() > 0) {
                setBeanFinder(new BeanFinder(collection.iterator().next().getClass()));
            } else {
                setBeanFinder(new BeanFinder(super.getClazz()));
            }
        }
        return beanFinder.getType();
    }

    @Override
    public boolean isPersistable() {
        return BeanContainer.isInitialized() && BeanContainer.instance().isPersistable(getType());
    }

    @Override
    public > B onActivation(Map context) {
        super.onActivation(context);
        iterator = null;
        doAutomaticSearch();
        return (B) this;
    }

	public void doAutomaticSearch() {
		if (!isStaticCollection && Util.isEmpty(collection)) {
            long countCheck = ENV.get("collector.search.auto.count.lowerthan", 20);
            boolean dosearch = countCheck > 0 && count() < countCheck;

            //if at least one column has a search value, we start the search directly
            if (!dosearch) {
                Collection columns = getColumnDefinitions();
                for (IPresentableColumn c : columns) {
                    if (c.getMinSearchValue() != null || c.getMaxSearchValue() != null) {
                        dosearch = true;
                        break;
                    }
                }
            }
            if (dosearch) {
                getBeanFinder().getData();
            }
        }
	}

    protected long count() {
        long count = -1;
        try {
            count =
                !Util.isEmpty(collection) ? collection.size() : BeanContainer.instance().isPersistable(getType())
                    ? BeanContainer.getCount(getType()) : -1;
        } catch (Exception ex) {
            LOG.warn(getName() + " is declared as @ENTITY but has no mapped TABLE --> can't evaluate count(*)!");
        }
        if (count != lastCount)
            asString = null;
        lastCount = count;
        return lastCount;
    }

    @Override
    public void onDeactivation(Map context) {
        super.onDeactivation(context);
        iterator = null;
        /*
         * if a bean-collector was left through cancel, new created compositions must be removed!
         */
        if (composition != null) {
            for (T instance : collection) {
                Bean.getBean((Serializable) instance).onDeactivation(context);
            }
        } else {
            if (ENV.get("collector.ondeactivation.selection.clear", true))
                getSelectionProvider().getValue().clear();
        }
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public IBeanFinder getBeanFinder() {
        return beanFinder;
    }

    /**
     * @param beanFinder The beanFinder to set.
     */
    public void setBeanFinder(final IBeanFinder beanFinder) {
        if (beanFinder != null) {
            /*
             * to use the beancollectors collection, we wrap the given beanfinder
             */
            @SuppressWarnings("unused")
            Object internalBeanFinder = new Serializable() {
                boolean betweenFinderCreated = false;
                String lastExpression = null;

                //used by proxy!
                Collection getData() {
                    if (lastExpression != null) {
                        return getData(lastExpression);
                    } else {
                        Collection searchPanelBeans = getSearchPanelBeans();
                        Iterator it = searchPanelBeans.iterator();
                        T from = searchPanelBeans.size() > 0 ? it.next() : null;
                        T to = searchPanelBeans.size() > 1 ? it.next() : null;
                        String[] orderByIndexes = getOrderByColumns();
                        return getData(from, to);
                    }
                }

                public Collection getData(T from, Object to) {
                    searchStatus = Messages.getFormattedString("tsl2nano.searchdialog.searchrunning");
                    ENV.get(Profiler.class).starting(this, getName());
                    Message.send(searchStatus);
                    if (!isStaticCollection || (isPersistable() && composition == null)) {
                        collection = (COLLECTIONTYPE) ((IBeanFinder) beanFinder).getData(from, to, getOrderByColumns());
                        /*
                         * if it is a composition, all data has to be found in the compositions-parent-container
                         */
                        if (composition != null) {
                            for (Iterator it = collection.iterator(); it.hasNext();) {
                                T item = it.next();
                                if (!composition.getParentContainer().contains(item)) {
                                    it.remove();
                                }
                            }
                        }
                    } else if (!betweenFinderCreated) {
                        collection =
                            CollectionUtil.getFilteringBetween(collection, from, (T) to, true);
                        betweenFinderCreated = true;
                    }
                    /*
                     * respect authorization/permissions
                     */
                    Collection result = authorized(collection);
                    searchStatus = Messages.getFormattedString("tsl2nano.searchdialog.searchresultcount",
                        result.size());
                    Message.send(searchStatus);
                    sort();
//                    //TODO: this will be a performance issue!
//                    Message.send(" injecting new objects for rulecovers...");
//                    if (hasMode(MODE_SEARCHABLE) && hasDefaultConstructor(getType())) {
//                        T instance =
//                            getSearchPanelBeans().size() > 0 ? getSearchPanelBeans().iterator().next() : BeanClass
//                                .createInstance(getType());
//                        injectIntoRuleCovers(BeanCollector.this, instance);
//                    }
//                    for (T o : collection) {
//                        injectIntoRuleCovers(Bean.getBean(o), o);
//					}
//                    Message.send(searchStatus);
                    return result;
                }

                public Collection getData(String expression) {
                    if (!isStaticCollection) {
                        collection =
                            (COLLECTIONTYPE) getValueExpression().matchingObjects(expression);
                    } else if (!betweenFinderCreated) {
                        collection =
                            CollectionUtil.getFiltering(collection, new StringBuilder(expression));
                        betweenFinderCreated = true;
                    }
                    Collections.sort((List) collection, getValueExpression().getComparator());
                    return authorized(collection);
                }

                private Collection authorized(COLLECTIONTYPE collection) {
                    if (ENV.get("collector.check.permission.data", true)) {
                        return CollectionUtil.getFiltering(collection, new IPredicate() {
                            @Override
                            public boolean eval(T arg0) {
                                return getAttributeDefinitions().size() > 0 && BeanContainer.instance()
                                    .hasPermission(
                                        BeanClass.getDefiningClass(arg0.getClass()).getSimpleName().toLowerCase() + "."
                                            + getValueExpression().to(arg0),
                                        "read");
                            }
                        });
                    } else {
                        return collection;
                    }
                }

                public Collection previous() {
                    return (collection = (COLLECTIONTYPE) beanFinder.previous());
                }

                public Collection next() {
                    return (collection = (COLLECTIONTYPE) beanFinder.next());
                }
            };
            this.beanFinder = DelegatorProxy.delegator(IBeanFinder.class, internalBeanFinder, beanFinder);
        } else {
            this.beanFinder = null;
        }
    }

    protected String[] getOrderByColumns() {
    	Integer[] indexes = getSortIndexes();
    	String sIndexes[] = new String[indexes.length];
    	for (int i = 0; i < indexes.length; i++) {
    		IPresentableColumn col = getColumn(indexes[i]);
			boolean up = col.isSortUpDirection();
			sIndexes[i] = (up ? "+": "-") + col.getName();
		}
		return sIndexes;
	}

	/**
     * @return Returns the selectionProvider.
     */
    @Override
    public ISelectionProvider getSelectionProvider() {
        if (selectionProvider == null) {
            selectionProvider = new SelectionProvider(new LinkedList());
        }
        return selectionProvider;
    }

    /**
     * @param selectionProvider The selectionProvider to set.
     */
    public void setSelectionProvider(ISelectionProvider selectionProvider) {
        this.selectionProvider = selectionProvider;
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public boolean hasMode(int mode) {
        return NumberUtil.hasBit(workingMode, mode);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void setMode(int mode) {
        this.workingMode = mode;
    }

    @Override
    public void addMode(int modebit) {
        this.workingMode |= modebit;
    }

    @Override
    public void removeMode(int modebit) {
        workingMode = NumberUtil.filterBits(workingMode, modebit);
    }

    /**
     * getWorkingMode
     * 
     * @return
     */
    public int getWorkingMode() {
        return workingMode;
    }

    /**
     * getFirstSelectedElement
     * 
     * @return first selection element or null
     */
    protected T getFirstSelectedElement() {
        if (getSelectionProvider() == null) {
            return null;
        }
        Collection selection = getSelectionProvider().getValue();
        return selection.isEmpty() ? null : selection.iterator().next();
    }

    /**
     * hasSelection
     * 
     * @return tgrue, if at least one element was selected
     */
    public boolean hasSelection() {
        return getFirstSelectedElement() != null;
    }

    /**
     * hasFilter
     * 
     * @return true, if bean-finder could create an filter-range instance
     */
    public boolean hasFilter() {
        return getBeanFinder() != null && getBeanFinder().getFilterRange() != null;
    }

    /**
     * hasSearchRequestChanged
     * 
     * @return true, if at least one value of range-bean from or to changed.
     */
    protected boolean hasSearchRequestChanged() {
        return hasSearchRequestChanged != null ? hasSearchRequestChanged : false;
    }

    /**
     * wasActivated
     * 
     * @return true, if onActivation() was called before.
     */
    public boolean wasActivated() {
        return lastCount > -2;
    }

    /**
     * setSelectedElement
     * 
     * @param selected
     */
    public void setSelected(T... selected) {
        Collection selection = getSelectionProvider().getValue();
        selection.clear();
        if (selected != null) {
            for (int i = 0; i < selected.length; i++) {
                selection.add(selected[i]);
            }
        }
    }

    public void selectFirstElement() {
        if (getSelectionProvider() == null || collection == null || collection.isEmpty()) {
            LOG.warn("couldn't select first element - no data or selection-provider available yet!");
            return;
        }
        setSelected(collection.iterator().next());
    }

    /**
     * @return Returns the reloadBean.
     */
    public boolean isReloadBean() {
        return reloadBean;
    }

    /**
     * @param reloadBean The reloadBean to set.
     */
    public void setReloadBean(boolean reloadBean) {
        this.reloadBean = reloadBean;
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void refresh() {
        //nothing to do on default implementation
    }

    @Override
    public BeanCollector refreshed() {
        if (isStale())
            return getBeanCollector(collection, workingMode);
        return this;
    }
    
    /**
     * {@inheritDoc}
     */
    @Override
    public Object editItem(Object item) {
        return getPresentationHelper().startUICommandHandler(item);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void checkBeforeDelete(Collection selection) {
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void deleteItem(T item) {
        if (!CompositionFactory.markToPersist(item) && Bean.getBean((Serializable) item).getId() != null) {
            BeanContainer.instance().delete(item);
        }
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public T createItem(T selectedItem) {
        T newItem = null;
        Class type = getType();
        /*
         * do a copy of the selected element (only if exactly one element was selected) and the property was set.
         */
        if (selectedItem != null && getSelectionProvider() != null && getSelectionProvider().getValue().size() == 1
            && ENV.get("collector.new.clone.selected", true)
            && !(Entry.class.isAssignableFrom(type))) {
            try {
                /*
                 * don't copy composition or cascading fields!
                 */
                newItem = copySimpleValues(selectedItem);
                BeanUtil.createOwnCollectionInstances(newItem);
            } catch (final Exception e) {
                LOG.error(e);
                Message.send("Couldn't copy selected element!");
            }
        }
        if (newItem == null) {
            /*
             * there is no information how to create a new bean - at least one stored bean instance must exist!
             */
            if (type != null && Collection.class.isAssignableFrom(type)) {
                LOG.warn(
                    "There is no information how to create a new bean - at least one stored bean instance must exist!");
                return null;
            } else if (Entry.class.isAssignableFrom(type)) {
                // normally we would handle this inside the generic else block, but we need
                // the generics key and value type informations
                if (Proxy.isProxyClass(collection.getClass())) {
                    newItem = (T) ((MapEntrySet) (FilteringIterator.getIterable((Proxy) collection))).add(null, null);
                } else {
                    newItem = (T) ((MapEntrySet) (collection)).add(null, null);
                }
            } else {
                newItem = BeanContainer.instance().createBean(getType());
            }
            setDefaultValues(newItem);
        }
        /*
         * if timestamp fields are not shown, generate new timestamps
         */
        if (ENV.get("value.timestamp.default", true)) {
            //respect all attributes
            BeanClass bc = BeanClass.getBeanClass(getDeclaringClass());
            List attrs = bc.getAttributes();
//            Map> attrs = getAttributeDefinitions();
            Timestamp ts = new Timestamp(DateUtil.cutSeconds(System.currentTimeMillis()));
            for (IAttribute a : attrs) {
                IAttributeDef def = BeanContainer.instance().getAttributeDef(newItem, a.getName());
                if (def != null && !def.nullable() && def.temporalType() != null
                    && Timestamp.class.isAssignableFrom(def.temporalType())) {
//                    if (a instanceof IValueAccess) {
//                        ((IValueAccess) a).setValue(ts);
//                    } else {
                    a.setValue(newItem, ts);
//                    }
                }
            }
        }
        /*
         * the id attribute of the selected bean must not be copied!!!
         * we create a generated value for the id. if jpa annotation @GenerateValue
         * is present, it will overwrite this id.
         */
        BeanContainer.createId(newItem);

        /*
         * assign the new item to the composition parent. this should be done last, 
         * because of the equals/hash difference to existing items.
         */
        if (composition != null) {
            composition.add(newItem);
        }
        return newItem;
    }

    private T copySimpleValues(T selectedItem) {
        List names = new ArrayList(getAttributeNames().length);
        IAttributeDefinition attr;
        for (IAttribute a : getSingleValueAttributes()) {
            if (isPersistable() && a.isVirtual())
                continue;
            else if (a instanceof IAttributeDefinition) {
                attr = (IAttributeDefinition) a;
                if (attr.isMultiValue() || attr.composition() || attr.cascading()) {
                    LOG.debug(
                        "didn't copy attribute " + attr + " to new item in cause of being a composition or oneToMany");
                    continue;
                }
            }
            names.add(a.getName());
        }
        return copyValues(selectedItem, createInstance(), true, false, names.toArray(new String[0]));
    }

    @Override
    public IAction getActionByName(String name) {
    	return getAction(BeanContainer.getActionId(getType(), true, name));
    }
    
    /**
     * creates the new button with listeners inside the parent component
     * 
     * @param dform parent of search button
     */
    protected void createNewAction() {
        final String actionId = BeanContainer.getActionId(getType(), true, ACTION_NEW);
        newAction = new SecureAction(actionId,
            BeanContainer.getActionText(actionId, false),
            BeanContainer.getActionText(actionId, true),
            IAction.MODE_UNDEFINED) {
            @Override
            public Object action() throws Exception {
                T newBean = createItem(getFirstSelectedElement());
                fillContext(newBean, getParameter());
                if (newBean == null) {
                    throw new ManagedException("tsl2nano.no_type_available");
                }
                final Object result = editItem(newBean);
                if (!IAction.CANCELED.equals(result)) {
                    newBean = beanFinder.unwrapToSelectableBean(result);
                    final T finalBean = newBean;
                    final COLLECTIONTYPE values = collection;
                    values.add(newBean);
                    final Bean b = Bean.getBean((Serializable) newBean);
                    b.attach(new CommonAction() {
                        @Override
                        public Void action() throws Exception {
                            if (!values.remove(finalBean)) {
                                /*
                                 * Workaround for a HashSet on Beans with changing hashcodes.
                                 * Here we use equals() instead of hashcode()
                                 */
                                for (Iterator it = values.iterator(); it.hasNext();) {
                                    if (it.next().equals(finalBean)) {
                                        it.remove();
                                    }
                                }
                            }
                            getSelectionProvider().getValue().remove(finalBean);
                            //on an error after persisting the new persisted bean may be already added
                            values.remove(b.getInstance());
                            getSelectionProvider().getValue().remove(b.getInstance());
                            if (!"remove".equals(getParameter(0))) {
                                values.add((T) b.getInstance());
                                getSelectionProvider().getValue().add((T) b.getInstance());
                            } else {
                                if (composition != null) {
                                    composition.remove(finalBean);
                                }
                            }
                            return null;
                        }
                    });
                    refresh();
                    getSelectionProvider().getValue().add(newBean);
                }

                return newBean;
            }

            /**
             * {@inheritDoc}
             */
            @Override
            public boolean isEnabled() {
                return super.isEnabled() && hasMode(MODE_CREATABLE);
            }

            @Override
            public String getImagePath() {
                return "icons/new.png";
            }
        };
        actions.add(newAction);
    }

    /**
     * creates the delete button with listeners inside the parent component
     * 
     * @param dform parent of search button
     */
    protected void createDeleteAction() {
        final String actionId = BeanContainer.getActionId(getType(), true, ACTION_DELETE);
        deleteAction = new SecureAction(actionId,
            BeanContainer.getActionText(actionId, false),
            BeanContainer.getActionText(actionId, true),
            IAction.MODE_UNDEFINED) {
            @Override
            public Object action() throws Exception {
                checkBeforeDelete(getSelectionProvider().getValue());
                final COLLECTIONTYPE values = collection;
                for (final Iterator iterator = getSelectionProvider().getValue().iterator(); iterator.hasNext();) {
                    final T element = iterator.next();
                    deleteItem(element);
                    values.remove(element);
                }
                setSelected(null);
                return null;
            }

            /**
             * {@inheritDoc}
             */
            @Override
            public boolean isEnabled() {
                return super.isEnabled() && hasMode(MODE_CREATABLE)
                    && (hasSelection() || !ENV.get("app.event.fire.onselectionchange", false));
            }

            @Override
            public String getImagePath() {
                return "icons/blocked.png";
            }
        };
        actions.add(deleteAction);
//        deleteButton.setEnabled(deleteAction.isEnabled() && selection != null && !selection.isEmpty());
    }

    /**
     * creates the open button with listeners inside the parent component
     * 
     * @param dform parent of search button
     */
    protected void createOpenAction() {
        final String actionId = BeanContainer.getActionId(getType(), true, ACTION_OPEN);
        openAction = new SecureAction(actionId,
            BeanContainer.getActionText(actionId, false),
            BeanContainer.getActionText(actionId, true),
            /*(closeDialogOnOpenAction ? */IAction.MODE_DLG_OK/* : IAction.MODE_UNDEFINED)*/) {
            @Override
            public Object action() throws Exception {
                if (!hasSelection()) {
                    return null;
                }
                //eval. the bean, get relations, and couple (after OK) it with table
                final T selectedBean = getFirstSelectedElement();
                T fullBean = reloadBean ? BeanContainer.instance().resolveLazyRelations(selectedBean) : selectedBean;
                fullBean = (T) beanFinder.wrapToDetailBean(fullBean);

                //create the command call
                Object result = editItem(fullBean);
                if (!IAction.CANCELED.equals(result)) {
                    result = beanFinder.unwrapToSelectableBean(result);
                    replaceBean(selectedBean, (T) result);
                    //no selection-change will be fired - but the instance was changed!
                    return result;
                }
                return null;
            }

            @Override
            public boolean isEnabled() {
                return super.isEnabled() && hasMode(MODE_EDITABLE)
                    && (hasSelection() || !ENV.get("app.event.fire.onselectionchange", false));
            }

            @Override
            public boolean isDefault() {
                return isEnabled()/* && !isconnected*/;
            }

            @Override
            public String getImagePath() {
                return "icons/open.png";
            }
        };
        openAction.setDefault(true);
        actions.add(openAction);
    }

    /**
     * will replace the old selection with the new, saved and unwrapped bean
     * 
     * @param selectedBean old selection
     * @param newBean saved and unwrapped bean
     */
    protected void replaceBean(T selectedBean, T newBean) {
        //TODO: the new item will be added to the end - but should be at the same position as the old one
        if (collection.remove(selectedBean)) {
            collection.add(newBean);
        }
    }

    @Override
    public void setAttributeFilter(String... availableAttributes) {
        super.setAttributeFilter(availableAttributes);
        columnDefinitions = null;
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public Collection getColumnDefinitions() {
        if (columnDefinitions == null) {
            columnDefinitions = createColumnDefinitions(this, new IActivable() {
                @Override
                public boolean isActive() {
                    return hasMode(MODE_SHOW_MULTIPLES);
                }
            });
        }
        return columnDefinitions;
    }

    /**
     * getColumnDefinitionsIndexSorted
     * 
     * @return visible columns index-sorted
     */
    public List getColumnDefinitionsIndexSorted() {
        Collection colDefs = getColumnDefinitions();
        List colDefCopy = new ArrayList(colDefs.size());
        IPresentableColumn c = null;
        //we have to use the iterator to get the filtered data!
        for (Iterator it = colDefs.iterator(); it.hasNext();) {
            c = it.next();
            if (c.getPresentable().isVisible()) {
                colDefCopy.add(c);
            }
        }
        Collections.sort(colDefCopy);
        return colDefCopy;
    }

    /**
     * createColumnDefinitions
     * 
     * @param def
     * @param showMultiples
     * @return
     */
    static  Collection createColumnDefinitions(final BeanDefinition def,
            final IActivable showMultiples) {
        final List> attributes = def.getBeanAttributes();
        Collection columnDefinitions = new ArrayList(attributes.size());
        int i = getMaxColumnIndex(attributes);
        for (IAttributeDefinition attr : attributes) {
            IPresentableColumn col = attr.getColumnDefinition();
            if (col == null) {
                attr.setColumnDefinition(++i, IPresentable.UNDEFINED, true, IPresentable.UNDEFINED);
                col = attr.getColumnDefinition();
            } else {
                //if derived from deserialization, the cycling attributeDefinition is null
                ValueColumn vc = (ValueColumn) col;
                if (vc.attributeDefinition == null) {
                    vc.attributeDefinition = attr;
                }
            }
            columnDefinitions.add(col);
        }
        if (ENV.get("collector.use.multiple.filter", true)) {
            //TODO: filtering ids, and invisibles, too --> don't ask multiple-flag
            columnDefinitions = CollectionUtil.getFiltering(columnDefinitions,
                new IPredicate() {
                    @Override
                    public boolean eval(IPresentableColumn arg0) {
                        return (arg0.getPresentable() == null || arg0.getPresentable().isVisible())
                            && showMultiples.isActive()
                            || (def.getAttribute(arg0.getName()) == null || !def.getAttribute(arg0.getName())
                                .isMultiValue());
                    }
                });
        }
        return columnDefinitions;
    }

    private static int getMaxColumnIndex(List> attributes) {
        int i = 0;
        for (IAttributeDefinition a : attributes) {
            i = Math.max(i, a.getColumnDefinition() != null ? a.getColumnDefinition().getIndex() : 0);
        }
        return i;
    }

    /**
     * setColumnDefinitions
     * 
     * @param columnDefinitions to set
     */
    public void setColumnDefinitions(Collection columnDefinitions) {
        this.columnDefinitions = columnDefinitions;
    }

    /**
     * evaluates the column-index sorted column descriptions
     * 
     * @return column labels to be presented as table header
     */
    public List getColumnLabels() {
        //get the sorted and visible=true filtered columns
        List colDefs = new ArrayList(getColumnDefinitionsIndexSorted());
        List cnames = new ArrayList(colDefs.size());

        for (IPresentableColumn c : colDefs) {
            cnames.add(c.getPresentable().getLabel());
        }
        return cnames;
    }

    private IPresentableColumn getColumn(int i) {
        //try the fastest - all indexes as default
        String[] names = getAttributeNames();
        if (names.length > i) {
            String name = names[i];
            IPresentableColumn column = getAttribute(name).getColumnDefinition();
            if (column != null && column.getIndex() == i) {
                return column;
            }
        }
        Collection colDefs = getColumnDefinitions();
        for (IPresentableColumn c : colDefs) {
            if (c.getIndex() == i) {
                return c;
            }
        }
        return null;
    }

    public Object getColumnValue(Object element, int columnIndex) {
        return getColumnValue(element, getAttribute(getColumn(columnIndex).getName()));
    }

    /**
     * delegates to {@link #getColumnValueEx(Object, IAttributeDefinition)} catching the exception.
     * 
     * @param element bean instance
     * @param attribute bean attribute
     * @return column value
     */
    public  V getColumnValue(Object element, IAttributeDefinition attribute) {
        try {
            return getColumnValueEx(element, attribute);
        } catch (Exception e) {
            LOG.error("beancollector can't create a column text for column '" + attribute.getName()
                + "'!", e);
            return null;
        }
    }

    /**
     * @param element bean instance
     * @param attribute bean attribute
     * @return column value
     */
    protected  V getColumnValueEx(Object element, IAttributeDefinition attribute) {
        if (element == null) {
            return null;
        }
        Object value;
        value = attribute instanceof IValueDefinition ? ((IValueDefinition) attribute).getValue()
            : attribute.getValue(element);
        return (V) value;
    }

    @Override
    public String getColumnText(Object element, int columnIndex) {
        return getColumnText(element, columnIndex, true);
    }

    public String getColumnText(Object element, int columnIndex, boolean useColumnFormat) {
        IPresentableColumn col = getColumn(columnIndex);
        //column may be filtered (e.g. id-columns)
        if (col == null) {
            return "";
        } else if (col instanceof ValueColumn) {
            return getColumnText(element, ((ValueColumn) col).attributeDefinition, useColumnFormat);
        }
        return getColumnText(element, getAttribute(col.getName()), useColumnFormat);
    }

    @Override
    public String getSummaryText(Object contextParameter, int columnIndex) {
        IPresentableColumn col = getColumn(columnIndex);
        //column may be filtered (e.g. id-columns)
        if (col != null) {
            if (col.getSummary() != null) {
                Object value = col.getSummary().getValue(contextParameter);
                return value != null ? col.getSummary().getName() + ": " + value.toString() : "";
            } else if (col.isStandardSummary() && NumberUtil.isNumber(getAttribute(col.getName()).getType())) {
                double result = 0;
                for (T item : collection) {
                    Bean b = Bean.getBean((Serializable) item);
                    Number v = (Number) b.getValue(col.getName());
                    if (v != null) {
                        result += v.doubleValue();
                    }
                }
                return ENV.translate("tsl2nano.total", true) + ": "
                    + getAttribute(col.getName()).getFormat().format(result);
            } else {
                return "";
            }
        }
        return "";
    }

    public String getColumnText(Object element, IAttributeDefinition attribute) {
        return getColumnText(element, attribute, true);
    }

    /**
     * {@inheritDoc}
     */
    public String getColumnText(Object element, IAttributeDefinition attribute, boolean useColumnFormat) {
        Object value;
        try {
            value = getColumnValueEx(element, attribute);
            if (value == null) {
                return "";
            }
            Format f = useColumnFormat &&
                attribute.getColumnDefinition() != null && attribute.getColumnDefinition().getFormat() != null
                    ? attribute.getColumnDefinition().getFormat() : attribute.getFormat();
            if (f != null) {
                return f.format(value);
            } else {
                FormatUtil.getDefaultFormat(value, false).format(value);
            }
        } catch (Exception e) {
            // showing the existing values should not throw exceptions...
            LOG.error(e);
            return Messages.TOKEN_MSG_NOTFOUND + e.toString() + Messages.TOKEN_MSG_NOTFOUND;
        }
        return value.toString();
    }

    @Override
    public void shiftSortIndexes() {
        Collection columns = getColumnDefinitions();
        for (IPresentableColumn c : columns) {
            if (c.getSortIndex() != IPresentable.UNDEFINED) {
                if (c.getSortIndex() < columns.size()) {
                    ((ValueColumn) c).sortIndex++;
                } else {
                    ((ValueColumn) c).sortIndex = IPresentable.UNDEFINED;
                }
            }
        }
    }

    Integer[] getSortIndexes() {
        //important: do a copy of the origin - otherwise the next time the columns will be arranged through sortindex!
        List columns = new ArrayList(getColumnDefinitions());
        Collections.sort(columns, new Comparator() {
            @Override
            public int compare(IPresentableColumn o1, IPresentableColumn o2) {
                return Integer.valueOf(o1.getSortIndex() != IPresentable.UNDEFINED ? o1.getSortIndex()
                    : Integer.MAX_VALUE)
                    .compareTo(Integer.valueOf(o2.getSortIndex() != IPresentable.UNDEFINED ? o2.getSortIndex()
                        : Integer.MAX_VALUE));
            }

        });
        List indexes = new ArrayList(columns.size());
        for (IPresentableColumn c : columns) {
            if (c.getSortIndex() == IPresentable.UNDEFINED) {
                break;//the following will be undefined, too (--> sorting)
            }
            indexes.add(c.getIndex());
        }
        return indexes.toArray(new Integer[0]);
    }

    @Override
    public void sort() {
        final Integer[] sortIndexes = getSortIndexes();
        Comparator comparator = new Comparator() {
            @Override
            public int compare(T o1, T o2) {
                int ci, c;
                for (int i = 0; i < sortIndexes.length; i++) {
                    ci = sortIndexes[i];
//                    c = getColumnText(o1, ci).compareTo(getColumnText(o2, ci));
                    c =
                        BeanPresentationHelper.STRING_COMPARATOR
                            .compare(getColumnValue(o1, ci), getColumnValue(o2, ci));
                    if (c != 0) {
                        //TODO: check performance!
                        c = getColumn(ci).isSortUpDirection() ? c : -1 * c;
                        return c;
                    }
                }
                return 0;
            }
        };
        collection = (COLLECTIONTYPE) CollectionUtil.getSortedList(collection, comparator, getName(), false);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public boolean isMultiValue() {
        return true;
    }

    /**
     * getSearchPanelBeans
     * 
     * @return from-bean and to-bean of bean findes filter-range-bean
     */
    public Collection getSearchPanelBeans() {
        if (getBeanFinder() != null) {
            Bean filterRange = getBeanFinder().getFilterRange();
            if (hasMode(MODE_SEARCHABLE) && filterRange != null) {
                T from = (T) filterRange.getValue("from");
                T to = (T) filterRange.getValue("to");
                List rangeBeans = Arrays.asList(from, to);
                if (hasSearchRequestChanged == null) {
                    for (T rb : rangeBeans) {
                        //we can't use the bean cache - if empty beans were stored they would be reused!
                        connect(new Bean(rb), rb, new CommonAction() {
                            @Override
                            public Object action() throws Exception {
                                return hasSearchRequestChanged = true;
                            }
                        });
                    }
                    //assign fixed search ranges
                    Collection columns = getColumnDefinitions();
                    for (IPresentableColumn c : columns) {
                        if (c.getMinSearchValue() != null) {
                            BeanClass.getBeanClass(getType()).setValue(from, c.getName(), c.getMinSearchValue());
                        }
                        if (c.getMaxSearchValue() != null) {
                            BeanClass.getBeanClass(getType()).setValue(to, c.getName(), c.getMaxSearchValue());
                        }
                    }
                }
                return rangeBeans;
            } else {
                return new LinkedList();
            }
        }
        return new LinkedList();
    }

    /**
     * @return Returns the collection.
     */
    @Override
    public COLLECTIONTYPE getCurrentData() {
        return collection;
    }

    /**
     * getSearchPanelActions
     * 
     * @return
     */
    protected Collection getSearchPanelActions() {
        if (hasMode(MODE_SEARCHABLE)) {
            return Arrays.asList((IAction) searchAction, resetAction);
        } else {
            return new LinkedList();
        }
    }

    public IAction getSearchAction() {
        return searchAction;
    }

    /**
     * createSearchAction
     * 
     * @return new created search action
     */
    protected IAction createSearchAction() {
        final String actionId =
            isVirtual() ? getName() + ".search" : BeanContainer.getActionId(getType(), true, "search");
        searchAction = new SecureAction(actionId,
            BeanContainer.getActionText(actionId, false),
            BeanContainer.getActionText(actionId, true),
            IAction.MODE_UNDEFINED) {
            @Override
            public COLLECTIONTYPE action() throws Exception {
                //TODO: fire refresh event
                COLLECTIONTYPE result = (COLLECTIONTYPE) getBeanFinder().getData();
                if (openAction != null) {
                    openAction.setDefault(true);
                }
                return result;
            }

            @Override
            public boolean isDefault() {
                return isEnabled() && (!hasSelection() || hasSearchRequestChanged());
            }

            @Override
            public String getImagePath() {
                return "icons/find.png";
            }
        };
        actions.add(searchAction);
        return searchAction;
    }

    /**
     * getQuickSearchAction
     * 
     * @return search action for value expressions
     */
    public IAction getQuickSearchAction() {
        if (quickSearchAction == null) {
            final String actionId =
                isVirtual() ? getName() + "." + POSTFIX_QUICKSEARCH : BeanContainer.getActionId(getType(), true,
                    POSTFIX_QUICKSEARCH);
            quickSearchAction = new SecureAction(actionId,
                "",
                BeanContainer.getActionText(actionId, true),
                IAction.MODE_UNDEFINED) {
                @Override
                public COLLECTIONTYPE action() throws Exception {
                    //TODO: fire refresh event
                    searchStatus = Messages.getFormattedString("tsl2nano.searchdialog.searchrunning");
                    ENV.get(Profiler.class).starting(this, getName());
                    COLLECTIONTYPE result = (COLLECTIONTYPE) getBeanFinder().getData((String) getParameter(0));
                    searchStatus = Messages.getFormattedString("tsl2nano.searchdialog.searchresultcount",
                        result.size());
                    if (openAction != null) {
                        openAction.setDefault(true);
                    }
                    return result;
                }

                @Override
                public boolean isDefault() {
                    return isEnabled() && (!hasSelection() || hasSearchRequestChanged());
                }

                @Override
                public String getImagePath() {
                    return "icons/search-small.png";
                }
            };
        }
        return quickSearchAction;
    }

    /**
     * createResetAction
     * 
     * @return new created reset action
     */
    protected IAction createResetAction() {
        final String actionId = BeanContainer.getActionId(getType(), true, "reset");
        resetAction = new SecureAction(actionId,
            BeanContainer.getActionText(actionId, false),
            BeanContainer.getActionText(actionId, true),
            IAction.MODE_UNDEFINED) {
            @Override
            public Object action() throws Exception {
                //TODO: fire refresh event
                getBeanFinder().reset();
                if (!isStaticCollection && collection != null) {
                    collection.clear();
                }
                setSelected();
                searchStatus =
                    isStaticCollection || !hasMode(MODE_SEARCHABLE) ? "" : Messages
                        .getString("tsl2nano.searchdialog.nosearch");
                return null;
            }

            @Override
            public String getImagePath() {
                return "icons/reload.png";
            }
        };
        actions.add(resetAction);
        return resetAction;
    }

    @Override
    public String getSummary() {
        return searchStatus;
    }

    /**
     * getComposition
     * 
     * @return
     */
    public Composition getComposition() {
        return composition;
    }

    /**
     * setCompositionParent
     * 
     * @param composition see {@link #composition}
     */
    public void setCompositionParent(Composition composition) {
        this.composition = composition;
    }

    public static final , I/* extends Serializable*/> BeanCollector getBeanCollector(
            Collection collection,
            int workingMode) {
        ManagedException.assertion(collection != null && collection.size() > 0,
            "collection is empty but must contain at least one item");
        return getBeanCollector((Class) BeanClass.getDefiningClass(collection.iterator().next().getClass()),
            collection, workingMode,
            null);
    }

    public static final , I/* extends Serializable*/> BeanCollector getBeanCollector(
            Class beanType) {
    	return getBeanCollector(beanType, null, 0, null);
    }
    
    /**
     * searches for an existing bean-definition and creates a bean-collector.
     * 
     * @param beanType bean-collectors bean-type
     * @param collection optional prefilling collection (normally done by {@link IBeanFinder#getData(Object, Object)}.
     * @param workingMode working mode of desired collector (see {@link IBeanCollector} for available modes.
     * @return
     */
    public static final , I/* extends Serializable*/> BeanCollector getBeanCollector(
            Class beanType,
            Collection collection,
            int workingMode,
            Composition composition) {
        BeanDefinition beandef =
            (BeanDefinition) (beanType.isArray() && !Util.isEmpty(collection) ? Bean
                .getBean((Serializable) collection.iterator().next())
                : getBeanDefinition(beanType.getSimpleName() + (useExtraCollectorDefinition() ? POSTFIX_COLLECTOR
                    : ""),
                    beanType,
                    false));
        return (BeanCollector) createCollector(collection, workingMode, composition, beandef);
    }

    private static boolean useExtraCollectorDefinition() {
        return ENV.get("collector.use.extra.definition", false);
    }

    /**
     * creates a bean-collector through informations of a bean-definition
     * 
     * @param 
     * @param collection optional collection for collector
     * @param beandef bean description
     * @return new created bean-collector holding given collection
     */
    protected static , I/* extends Serializable*/> BeanCollector createCollector(
            C collection,
            int workingMode,
            Composition composition,
            BeanDefinition beandef) {
        BeanCollector bc = new BeanCollector();
        copy(beandef, bc, "asString", "presentationHelper", "presentable");
        //use an own map instance to be independent of changes by other beans or beancollectors.
        bc.attributeDefinitions = new LinkedHashMap>(bc.getAttributeDefinitions());
        if (beandef.presentable != null)
            bc.presentable = BeanUtil.copy(beandef.presentable);
        bc.init(collection, new BeanFinder(beandef.getClazz()), workingMode, composition);
        return bc;
    }

    @Override
    public void setName(String name) {
        super.setName(name);
        asString = null;
    }

    /**
     * if presentable is of type GroupingPresentable and group-by's are defined, return them
     * @return groups or null
     */
    public Collection getGroups() {
        IPresentable p = getPresentable();
        if (p instanceof GroupingPresentable)
            return ((GroupingPresentable)p).getGroups();
        return null;
    }
    
    /**
     * getGroupByFor
     * @param instance instance to check for GroupBy expressions
     * @return GroupBy or null
     */
    public GroupBy getGroupByFor(Object instance) {
        IPresentable p = getPresentable();
        if (p instanceof GroupingPresentable)
            return ((GroupingPresentable)p).getGroupByFor(this, instance);
        return null;
    }
    
    /**
     * evaluates the next row in the list of data and prepares some properties.
     * 
     * @return next row
     */
    public T nextRow() {
        if (iterator == null)
            iterator = getCurrentData().iterator();
        T currentRow = iterator.hasNext() ? iterator.next() : null;
        if (currentRow == null)
            iterator = null;
        else {
            //avoid concurrentmodification exception because caller doesn't call the last nextRow()
            if (!iterator.hasNext())
                iterator = null;
        }
        return currentRow;
    }

    @Override
    public Map toValueMap(Map properties) {
        Map result = new HashMap();
        String name = BeanAttribute.toFirstLower(getName());
        //first the search values
        if (hasFilter()) {
            Collection s = getSearchPanelBeans();
            if (s.size() == 2) {
                Iterator it = s.iterator();
                result.putAll(toValueMap(it.next(), name + ".search.from.", false, false));
                result.putAll(toValueMap(it.next(), name + ".search.to.", false, false));
            } else {
                LOG.warn("beancollector " + this + " should have a search filter, but no from/to beans are available!");
            }
        }
        //then the summary columns (only the standard calculation while no session parameters are available!)
        Collection cols = getColumnDefinitions();
        for (IPresentableColumn c : cols) {
            if (c.isStandardSummary() || c.getSummary() != null) {
                result.put(getAttribute(c.getName()).getId() + ".summary", getSummaryText(properties, c.getIndex()));
            }
        }
        //and the row count
        result.put(name + ".search.count", collection.size());
        return result;
    }

    @Override
    public int hashCode() {
        return super.hashCode() + (collection != null ? collection.hashCode() : 0);
    }

    @Override
    public String toString() {
        if (asString == null && name != null) {
            //empty search-beans are possible
            asString =
                (useExtraCollectorDefinition() ? ENV.translate("tsl2nano.list", false) + " " : "")
                    + StringUtil.substring(name,
                        null,
                        POSTFIX_COLLECTOR)
                    + (lastCount > -1 ? " (" + lastCount + ")" : "");
        }
        return asString;
    }

    /**
     * Extension for {@link Serializable}
     */
    private void readObject(java.io.ObjectInputStream in) throws IOException, ClassNotFoundException {
        in.defaultReadObject();
        initDeserialization();
    }

    /**
     * Extension for {@link Serializable}
     */
    private void writeObject(java.io.ObjectOutputStream out) throws IOException {
        initSerialization();
        out.defaultWriteObject();
    }

    @Override
    @Commit
    protected void initDeserialization() {
        init(collection, beanFinder, workingMode, composition);
    }

    /**
     * assignColumnValues
     */
    protected void assignColumnValues() {
        if (columnDefinitions != null) {
            for (IPresentableColumn c : columnDefinitions) {
                ((ValueColumn) c).attributeDefinition = getAttribute(c.getName());
            }
        }
    }

    /**
     * getColumnSortingActions
     * 
     * @return
     */
    public Collection> getColumnSortingActions() {
        Collection columns = getColumnDefinitions();
        Collection> actions = new ArrayList>(columns.size());
        for (IPresentableColumn c : columns) {
            actions.add(c.getSortingAction(this));
        }
        return actions;
    }

    public void addColumnDefinition(String attributeName,
            int index,
            int sortIndex,
            boolean sortUpDirection,
            int width) {
        getAttribute(attributeName).setColumnDefinition(index, sortIndex, sortUpDirection, width);
    }

    public static  ValueHolder> createBeanCollectorHolder(Collection instance, int mode) {
        return new ValueHolder>(getBeanCollector(instance, mode));
    }

    /**
     * fills given parameters to instance, if attribute value of right type is null.
     * 
     * @param instance to be filled
     * @param pars parameters given by session context.
     */
    protected void fillContext(T instance, Object[] pars) {
        Collection> attrs = getAttributeDefinitions().values();
        Map map = null;
        if (pars.length == 1 && pars[0] instanceof Map) {
            map = (Map) pars[0];
        }
        for (IAttributeDefinition a : attrs) {
        	if (!a.hasWriteAccess())
        		continue;
            if (a.getValue(instance) == null) {
                if (map != null) {
                    Object value = map.get(BeanClass.getName(a.getType(), false));
                    if (value != null) {
                        if (value instanceof Bean)
                            value = ((Bean)value).instance;
                        a.setValue(instance, value);
                    }
                } else {//simple argument array
                    for (int i = 0; i < pars.length; i++) {
                        //first wins
                        if (pars[i] != null && a.getType().isAssignableFrom(pars[i].getClass())) {
                            a.setValue(instance, pars[i]);
                            break;
                        }
                    }
                }
            }
        }
    }

}
    

    

    

            

    

            



    
    






    
© 2015 - 2024 Weber Informatics LLC | Privacy Policy