/*
 * Copyright 2002-2017 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
 *
 *      http://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.config;

import org.springframework.lang.Nullable;
import org.springframework.util.Assert;

Immutable placeholder class used for a property value object when it's a reference to another bean in the factory, to be resolved at runtime.
Author:Rod Johnson, Juergen Hoeller
See Also:
/** * Immutable placeholder class used for a property value object when it's * a reference to another bean in the factory, to be resolved at runtime. * * @author Rod Johnson * @author Juergen Hoeller * @see BeanDefinition#getPropertyValues() * @see org.springframework.beans.factory.BeanFactory#getBean */
public class RuntimeBeanReference implements BeanReference { private final String beanName; private final boolean toParent; @Nullable private Object source;
Create a new RuntimeBeanReference to the given bean name, without explicitly marking it as reference to a bean in the parent factory.
Params:
  • beanName – name of the target bean
/** * Create a new RuntimeBeanReference to the given bean name, * without explicitly marking it as reference to a bean in * the parent factory. * @param beanName name of the target bean */
public RuntimeBeanReference(String beanName) { this(beanName, false); }
Create a new RuntimeBeanReference to the given bean name, with the option to mark it as reference to a bean in the parent factory.
Params:
  • beanName – name of the target bean
  • toParent – whether this is an explicit reference to a bean in the parent factory
/** * Create a new RuntimeBeanReference to the given bean name, * with the option to mark it as reference to a bean in * the parent factory. * @param beanName name of the target bean * @param toParent whether this is an explicit reference to * a bean in the parent factory */
public RuntimeBeanReference(String beanName, boolean toParent) { Assert.hasText(beanName, "'beanName' must not be empty"); this.beanName = beanName; this.toParent = toParent; } @Override public String getBeanName() { return this.beanName; }
Return whether this is an explicit reference to a bean in the parent factory.
/** * Return whether this is an explicit reference to a bean * in the parent factory. */
public boolean isToParent() { return this.toParent; }
Set the configuration source Object for this metadata element.

The exact type of the object will depend on the configuration mechanism used.

/** * Set the configuration source {@code Object} for this metadata element. * <p>The exact type of the object will depend on the configuration mechanism used. */
public void setSource(@Nullable Object source) { this.source = source; } @Override @Nullable public Object getSource() { return this.source; } @Override public boolean equals(Object other) { if (this == other) { return true; } if (!(other instanceof RuntimeBeanReference)) { return false; } RuntimeBeanReference that = (RuntimeBeanReference) other; return (this.beanName.equals(that.beanName) && this.toParent == that.toParent); } @Override public int hashCode() { int result = this.beanName.hashCode(); result = 29 * result + (this.toParent ? 1 : 0); return result; } @Override public String toString() { return '<' + getBeanName() + '>'; } }