1320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson/* 2320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Licensed to the Apache Software Foundation (ASF) under one or more 3320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * contributor license agreements. See the NOTICE file distributed with 4320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * this work for additional information regarding copyright ownership. 5320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * The ASF licenses this file to You under the Apache License, Version 2.0 6320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * (the "License"); you may not use this file except in compliance with 7320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * the License. You may obtain a copy of the License at 8320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * 9320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * http://www.apache.org/licenses/LICENSE-2.0 10320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * 11320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Unless required by applicable law or agreed to in writing, software 12320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * distributed under the License is distributed on an "AS IS" BASIS, 13320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * See the License for the specific language governing permissions and 15320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * limitations under the License. 16320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson */ 17320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 18320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson// $Id: DOMLocator.java 446598 2006-09-15 12:55:40Z jeremias $ 19320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 20320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilsonpackage javax.xml.transform.dom; 21320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 22320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilsonimport javax.xml.transform.SourceLocator; 23320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilsonimport org.w3c.dom.Node; 24320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 25320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 26320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson/** 27320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Indicates the position of a node in a source DOM, intended 28320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * primarily for error reporting. To use a DOMLocator, the receiver of an 29320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * error must downcast the {@link javax.xml.transform.SourceLocator} 30320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * object returned by an exception. A {@link javax.xml.transform.Transformer} 31320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * may use this object for purposes other than error reporting, for instance, 32320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * to indicate the source node that originated a result node. 33320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson */ 34320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilsonpublic interface DOMLocator extends SourceLocator { 35320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 36320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson /** 37320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * Return the node where the event occurred. 38320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * 39320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson * @return The node that is the location for the event. 40320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson */ 41320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson public Node getOriginatingNode(); 42320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson} 43320c9890e8241fb0ad05de6fa5e6c3eb3aece159Jesse Wilson 44