/*
 * Copyright 2002-2018 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.beans.factory.xml;

import java.util.ArrayDeque;
import java.util.Deque;

import org.springframework.beans.factory.config.BeanDefinition;
import org.springframework.beans.factory.parsing.BeanComponentDefinition;
import org.springframework.beans.factory.parsing.ComponentDefinition;
import org.springframework.beans.factory.parsing.CompositeComponentDefinition;
import org.springframework.beans.factory.support.BeanDefinitionReaderUtils;
import org.springframework.beans.factory.support.BeanDefinitionRegistry;
import org.springframework.lang.Nullable;

Context that gets passed along a bean definition parsing process, encapsulating all relevant configuration as well as state. Nested inside an XmlReaderContext.
Author:Rob Harrop, Juergen Hoeller
See Also:
Since:2.0
/** * Context that gets passed along a bean definition parsing process, * encapsulating all relevant configuration as well as state. * Nested inside an {@link XmlReaderContext}. * * @author Rob Harrop * @author Juergen Hoeller * @since 2.0 * @see XmlReaderContext * @see BeanDefinitionParserDelegate */
public final class ParserContext { private final XmlReaderContext readerContext; private final BeanDefinitionParserDelegate delegate; @Nullable private BeanDefinition containingBeanDefinition; private final Deque<CompositeComponentDefinition> containingComponents = new ArrayDeque<>(); public ParserContext(XmlReaderContext readerContext, BeanDefinitionParserDelegate delegate) { this.readerContext = readerContext; this.delegate = delegate; } public ParserContext(XmlReaderContext readerContext, BeanDefinitionParserDelegate delegate, @Nullable BeanDefinition containingBeanDefinition) { this.readerContext = readerContext; this.delegate = delegate; this.containingBeanDefinition = containingBeanDefinition; } public final XmlReaderContext getReaderContext() { return this.readerContext; } public final BeanDefinitionRegistry getRegistry() { return this.readerContext.getRegistry(); } public final BeanDefinitionParserDelegate getDelegate() { return this.delegate; } @Nullable public final BeanDefinition getContainingBeanDefinition() { return this.containingBeanDefinition; } public final boolean isNested() { return (this.containingBeanDefinition != null); } public boolean isDefaultLazyInit() { return BeanDefinitionParserDelegate.TRUE_VALUE.equals(this.delegate.getDefaults().getLazyInit()); } @Nullable public Object extractSource(Object sourceCandidate) { return this.readerContext.extractSource(sourceCandidate); } @Nullable public CompositeComponentDefinition getContainingComponent() { return this.containingComponents.peek(); } public void pushContainingComponent(CompositeComponentDefinition containingComponent) { this.containingComponents.push(containingComponent); } public CompositeComponentDefinition popContainingComponent() { return this.containingComponents.pop(); } public void popAndRegisterContainingComponent() { registerComponent(popContainingComponent()); } public void registerComponent(ComponentDefinition component) { CompositeComponentDefinition containingComponent = getContainingComponent(); if (containingComponent != null) { containingComponent.addNestedComponent(component); } else { this.readerContext.fireComponentRegistered(component); } } public void registerBeanComponent(BeanComponentDefinition component) { BeanDefinitionReaderUtils.registerBeanDefinition(component, getRegistry()); registerComponent(component); } }