/*
 *                 Sun Public License Notice
 * 
 * The contents of this file are subject to the Sun Public License
 * Version 1.0 (the "License"). You may not use this file except in
 * compliance with the License. A copy of the License is available at
 * http://www.sun.com/
 * 
 * The Original Code is NetBeans. The Initial Developer of the Original
 * Code is Sun Microsystems, Inc. Portions Copyright 1997-2002 Sun
 * Microsystems, Inc. All Rights Reserved.
 */
package org.netbeans.modules.xsl.api;

import java.io.IOException;
import org.openide.loaders.DataObject;
import org.w3c.dom.Document;
import org.xml.sax.SAXException;
import org.netbeans.modules.xml.api.scenario.Scenario;

/**
 * Have a notion of transformed document which is helpfull
 * for XPath expressions, etc.
 *
 * @author  asgeir@dimonsoftware.com
 */
public interface XSLScenario extends Scenario {
    
    /**
     * @param dataObject We should get rid of it as scemarion is
     *        accessed as cookie held by DataObject.
     * @param reload If true the document will be reparsed although it has been parsed before
     * @return a sample document to be transformed (it can really
     * exist or can be generated from a grammar on fly).
     */
    Document getSourceDocument(DataObject dataObject, boolean reload)  throws SAXException, IOException;
}