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

com.icesoft.faces.renderkit.dom_html_basic.PassThruAttributeRenderer Maven / Gradle / Ivy

There is a newer version: 3.3.0
Show newest version
/*
 * Copyright 2004-2012 ICEsoft Technologies Canada Corp.
 *
 * 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.icesoft.faces.renderkit.dom_html_basic;

import com.icesoft.faces.context.DOMContext;
import com.icesoft.faces.context.effects.CurrentStyle;
import com.icesoft.faces.context.effects.LocalEffectEncoder;
import com.icesoft.faces.renderkit.RendererUtil;
import com.icesoft.faces.webapp.parser.ImplementationUtil;

import org.w3c.dom.Element;

import javax.faces.FacesException;
import javax.faces.component.UIComponent;
import javax.faces.context.FacesContext;
import java.util.Arrays;
import java.util.List;

/**
 * This class is responsible for the rendering of html pass thru attributes.
 */
public class PassThruAttributeRenderer {
    public static final String[] EMPTY_STRING_ARRAY = {};
    public static final String[] passThruAttributeNames =  {
        "accept",
        "accesskey",
        "alt",
        "bgcolor",
        "border",
        "cellpadding",
        "cellspacing",
        "charset",
        "cols",
        "coords",
        "dir",
        "enctype",
        "frame",
        "height",
        "hreflang",
        "lang",
        "longdesc",
        "maxlength",
        "onblur",
        "onchange",
        "onclick",
        "ondblclick",
        "onfocus",
        "onkeydown",
        "onkeypress",
        "onkeyup",
        "onload",
        "onmousedown",
        "onmousemove",
        "onmouseout",
        "onmouseover",
        "onmouseup",
        "onreset",
        "onselect",
        "onsubmit",
        "onunload",
        "rel",
        "rev",
        "rows",
        "rules",
        "shape",
        "size",
        "style",
        "summary",
        "tabindex",
        "target",
        "title",
        "usemap",
        "width",
        "width",
        "autocomplete"
    };

    public static final String[] booleanPassThruAttributeNames = {
        "disabled",
        "ismap",     
        "readonly"
    };
    
    static {
        Arrays.sort(passThruAttributeNames);
        Arrays.sort(booleanPassThruAttributeNames);
    }


    /**
     * Render pass thru attributes to the root element of the DOMContext
     * associated with the UIComponent parameter. The excludedAttributes
     * argument is a String array of the names of attributes to omit. Do not
     * render attributes contained in the excludedAttributes argument.
     *
     * @param facesContext
     * @param uiComponent
     * @param excludedAttributes attributes to exclude
     * @deprecated 
     */
    public static void renderAttributes(FacesContext facesContext,
                                        UIComponent uiComponent,
                                        String[] excludedAttributes) {
        renderAttributes(
                facesContext, uiComponent, null, null, excludedAttributes);
    }

    /**
     * Render pass thru attributes to the attributeElement (instead of root) 
     * associated with the UIComponent parameter. The excludedAttributes
     * argument is a String array of the names of attributes to omit. Do not
     * render attributes contained in the excludedAttributes argument.
     *
     * @param facesContext
     * @param uiComponent
     * @param attributeElement
     * @param styleElement The Element to apply styling on
     * @param excludedAttributes attributes to exclude
     * @deprecated
     */
    public static void renderAttributes(FacesContext facesContext,
                                        UIComponent uiComponent,
                                        Element attributeElement,
                                        Element styleElement,
                                        String[] excludedAttributes) {
        if (excludedAttributes == null) excludedAttributes = new String[0]; 
        if (excludedAttributes.length > 0) {
            Arrays.sort(excludedAttributes);
        }        
        String[] supportedAttributes = (String[]) uiComponent.getAttributes()
                           .get(RendererUtil.SUPPORTED_PASSTHRU_ATT);
        attributeElement = getTargetElement (facesContext, uiComponent, attributeElement);
        if (supportedAttributes == null) {
            renderNonBooleanAttributes(
                facesContext, uiComponent, attributeElement, excludedAttributes);
        } else {
            for (int i=0; i < supportedAttributes.length; i++) {
                if (excludedAttributes.length > 0 &&
                        Arrays.binarySearch(excludedAttributes,  supportedAttributes[i]) > -1){
                           continue;
                }                
                Object value = null;
                if ((value = uiComponent.getAttributes().get(supportedAttributes[i])) != null &&
                        !PassThruAttributeRenderer.attributeValueIsSentinel(value)) {
                    attributeElement.setAttribute(supportedAttributes[i], value.toString());
                }
            } 
        }
        renderBooleanAttributes(
                facesContext, uiComponent, attributeElement, excludedAttributes);
        CurrentStyle.apply(facesContext, uiComponent, styleElement, null);

        if(attributeElement == null) {
            DOMContext domContext =
                    DOMContext.getDOMContext(facesContext, uiComponent);
            Element rootElement = (Element) domContext.getRootNode();
            attributeElement = rootElement;
        }
        LocalEffectEncoder
                .encodeLocalEffects(uiComponent, attributeElement, facesContext);
        renderOnFocus(uiComponent, attributeElement);
        renderOnBlur(attributeElement);
    }

