Desire (Grapht Dependency Injector 0.9.1 API)

All Superinterfaces:

Serializable

All Known Implementing Classes:

ReflectionDesire
```
public interface Desire
extends Serializable
```
A possibly-not-concrete type. This represents the type of a dependency; it may or may not be concrete. It can effectively be any type. Desires are iteratively resolved and narrowed until they finally correspond to Satisfactions.

Author:

GroupLens Research

Method Summary

Methods
Modifier and Type	Method and Description
`Class<?>`	`getDesiredType()`
`InjectionPoint`	`getInjectionPoint()`
`Satisfaction`	`getSatisfaction()` Get the satisfaction (concrete type) if this desire is fully resolved.
`boolean`	`isInstantiable()` Query whether this desire is instantiable, that is, resolved to a concrete type.
`Desire`	`restrict(Class<?> type)` Return a new Desire that restricts the type of this desire to the given class.
`Desire`	`restrict(Satisfaction satisfaction)` Return a new Desire that restricts the type of this desire to the erased type of the satisfaction.

- Method Detail
  - isInstantiable
```
boolean isInstantiable()
```
    Query whether this desire is instantiable, that is, resolved to a concrete type. If it is instantiable, then it can be converted to a Satisfaction with getSatisfaction().
    
    Returns:
    true if the desire is for a concrete class. The only further desires or satisfactions that can satisfy it are for subclasses of the desire type.
  - getSatisfaction
```
Satisfaction getSatisfaction()
```
    Get the satisfaction (concrete type) if this desire is fully resolved.
    
    Returns:
    The satisfaction for this desire, or null if the desire is not a concrete type.
  - getInjectionPoint
```
InjectionPoint getInjectionPoint()
```
    Returns:
    The injection point of this desire
  - getDesiredType
```
Class<?> getDesiredType()
```
    Returns:
    The desired type, potentially more constrained than the injection point's type
  - restrict
```
Desire restrict(Class<?> type)
```
    Return a new Desire that restricts the type of this desire to the given class. The type must be a subclass of the desired type.
    
    Parameters:
    type - The restricted type
    
    Returns:
    A restricted Desire
  - restrict
```
Desire restrict(Satisfaction satisfaction)
```
    Return a new Desire that restricts the type of this desire to the erased type of the satisfaction. The returned Desire will also be instantiable and return the provided satisfaction from getSatisfaction().
    
    Parameters:
    satisfaction - The satisfaction to restrict this desire to
    
    Returns:
    A restricted and satisfied desire

Interface Desire

Method Summary

Method Detail

isInstantiable

getSatisfaction

getInjectionPoint

getDesiredType

restrict

restrict