org.ajax4jsf.framework.taglib.UIComponentBodyTagBase Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ajax4jsf Show documentation
Show all versions of ajax4jsf Show documentation
Ajax4jsf is an open source extension to the JavaServer Faces standard that adds AJAX capability to JSF applications without requiring the writing of any JavaScript.
The newest version!
/**
* Licensed under the Common Development and Distribution License,
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.sun.com/cddl/
*
* 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.ajax4jsf.framework.taglib;
import javax.faces.component.ActionSource;
import javax.faces.component.EditableValueHolder;
import javax.faces.component.UICommand;
import javax.faces.component.UIComponent;
import javax.faces.component.UIGraphic;
import javax.faces.component.UIParameter;
import javax.faces.component.UISelectBoolean;
import javax.faces.component.ValueHolder;
import javax.faces.context.FacesContext;
import javax.faces.convert.Converter;
import javax.faces.el.MethodBinding;
import javax.faces.el.ValueBinding;
import javax.faces.event.ActionEvent;
import javax.faces.event.ValueChangeEvent;
import javax.faces.webapp.UIComponentBodyTag;
import org.ajax4jsf.framework.util.message.Messages;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
/**
* Base class with utility functions for all JSF tags. Get from apache MyFaces
* @author [email protected] (latest modification by $Author: slava_kabanovich $)
* @version $Revision: 1.2 $ $Date: 2006/07/12 14:59:36 $
*
*/
public abstract class UIComponentBodyTagBase extends UIComponentBodyTag {
//Special UIComponent attributes (ValueHolder, ConvertibleValueHolder)
private String _value;
private String _converter;
//attributes id, rendered and binding are handled by UIComponentTag
/**
* @param converter The converter to set.
*/
public void setConverter(String converter) {
_converter = converter;
}
/**
* @param value The value to set.
*/
public void setValue(String value) {
_value = value;
}
public void release() {
super.release();
_value=null;
_converter=null;
}
protected void setProperties(UIComponent component)
{
super.setProperties(component);
//rendererType already handled by UIComponentTag
setValueProperty(component, _value);
setConverterProperty(component, _converter);
}
// sub class helpers
private static final Log log = LogFactory.getLog(UIComponentBodyTagBase.class);
private static final Class[] VALIDATOR_ARGS = {FacesContext.class,
UIComponent.class,
Object.class};
private static final Class[] ACTION_LISTENER_ARGS = {ActionEvent.class};
private static final Class[] VALUE_LISTENER_ARGS = {ValueChangeEvent.class};
protected void setCharterProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//FIXME: should use converter maybe?
component.getAttributes().put(propName, new Character(value.charAt(0)));
}
}
}
protected void setIntegerProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//FIXME: should use converter maybe?
component.getAttributes().put(propName, Integer.valueOf(value));
}
}
}
protected void setLongProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//FIXME: should use converter maybe?
component.getAttributes().put(propName, Long.valueOf(value));
}
}
}
protected void setFloatProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//FIXME: should use converter maybe?
component.getAttributes().put(propName, Float.valueOf(value));
}
}
}
protected void setDoubleProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//FIXME: should use converter maybe?
component.getAttributes().put(propName, Double.valueOf(value));
}
}
}
protected void setStringProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//TODO: Warning if component has no such property (with reflection)
component.getAttributes().put(propName, value);
}
}
}
protected void setBooleanProperty(UIComponent component, String propName, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
//TODO: More sophisticated way to convert boolean value (yes/no, 1/0, on/off, etc.)
component.getAttributes().put(propName, Boolean.valueOf(value));
}
}
}
protected void setValueProperty(UIComponent component, String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding("value", vb);
}
else if (component instanceof UICommand)
{
((UICommand)component).setValue(value);
}
else if (component instanceof UIParameter)
{
((UIParameter)component).setValue(value);
}
else if (component instanceof UISelectBoolean)
{
((UISelectBoolean)component).setValue(Boolean.valueOf(value));
}
else if (component instanceof UIGraphic)
{
((UIGraphic)component).setValue(value);
}
//Since many input components are ValueHolders the special components
//must come first, ValueHolder is the last resort.
else if (component instanceof ValueHolder)
{
((ValueHolder)component).setValue(value);
}
else
{
log.error(Messages.getMessage(Messages.NO_VALUE_HOLDER_ERROR, component.getClass().getName()));
}
}
}
protected void setConverterProperty(UIComponent component, String value)
{
if (value != null)
{
if (component instanceof ValueHolder)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding("converter", vb);
}
else
{
FacesContext facesContext = FacesContext.getCurrentInstance();
Converter converter = facesContext.getApplication().createConverter(value);
((ValueHolder)component).setConverter(converter);
}
}
else
{
log.error(Messages.getMessage(Messages.NO_VALUE_HOLDER_ERROR, component.getClass().getName()));
}
}
}
protected void setValidatorProperty(UIComponent component, String validator)
{
if (validator != null)
{
if (!(component instanceof EditableValueHolder))
{
throw new IllegalArgumentException(Messages.getMessage(Messages.NO_EDITABLE_VALUE_HOLDER_ERROR, component.getId()));
}
if (isValueReference(validator))
{
MethodBinding mb = getFacesContext().getApplication().createMethodBinding(validator,
VALIDATOR_ARGS);
((EditableValueHolder)component).setValidator(mb);
}
else
{
log.error(Messages.getMessage(Messages.INVALID_VALIDATION_EXPRESSION, component.getId(), validator));
}
}
}
protected void setActionProperty(UIComponent component, String action)
{
if (action != null)
{
if (!(component instanceof ActionSource))
{
throw new IllegalArgumentException(Messages.getMessage(Messages.NO_ACTION_SOURCE_ERROR, component.getClientId(getFacesContext())));
}
MethodBinding mb;
if (isValueReference(action))
{
mb = getFacesContext().getApplication().createMethodBinding(action, null);
}
else
{
mb = new SimpleActionMethodBinding(action);
}
((ActionSource)component).setAction(mb);
}
}
protected void setActionListenerProperty(UIComponent component, String actionListener)
{
if (actionListener != null)
{
if (!(component instanceof ActionSource))
{
throw new IllegalArgumentException(Messages.getMessage(Messages.NO_ACTION_SOURCE_ERROR, component.getClientId(getFacesContext())));
}
if (isValueReference(actionListener))
{
MethodBinding mb = getFacesContext().getApplication().createMethodBinding(actionListener,
ACTION_LISTENER_ARGS);
((ActionSource)component).setActionListener(mb);
}
else
{
log.error(Messages.getMessage(Messages.INVALID_ACTION_LISTENER, component.getClientId(getFacesContext()), actionListener));
}
}
}
protected void setValueChangedListenerProperty(UIComponent component, String valueChangedListener)
{
if (valueChangedListener != null)
{
if (!(component instanceof EditableValueHolder))
{
throw new IllegalArgumentException(Messages.getMessage(Messages.NO_EDITABLE_VALUE_HOLDER_ERROR, component.getClientId(getFacesContext())));
}
if (isValueReference(valueChangedListener))
{
MethodBinding mb = getFacesContext().getApplication().createMethodBinding(valueChangedListener,
VALUE_LISTENER_ARGS);
((EditableValueHolder)component).setValueChangeListener(mb);
}
else
{
log.error(Messages.getMessage(Messages.INVALID_VALUE_CHANGE_LISTENER, component.getClientId(getFacesContext()), valueChangedListener));
}
}
}
protected void setValueBinding(UIComponent component,
String propName,
String value)
{
if (value != null)
{
if (isValueReference(value))
{
ValueBinding vb = getFacesContext().getApplication().createValueBinding(value);
component.setValueBinding(propName, vb);
}
else
{
throw new IllegalArgumentException(Messages.getMessage(Messages.NO_VALUE_REFERENCE_ERROR, new Object[]{component.getId(), propName, value}));
}
}
}
}