/*******************************************************************************
 * 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;

import org.eclipse.jst.jsf.core.internal.tld.CMUtil;
import org.eclipse.jst.pagedesigner.converter.ConverterFactoryRegistry;
import org.eclipse.jst.pagedesigner.converter.IConverterFactory;
import org.eclipse.jst.pagedesigner.converter.ITagConverter;
import org.eclipse.jst.pagedesigner.dtmanager.converter.internal.DTTagConverterFactory;
import org.eclipse.wst.xml.core.internal.provisional.document.IDOMDocument;
import org.w3c.dom.Element;

/**
 * DTManager is the top-level entry point for design-time (DT) services, such
 * as tag converters and design-time information.
 * 
 * <p><b>Provisional API - subject to change</b></p>
 * 
 * @author Ian Trimble - Oracle
 */
public class DTManager {

	private static DTManager instance;
	private IDTInfoFactory _dtInfoFactory;

	private DTManager() {
        // no external instantiation
	}

	/**
	 * Gets the singleton DTManager instance.
	 * 
	 * @return The singleton DTManager instance.
	 */
	public static synchronized DTManager getInstance() {
		if (instance == null) {
			instance = new DTManager();
		}
		return instance;
	}

	/**
	 * Gets an ITagConverter instance for the specified Element and mode.
	 * 
	 * @param element Element instance for which to locate and return an
	 * ITagConverter instance.
	 * @param mode Mode flag (use IConverterFactory constants).
	 * @param document Target IDOMDocument instance.
	 * @return An ITagConverter instance for the specified Element and mode.
	 */
	public ITagConverter getTagConverter(Element element, int mode, IDOMDocument document) {
		ITagConverter tagConverter = null;
		String nsURI = CMUtil.getElementNamespaceURI(element);
		//try MD-driven approach
		IConverterFactory tagConverterFactory = getTagConverterFactory(nsURI);
		if (tagConverterFactory != null) {
			tagConverter = tagConverterFactory.createConverter(element, mode);
			if (tagConverter != null) {
				tagConverter.setDestDocument(document);
			} else {
				//fallback to contributed (non-MD-driven) approach
				tagConverter = ConverterFactoryRegistry.getInstance().createTagConverter(element, mode, document);
			}
		}
		return tagConverter;
	}

	/**
	 * Gets an IConverterFactory instance for the specified namespace URI.
	 * 
	 * @param nsURI Namespace URI.
	 * @return An IConverterFactory instance for the specified namespace URI.
	 */
	protected IConverterFactory getTagConverterFactory(String nsURI) {
		//TODO: future - expand to first look for registered factories
		return new DTTagConverterFactory();
	}

	/**
	 * Gets an IDTInfo instance for the specified Element.
	 * 
	 * @param element Element instance for which to locate and return IDTInfo
	 * instance.
	 * @return An IDTInfo instance for the specified Element.
	 */
	public IDTInfo getDTInfo(Element element) {
		IDTInfo dtInfo = null;
		String nsURI = CMUtil.getElementNamespaceURI(element);
		IDTInfoFactory dtInfoFactory = getDTInfoFactory(nsURI);
		if (dtInfoFactory != null) {
			dtInfo = dtInfoFactory.getDTInfo(element);
		}
		return dtInfo;
	}

	/**
	 * Gets an IDTInfoFactory instance for the specified namespace URI.
	 * 
	 * @param nsURI Namespace URI.
	 * @return An IDTInfoFactory instance for the specified namespace URI.
	 */
	protected IDTInfoFactory getDTInfoFactory(String nsURI) {
		if (_dtInfoFactory == null) {
			_dtInfoFactory = new DefaultDTInfoFactory();
		}
		return _dtInfoFactory;
	}

}