1 /* 2 * Copyright 2002-2006 the original author or authors. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package org.springframework.beans.factory.parsing; 18 19 import org.springframework.core.io.Resource; 20 21 /** 22 * Simple {@link SourceExtractor} implementation that just passes 23 * the candidate source metadata object through for attachment. 24 * 25 * <p>Using this implementation means that tools will get raw access to the 26 * underlying configuration source metadata provided by the tool. 27 * 28 * <p>This implementation <strong>should not</strong> be used in a production 29 * application since it is likely to keep too much metadata in memory 30 * (unnecessarily). 31 * 32 * @author Rob Harrop 33 * @since 2.0 34 */ 35 public class PassThroughSourceExtractor implements SourceExtractor { 36 37 /** 38 * Simply returns the supplied <code>sourceCandidate</code> as-is. 39 * @param sourceCandidate the source metadata 40 * @return the supplied <code>sourceCandidate</code> 41 */ 42 public Object extractSource(Object sourceCandidate, Resource definingResource) { 43 return sourceCandidate; 44 } 45 46 } 47