    /**
     * Render the icefaces onfocus handler to the root element. This should be
     * restricted to input type elements and commandlinks.
     *
     * @param uiComponent
     * @param root
     */
    public static void renderOnFocus(UIComponent uiComponent, Element root) {
        // check the type of the root node
        String nodeName = root.getNodeName();

        if (nodeName.equalsIgnoreCase(HTML.ANCHOR_ELEM) ||
            nodeName.equalsIgnoreCase(HTML.INPUT_ELEM) ||
            nodeName.equalsIgnoreCase(HTML.SELECT_ELEM)) {
            String original =
                    (String) uiComponent.getAttributes().get(HTML.ONFOCUS_ATTR);
            String onfocus = "setFocus(this.id);";
            // Used to be: onfocus + original
            String together = DomBasicRenderer.combinedPassThru(original, onfocus);
            root.setAttribute(HTML.ONFOCUS_ATTR, together);
        }
    }

    /**
     * Render the icefaces onblur handler to the root element. This should be
     * restricted to input type elements and commandlinks.
     *
     * @param root
     */
    public static void renderOnBlur(Element root) {
        // check the type of the root node
        // onblur will clear focus id
        String nodeName = root.getNodeName();

        if (nodeName.equalsIgnoreCase(HTML.ANCHOR_ELEM) ||
            nodeName.equalsIgnoreCase(HTML.INPUT_ELEM) ||
            nodeName.equalsIgnoreCase(HTML.SELECT_ELEM)) {
            String original = root.getAttribute("onblur");
            String onblur = "setFocus('');";
            // Used to be: onblur + original
            String together = DomBasicRenderer.combinedPassThru(original, onblur);
            root.setAttribute(HTML.ONBLUR_ATTR, together);
        }
    }

    public static void renderBooleanAttributes(
            FacesContext facesContext, UIComponent uiComponent,
            Element targetElement,
            String[] excludedAttributes) {

        Object nextPassThruAttributeName;
        Object nextPassThruAttributeValue = null;
        boolean primitiveAttributeValue;
        
        for (int i =0; i < booleanPassThruAttributeNames.length; i++) {
            nextPassThruAttributeName = booleanPassThruAttributeNames[i];
            if (excludedAttributes.length > 0 &&
                    Arrays.binarySearch(excludedAttributes,  nextPassThruAttributeName) > -1){
                       continue;
            }
            nextPassThruAttributeValue = uiComponent.getAttributes().get(
                    nextPassThruAttributeName);
            if (nextPassThruAttributeValue != null) {
                if (nextPassThruAttributeValue instanceof Boolean) {
                    primitiveAttributeValue = ((Boolean)
                            nextPassThruAttributeValue).booleanValue();
                } else {
                    if (!(nextPassThruAttributeValue instanceof String)) {
                        nextPassThruAttributeValue =
                                nextPassThruAttributeValue.toString();
                    }
                    primitiveAttributeValue = (new Boolean((String)
                            nextPassThruAttributeValue)).booleanValue();
                }
                if (primitiveAttributeValue) {
                    targetElement.setAttribute(
                            nextPassThruAttributeName.toString(),
                            nextPassThruAttributeName.toString());
                }
            }
        }
    }

