jsf/plugins/org.eclipse.jst.pagedesigner/src/org/eclipse/jst/pagedesigner/dtmanager/converter/internal/DTTagConverterDecorator.java

/*******************************************************************************
 * Copyright (c) 2005 Oracle Corporation.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *    Ian Trimble - initial API and implementation
 *******************************************************************************/ 
package org.eclipse.jst.pagedesigner.dtmanager.converter.internal;

import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jst.jsf.common.metadata.Trait;
import org.eclipse.jst.jsf.common.metadata.internal.IImageDescriptorProvider;
import org.eclipse.jst.pagedesigner.converter.IConverterFactory;
import org.eclipse.jst.pagedesigner.converter.ITagConverter;
import org.eclipse.jst.pagedesigner.dtmanager.DTManager;
import org.eclipse.jst.pagedesigner.dtmanager.IDTInfo;
import org.eclipse.jst.pagedesigner.dtmanager.converter.ITagConverterDecorator;
import org.eclipse.jst.pagedesigner.dtmanager.dtinfo.ResolveAttributeValue;
import org.eclipse.jst.pagedesigner.dtmanager.dtinfo.TagDecorateInfo;
import org.eclipse.jst.pagedesigner.preview.PageExpressionContext;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
import org.w3c.dom.Text;

/**
 * ITagConverterDecorator implementation for DTTagConverter.
 * 
 * @author Ian Trimble - Oracle
 */
public class DTTagConverterDecorator implements ITagConverterDecorator {

	private static final String DECORATE_INFO_ID_DESIGN = "vpd-decorate-design";
	private static final String DECORATE_INFO_ID_PREVIEW = "vpd-decorate-preview";

	/*
	 * (non-Javadoc)
	 * @see org.eclipse.jst.pagedesigner.dtmanager.converter.internal.provisional.ITagConverterDecorator#decorate(org.eclipse.jst.pagedesigner.converter.ITagConverter)
	 */
	public void decorate(ITagConverter tagConverter) {
		if (!(tagConverter instanceof DTTagConverter)) {
			throw new IllegalArgumentException("ITagConverter argument must be an instance of DTTagConverter");
		}
		DTTagConverter dtTagConverter = (DTTagConverter)tagConverter;

		if (dtTagConverter.getMode() == IConverterFactory.MODE_DESIGNER) {
			decorateFromDTInfo(dtTagConverter, DECORATE_INFO_ID_DESIGN);
		} else if (dtTagConverter.getMode() == IConverterFactory.MODE_PREVIEW) {
			decorateFromDTInfo(dtTagConverter, DECORATE_INFO_ID_PREVIEW);
		}

		if (tagConverter.getResultElement() == null && tagConverter.isVisualByHTML()) {
			createUnknownTagRepresentation(dtTagConverter);
		}
	}

	/**
	 * Performs decoration of the specified DTTagConverter instance from
	 * IDTInfo (metadata) for the specified (by ID) TagDecorateInfo.
	 * 
	 * @param dtTagConverter DTTagConverter instance.
	 * @param tagDecorateInfoID ID of the TagDecorateInfo to be located in
	 * metadata.
	 */
	protected void decorateFromDTInfo(DTTagConverter dtTagConverter, String tagDecorateInfoID) {
		Element srcElement = dtTagConverter.getHostElement();
		DTManager dtManager = DTManager.getInstance();
		IDTInfo dtInfo = dtManager.getDTInfo(srcElement);
		if (dtInfo != null) {
			TagDecorateInfo tdInfo = dtInfo.getTagDecorateInfo(tagDecorateInfoID);
			if (tdInfo != null) {
				dtTagConverter.setMultiLevel(tdInfo.isMultiLevel());
				dtTagConverter.setNeedBorderDecorator(tdInfo.isNeedBorderDecorator());
				dtTagConverter.setNeedTableDecorator(tdInfo.isNeedTableDecorator());
				if (tdInfo.isNonVisual()) {
					setNonVisual(dtTagConverter, dtInfo, tdInfo.getNonVisualImagePath());
				}
				if (tdInfo.isResolveChildText()) {
					resolveChildText(dtTagConverter.getResultElement());
				}
				if (tdInfo.isSetNonVisualChildElements()) {
					setNonVisualChildElements(dtTagConverter, srcElement);
				}
				dtTagConverter.setWidget(tdInfo.isWidget());
				dtTagConverter.setMinHeight(tdInfo.getMinHeight());
				dtTagConverter.setMinWidth(tdInfo.getMinWidth());
				ResolveAttributeValue resAttrValue = tdInfo.getResolveAttributeValue();
				if (resAttrValue != null) {
					String attributeName = resAttrValue.getAttributeName();
					if (attributeName != null && attributeName.length() > 0) {
						resolveAttributeValue(dtTagConverter.getResultElement(), attributeName);
					}
				}
			}
		}
	}

