/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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 org.apache.wicket.extensions.markup.html.repeater.data.table;
import org.apache.wicket.extensions.markup.html.repeater.data.grid.ICellPopulator;
import org.apache.wicket.extensions.markup.html.repeater.data.table.export.IExportableColumn;
import org.apache.wicket.markup.html.basic.Label;
import org.apache.wicket.markup.repeater.Item;
import org.apache.wicket.model.IModel;
import org.apache.wicket.model.PropertyModel;
/**
* A convenience implementation of column that adds a label to the cell whose model is determined by
* the provided wicket property expression (same as used by {@link PropertyModel}) that is evaluated
* against the current row's model object
* <p>
* Example
*
* <pre>
* columns[0] = new PropertyColumn(new Model<String>("First Name"), "name.first");
* </pre>
*
* The above will attach a label to the cell with a property model for the expression
* "name.first"
*
* @see PropertyModel
*
* @author Igor Vaynberg ( ivaynberg )
* @param <T>
* The Model object type
* @param <S>
* the type of the sort property
*/
public class PropertyColumn<T, S> extends AbstractColumn<T, S> implements IExportableColumn<T, S>
{
private static final long serialVersionUID = 1L;
private final String propertyExpression;
/**
* Creates a property column that is also sortable
*
* @param displayModel
* display model
* @param sortProperty
* sort property
* @param propertyExpression
* wicket property expression used by PropertyModel
*/
public PropertyColumn(final IModel<String> displayModel, final S sortProperty,
final String propertyExpression)
{
super(displayModel, sortProperty);
this.propertyExpression = propertyExpression;
}
/**
* Creates a non sortable property column
*
* @param displayModel
* display model
* @param propertyExpression
* wicket property expression
* @see PropertyModel
*/
public PropertyColumn(final IModel<String> displayModel, final String propertyExpression)
{
super(displayModel, null);
this.propertyExpression = propertyExpression;
}
/**
* Implementation of populateItem which adds a label to the cell whose model is the provided
* property expression evaluated against rowModelObject
*
* @see ICellPopulator#populateItem(Item, String, IModel)
*/
@Override
public void populateItem(final Item<ICellPopulator<T>> item, final String componentId,
final IModel<T> rowModel)
{
item.add(new Label(componentId, getDataModel(rowModel)));
}
/**
* @return wicket property expression
*/
public String getPropertyExpression()
{
return propertyExpression;
}
/**
* Factory method for generating a model that will generated the displayed value. Typically the
* model is a property model using the {@link #propertyExpression} specified in the constructor.
*
* @param rowModel
* @return model
*/
@Override
public IModel<?> getDataModel(IModel<T> rowModel)
{
PropertyModel<?> propertyModel = new PropertyModel<>(rowModel, propertyExpression);
return propertyModel;
}
}