infra.beans.factory.config.ListFactoryBean Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of today-beans Show documentation
Infra Beans
The newest version!
/*
 * Copyright 2017 - 2024 the original author or authors.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see [https://www.gnu.org/licenses/]
 */
package infra.beans.factory.config;

import java.util.ArrayList;
import java.util.List;

import infra.beans.BeanUtils;
import infra.beans.TypeConverter;
import infra.core.ResolvableType;
import infra.lang.Nullable;

/**
 * Simple factory for shared List instances. Allows for central setup
 * of Lists via the "list" element in XML bean definitions.
 *
 * @author Juergen Hoeller
 * @author Harry Yang
 * @see SetFactoryBean
 * @see MapFactoryBean
 * @since 4.0 2021/11/30 13:57
 */
public class ListFactoryBean extends AbstractFactoryBean> {

  @Nullable
  private List sourceList;

  @SuppressWarnings("rawtypes")
  @Nullable
  private Class targetListClass;

  /**
   * Set the source List, typically populated via XML "list" elements.
   */
  public void setSourceList(@Nullable List sourceList) {
    this.sourceList = sourceList;
  }

  /**
   * Set the class to use for the target List. Can be populated with a fully
   * qualified class name when defined in a Framework application context.
   * Default is a {@code java.util.ArrayList}.
   *
   * @see java.util.ArrayList
   */
  @SuppressWarnings("rawtypes")
  public void setTargetListClass(@Nullable Class targetListClass) {
    if (targetListClass == null) {
      throw new IllegalArgumentException("'targetListClass' is required");
    }
    if (!List.class.isAssignableFrom(targetListClass)) {
      throw new IllegalArgumentException("'targetListClass' must implement [java.util.List]");
    }
    this.targetListClass = targetListClass;
  }

  @Override
  @SuppressWarnings("rawtypes")
  public Class getObjectType() {
    return List.class;
  }

  @Override
  @SuppressWarnings("unchecked")
  protected List