se.jbee.inject.Resource Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of silk-di Show documentation
Silk Java dependency injection framework
There is a newer version: 0.6
/*
 *  Copyright (c) 2012, Jan Bernitt 
 *			
 *  Licensed under the Apache License, Version 2.0, http://www.apache.org/licenses/LICENSE-2.0
 */
package se.jbee.inject;

import static se.jbee.inject.Precision.morePreciseThan2;
import static se.jbee.inject.Type.raw;

/**
 * Describes WHAT can be injected and WHERE it can be injected.
 * 
 * It is an {@link Instance} with added information where the bind applies.
 * 
 * @author Jan Bernitt ([email protected])
 */
public final class Resource
		implements Typed, Named, PreciserThan> {

	public static  Resource resource( Class type ) {
		return new Resource( Instance.anyOf( raw( type ) ) );
	}

	private final Instance instance;
	private final Target target;

	public Resource( Instance instance ) {
		this( instance, Target.ANY );
	}

	public Resource( Instance instance, Target target ) {
		super();
		this.instance = instance;
		this.target = target;
	}

	public boolean isApplicableFor( Dependency dependency ) {
		return isAdequateFor( dependency ) // check names first since default goes sorts first but will not match any named 
				&& isAvailableFor( dependency )//
				&& isAssignableTo( dependency ); // most 'expensive' check so we do it last
	}

	public boolean isSuitableFor( Dependency dependency ) {
		return isAdequateFor( dependency ) && isAssignableTo( dependency );
	}

	/**
	 * Does the {@link Type} of this a valid argument for the one of the {@link Dependency} given ?
	 */
	public boolean isAssignableTo( Dependency dependency ) {
		return instance.getType().isAssignableTo( dependency.getType() );
	}

	/**
	 * Does the given {@link Dependency} occur in the right package and for the right target ?
	 */
	public boolean isAvailableFor( Dependency dependency ) {
		return target.isApplicableFor( dependency );
	}

	/**
	 * Does this resource provide the instance wanted by the given {@link Dependency}'s {@link Name}
	 */
	public boolean isAdequateFor( Dependency dependency ) {
		return instance.getName().isApplicableFor( dependency.getName() );
	}

	@Override
	public Type getType() {
		return instance.getType();
	}

	@Override
	public boolean morePreciseThan( Resource other ) {
		return morePreciseThan2( instance, other.instance, target, other.target );
	}

	@Override
	public String toString() {
		return instance + " " + target;
	}

	@Override
	public Name getName() {
		return instance.getName();
	}

	public Instance getInstance() {
		return instance;
	}

	public Target getTarget() {
		return target;
	}

	@Override
	public  Resource typed( Type type ) {
		return new Resource( instance.typed( type ), target );
	}

	public boolean equalTo( Resource other ) {
		return this == other || instance.equalTo( other.instance ) && target.equalTo( other.target );
	}
}