org.eclipse.sisu.inject.BeanLocator Maven / Gradle / Ivy
/*******************************************************************************
* Copyright (c) 2010-present Sonatype, Inc.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Stuart McCulloch (Sonatype, Inc.) - initial API and implementation
*******************************************************************************/
package org.eclipse.sisu.inject;
import java.lang.annotation.Annotation;
import javax.inject.Qualifier;
import org.eclipse.sisu.BeanEntry;
import org.eclipse.sisu.Mediator;
import com.google.inject.ImplementedBy;
import com.google.inject.Key;
/**
* Finds and tracks bean implementations annotated with {@link Qualifier} annotations.
*/
@ImplementedBy( MutableBeanLocator.class )
public interface BeanLocator
{
/**
* Finds bean implementations that match the given qualified binding {@link Key}.
*
* @param key The qualified key
* @return Sequence of bean entries that match the given key
*/
Iterable> locate( Key key );
/**
* Tracks bean implementations that match the given qualified binding {@link Key}.
*
* Uses the {@link Mediator} pattern to send events to an arbitrary watcher object.
*
* @param key The qualified key
* @param mediator The event mediator
* @param watcher The bean watcher
*/
void watch( Key key, Mediator mediator, W watcher );
}