se.jbee.inject.Instance 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;

/**
 * Used to tell that we don#t want just one singleton at a time but multiple distinguished by the
 * {@link Name} used.
 * 
 * @author Jan Bernitt ([email protected])
 * 
 */
public final class Instance
		implements Typed, Named, PreciserThan>, Parameter {

	/**
	 * When a wildcard-type is used as bound instance type the bind will be added to all concrete
	 * binds of matching types. There is also a set of wildcard binds that are tried if no bind has
	 * been made for a type.
	 */
	public static final Instance ANY = anyOf( Type.WILDCARD );

	public static  Instance defaultInstanceOf( Type type ) {
		return instance( Name.DEFAULT, type );
	}

	public static  Instance anyOf( Class type ) {
		return anyOf( raw( type ) );
	}

	public static  Instance anyOf( Type type ) {
		return instance( Name.ANY, type );
	}

	public static Instance[] anyOf( Type... types ) {
		Instance[] instances = new Instance[types.length];
		for ( int i = 0; i < instances.length; i++ ) {
			instances[i] = anyOf( types[i] );
		}
		return instances;
	}

	public static  Instance instance( Name name, Type type ) {
		return new Instance( name, type );
	}

	private final Name name;
	private final Type type;

	private Instance( Name name, Type type ) {
		super();
		this.name = name;
		this.type = type;
	}

	public boolean equalTo( Instance other ) {
		return type.equalTo( other.type ) && name.equals( other.name );
	}

	public Instance discriminableBy( Name name ) {
		return new Instance( name, type );
	}

	@Override
	public Type getType() {
		return type;
	}

	@Override
	public  Instance typed( Type type ) {
		return new Instance( name, type );
	}

	@Override
	public Name getName() {
		return name;
	}

	@Override
	public String toString() {
		return ( name + " " + type ).trim();
	}

	public boolean isAny() {
		return name.isAny() && type.equalTo( ANY.type );
	}

	@Override
	public boolean morePreciseThan( Instance other ) {
		// sequence in OR is very important!!!
		return morePreciseThan2( type, other.type, name, other.name );
	}

	@Override
	public boolean isAssignableTo( Type type ) {
		return getType().isAssignableTo( type );
	}

}