	/**
	 * Creates a visual representation result Element for an unknown tag.
	 * 
	 * @param dtTagConverter DTTagConverter instance.
	 */
	protected void createUnknownTagRepresentation(DTTagConverter dtTagConverter) {
		Element element = dtTagConverter.createElement("span");
		element.setAttribute("style", "color:red;font-weight:bold;");
		Text text = dtTagConverter.createText("<" + dtTagConverter.getHostElement().getTagName() + "/>");
		element.appendChild(text);
		dtTagConverter.setResultElement(element);
		dtTagConverter.setWidget(true);
	}

	/**
	 * Adds child Elements of the specified source Element to the specified
	 * DTTagConverter instance's collection of non-visual children.
	 * 
	 * @param dtTagConverter DTTagConverter instance.
	 * @param srcElement Source Element for which child Elements are to be
	 * added.
	 */
	protected void setNonVisualChildElements(DTTagConverter dtTagConverter, Element srcElement) {
		NodeList childNodes = srcElement.getChildNodes();
		for (int i = 0; i < childNodes.getLength(); i++) {
			Node curNode = childNodes.item(i);
			if (curNode.getNodeType() == Node.ELEMENT_NODE) {
				dtTagConverter.addNonVisualChildElement((Element)curNode);
			}
		}
	}

	/**
	 * Performs simple EL resolution for the child Text Node of the specified
	 * source Element instance.
	 * 
	 * @param srcElement Source Element for which child Text Node EL resolution
	 * is to be performed.
	 */
	protected void resolveChildText(Element srcElement) {
		if (srcElement != null) {
			NodeList childNodes = srcElement.getChildNodes();
			for (int i = 0; i < childNodes.getLength(); i++) {
				Node childNode = childNodes.item(i);
				if (childNode.getNodeType() == Node.TEXT_NODE) {
					Text textNode = (Text)childNode;
					String textNodeValue = textNode.getNodeValue();
					try {
						String newTextNodeValue = (String)PageExpressionContext.getCurrent().evaluateExpression(textNodeValue, String.class, null);
						if (!textNodeValue.equals(newTextNodeValue)) {
							textNode.setNodeValue(newTextNodeValue);
						}
					} catch(Exception ex) {
						//ignore - could not resolve, do not change existing value
					}
				}
			}
		}
	}

	/**
	 * Performs simple EL resolution for the value of the specified attribute
	 * of the specified Element.
	 * 
	 * @param srcElement Source Element instance.
	 * @param attributeName Name of attribute for which the value should be
	 * resolved.
	 */
	protected void resolveAttributeValue(Element srcElement, String attributeName) {
		if (srcElement != null) {
			String oldAttributeValue = srcElement.getAttribute(attributeName);
			if (oldAttributeValue != null && oldAttributeValue.length() > 0) {
				try {
					String newAttributeValue = (String)PageExpressionContext.getCurrent().evaluateExpression(oldAttributeValue, String.class, null);
					if (!oldAttributeValue.equals(newAttributeValue)) {
						srcElement.setAttribute(attributeName, newAttributeValue);
					}
				} catch(Exception ex) {
					//ignore - could not resolve, do not change existing value
				}
			}
		}
	}

	/**
	 * Sets DTTagConverter instance as non-visual as HTML and sets the
	 * ImageDescriptor instance that DTTagConverter will use to return an Image
	 * for rendering.
	 * 
	 * @param dtTagConverter DTTagConverter instance.
	 * @param dtInfo IDTInfo instance.
	 * @param imagePath Image path, relative to declaring plugin.
	 */
	protected void setNonVisual(DTTagConverter dtTagConverter, IDTInfo dtInfo, String imagePath) {
		dtTagConverter.setVisualByHTML(false);
		if (imagePath != null && imagePath.length() > 0) {
			Trait trait = dtInfo.getTrait();
			IImageDescriptorProvider imgDescProvider = (IImageDescriptorProvider)trait.getSourceModelProvider().getAdapter(IImageDescriptorProvider.class);
			if (imgDescProvider != null) {
				ImageDescriptor imageDescriptor = imgDescProvider.getImageDescriptor(imagePath);
				dtTagConverter.setVisualImageDescriptor(imageDescriptor);
			}
		}
	}

}