    private static void renderNonBooleanAttributes(
            FacesContext facesContext, UIComponent uiComponent,
            Element targetElement,
            String[] excludedAttributes) {

        Object nextPassThruAttributeName = null;
        Object nextPassThruAttributeValue = null;

        for  (int i = 0; i < passThruAttributeNames.length; i++) {
            nextPassThruAttributeName = passThruAttributeNames[i];
            if (excludedAttributes.length > 0 &&
                    Arrays.binarySearch(excludedAttributes,  nextPassThruAttributeName) > -1){
                       continue;
            }
            nextPassThruAttributeValue =
                    uiComponent.getAttributes().get(nextPassThruAttributeName);
            // Only render non-null attributes.
            // Some components have attribute values
            // set to the Wrapper classes' minimum value - don't render
            // an attribute with this sentinel value.
            if (nextPassThruAttributeValue != null &&
                !attributeValueIsSentinel(nextPassThruAttributeValue)) {
                targetElement.setAttribute(
                        nextPassThruAttributeName.toString(),
                        nextPassThruAttributeValue.toString());
//remove the else clause that was here; it's trying to remove a node
//that doesn't exist
            }
        }

    }


    public static boolean attributeValueIsSentinel(Object value) {
        if (value == null) {
            return false;
        }
        if (value instanceof Boolean) {
            if (((Boolean) value).booleanValue() == false) {
                return true;
            }
            return false;
        }
        if (value instanceof Number) {
            if (value instanceof Integer) {
                if (((Integer) value).intValue() == Integer.MIN_VALUE) {
                    return true;
                }
                return false;
            }
            if (value instanceof Long) {
                if (((Long) value).longValue() == Long.MIN_VALUE) {
                    return true;
                }
                return false;
            }
            if (value instanceof Short) {
                if (((Short) value).shortValue() == Short.MIN_VALUE) {
                    return true;
                }
                return false;
            }
            if (value instanceof Float) {
                if (((Float) value).floatValue() == Float.MIN_VALUE) {
                    return true;
                }
                return false;
            }
            if (value instanceof Double) {
                if (((Double) value).doubleValue() == Double.MIN_VALUE) {
                    return true;
                }
                return false;
            }
            if (value instanceof Byte) {
                if (((Byte) value).byteValue() == Byte.MIN_VALUE) {
                    return true;
                }
                return false;
            }
        }
        if (value instanceof Character) {
            if (((Character) value).charValue() == Character.MIN_VALUE) {
                return true;
            }
            return false;
        }
        return false;
    }

    static final String[] getpassThruAttributeNames() {
        return passThruAttributeNames;
    }
    
    static Element getTargetElement(FacesContext facesContext, 
            UIComponent uiComponent, Element targetElement) {
        if(targetElement == null) {
            DOMContext domContext =
                    DOMContext.getDOMContext(facesContext, uiComponent);
            Element rootElement = (Element) domContext.getRootNode();
            if (rootElement == null) {
                throw new FacesException("DOMContext is null");
            }
            targetElement = rootElement;
        }
        return targetElement;
    }
    
        /**
     * Render pass thru attributes to the root element of the DOMContext
     * associated with the UIComponent parameter. The IncludedAttributes
     * argument is a String array of the names of attributes to include.
     *
     * @param facesContext
     * @param uiComponent
     * @param nonBooleanHtmlAttributes
     */
    public static void renderHtmlAttributes(FacesContext facesContext,
                                        UIComponent uiComponent,
                                        String[] nonBooleanHtmlAttributes) {
        renderHtmlAttributes(
                facesContext, uiComponent, null, null, nonBooleanHtmlAttributes);
    }
    
