/*
 * Copyright 2000-2014 Vaadin Ltd.
 * 
 * Licensed under the Apache 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.apache.org/licenses/LICENSE-2.0
 * 
 * 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 com.vaadin.data.util;

import java.io.Serializable;

import com.vaadin.data.Container.Filter;
import com.vaadin.data.Item;
import com.vaadin.data.Property;
import com.vaadin.data.sort.SortOrder;
import com.vaadin.data.util.filter.UnsupportedFilterException;

/**
 * PropertyValueGenerator for GeneratedPropertyContainer.
 * 
 * @param <T>
 *            Property data type
 * @since 7.4
 * @author Vaadin Ltd
 */
public abstract class PropertyValueGenerator<T> implements Serializable {

    /**
     * Returns value for given Item. Used by GeneratedPropertyContainer when
     * generating new properties.
     * 
     * @param item
     *            currently handled item
     * @param itemId
     *            item id for currently handled item
     * @param propertyId
     *            id for this property
     * @return generated value
     */
    public abstract T getValue(Item item, Object itemId, Object propertyId);

    /**
     * Return Property type for this generator. This function is called when
     * {@link Property#getType()} is called for generated property.
     * 
     * @return type of generated property
     */
    public abstract Class<T> getType();

    /**
     * Translates sorting of the generated property in a specific direction to a
     * set of property ids and directions in the underlying container.
     * 
     * SortOrder is similar to (or the same as) the SortOrder already defined
     * for Grid.
     * 
     * The default implementation of this method returns an empty array, which
     * means that the property will not be included in
     * getSortableContainerPropertyIds(). Attempting to sort by that column
     * throws UnsupportedOperationException.
     * 
     * Returning null is not allowed.
     * 
     * @param order
     *            a sort order for this property
     * @return an array of sort orders describing how this property is sorted
     */
    public SortOrder[] getSortProperties(SortOrder order) {
        return new SortOrder[] {};
    }

    /**
     * Return an updated filter that should be compatible with the underlying
     * container.
     * 
     * This function is called when setting a filter for this generated
     * property. Returning null from this function causes
     * GeneratedPropertyContainer to discard the filter and not use it.
     * 
     * By default this function throws UnsupportedFilterException.
     * 
     * @param filter
     *            original filter for this property
     * @return modified filter that is compatible with the underlying container
     * @throws UnsupportedFilterException
     */
    public Filter modifyFilter(Filter filter) throws UnsupportedFilterException {
        throw new UnsupportedFilterException("Filter" + filter
                + " is not supported");
    }

}

@@ -1944,25 +1944,28 @@
 ner.%0A     * 
+%3Cp%3E
 %0A
-
      * SortO
@@ -2046,32 +2046,35 @@
 or Grid.%0A     * 
+%3Cp%3E
 %0A     * The defa
@@ -2727,32 +2727,35 @@
 ntainer.%0A     * 
+%3Cp%3E
 %0A     * This fun
@@ -2940,32 +2940,35 @@
  use it.%0A     * 
+%3Cp%3E
 %0A     * By defau
@@ -3180,16 +3180,16 @@
 ntainer%0A
-
      * @
@@ -3222,16 +3222,122 @@
 ception%0A
+     *             if the implementation doesn't support modifying the provided%0A     *             filter%0A
      */%0A

Fix PropertyValueGenerator javadocs