/*
 * This code is distributed under The GNU Lesser General Public License (LGPLv3)
 * Please visit GNU site for LGPLv3 http://www.gnu.org/copyleft/lesser.html
 *
 * Copyright Denis Pavlov 2009
 * Web: http://www.genericdtoassembler.org
 * SVN: https://svn.code.sf.net/p/geda-genericdto/code/trunk/
 * SVN (mirror): http://geda-genericdto.googlecode.com/svn/trunk/
 */

package com.inspiresoftware.lib.dto.geda.adapter;

import com.inspiresoftware.lib.dto.geda.assembler.extension.DisposableContainer;

/**
 * Bean factory with capabilities to add new mappings during runtime.
 *
 * @since 3.0.0
 *
 * User: denispavlov
 * Date: 12-09-20
 * Time: 1:39 PM
 */
public interface ExtensibleBeanFactory extends BeanFactory, DisposableContainer {

    /**
     * Allows to enrich bean factory with new bean mappings
     *
     * @param key string key for this class (interface name preferred)
     * @param className fully qualified string representation of java class.
     *        No check is made regarding the validity of this class and if it is invalid
     *        will cause exception during #get()
     *
     * @throws IllegalArgumentException if either parameters are null or empty, or if
     *         this key is already used.
     */
    void registerDto(final String key, final String className) throws IllegalArgumentException;


    /**
     * Allows to enrich bean factory with new bean mappings
     *
     * @param key string key for this class (interface name preferred)
     * @param className fully qualified string representation of java class.
     *        No check is made regarding the validity of this class and if it is invalid
     *        will cause exception during #get()
     * @param representative fully qualified string representation of a java interface
     *        that best describes #className class.
     *
     * @throws IllegalArgumentException if either parameters are null or empty, or if
     *         this key is already used.
     */
    void registerEntity(final String key, final String className, final String representative) throws IllegalArgumentException;

}