    /**
     * Render pass thru attributes to the root element of the DOMContext
     * associated with the UIComponent parameter. The IncludedAttributes
     * argument is a String array of the names of attributes to include.
     *
     * @param facesContext
     * @param uiComponent
     * @param attributeElement
     * @param styleElement The Element to apply styling on
     * @param included nonBooleanHtmlAttributes
     */
    /**
     * Render pass thru attributes to the root element of the DOMContext
     * associated with the UIComponent parameter. The IncludedAttributes
     * argument is a String array of the names of attributes to include.
     *
     * @param facesContext
     * @param uiComponent
     * @param attributeElement
     * @param styleElement The Element to apply styling on
     * @param htmlAttributes
     */
    public static void renderHtmlAttributes(FacesContext facesContext,
                                        UIComponent uiComponent,
                                        Element attributeElement,
                                        Element styleElement, String[] htmlAttributes) {
                                        
        if(attributeElement == null) {
            DOMContext domContext =
                    DOMContext.getDOMContext(facesContext, uiComponent);
            if(domContext == null){
                 throw new FacesException("DOMContext is null");
            }
            Element rootElement = (Element) domContext.getRootNode();
            if (rootElement == null) {
                throw new FacesException("DOMContext is null");
            }
            attributeElement = rootElement;
        }
        
        // For now, we just support accelerating h: component rendering
        boolean stockAttribTracking =
            ImplementationUtil.isStockAttributeTracking();
        boolean attribTracking =
            stockAttribTracking &&
            uiComponent.getClass().getName().startsWith("javax.faces.component.");
        List attributesThatAreSet = (!attribTracking) ? null :
            (List) uiComponent.getAttributes().get(
                "javax.faces.component.UIComponentBase.attributesThatAreSet");
        
        renderNonBooleanHtmlAttributes(uiComponent, attributeElement, 
            htmlAttributes, attribTracking, attributesThatAreSet);  
        
        //TODO remove the following:        
        CurrentStyle.apply(facesContext, uiComponent, styleElement, null);              
        LocalEffectEncoder.encodeLocalEffects(
            uiComponent, attributeElement, facesContext,
            null, attribTracking, attributesThatAreSet);
        renderOnFocus(uiComponent, attributeElement);
        renderOnBlur(attributeElement);
    }        
    
    private static boolean valueIsIntegerSentinelValue(Object value) {

        if (value instanceof String) {
            return false;
        }else if (value instanceof Number) {
            if (value instanceof Integer) {
                if (((Integer) value).intValue() == Integer.MIN_VALUE) {
                    return true;
                }
                return false;
            }
        }
        return false;
    }
    
    public static void renderNonBooleanHtmlAttributes(UIComponent uiComponent,
            Element targetElement, String[] nonBooleanhtmlAttributes) {
        renderNonBooleanHtmlAttributes(
            uiComponent, targetElement, nonBooleanhtmlAttributes, false, null);
    }
    
    public static void renderNonBooleanHtmlAttributes(UIComponent uiComponent,
            Element targetElement, String[] nonBooleanhtmlAttributes,
            boolean attribTracking, List attributesThatAreSet) {
        if (attribTracking &&
            (attributesThatAreSet == null ||
             attributesThatAreSet.size() == 0)) {
            return;
        }

        Object nextPassThruAttributeName = null;
        Object nextPassThruAttributeValue = null;
        
        for (int i = 0; i < nonBooleanhtmlAttributes.length; i++) {
            nextPassThruAttributeName = nonBooleanhtmlAttributes[i];
            if (attribTracking &&
                (attributesThatAreSet == null ||
                 !attributesThatAreSet.contains(nextPassThruAttributeName))) {
                continue;
            }
            nextPassThruAttributeValue =
                    uiComponent.getAttributes().get(nextPassThruAttributeName);
            // Only render non-null attributes.
            // Some components have integer attribute values
            // set to the Wrapper classes' minimum value - don't render
            // an attribute with this sentinel value.
            if (nextPassThruAttributeValue != null && !valueIsIntegerSentinelValue(nextPassThruAttributeValue)) {
                targetElement.setAttribute(
                        nextPassThruAttributeName.toString(),
                        nextPassThruAttributeValue.toString());
            //remove the else clause that was here; it's trying to remove a node
            //that doesn't exist
            }
        }
    }    
        
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy