xapi.annotation.inject

Annotation Type InstanceOverride

@Target(value=TYPE)
@Retention(value=RUNTIME)
public @interface InstanceOverride

An annotation used to map an interface to a given implementation on a per-runtime basis.

When the wetheinter.net.inject.X_Inject generator processes classes, it chooses a single injection target based on priority. If a class is requested as an instance, and no override is in scope, a new instance of that class will be provided (an annotated binding is optional, unless you are injecting an interface).

The #platform() parameter currently only differentiates between gwt and pure java; A service marked with PlatformType.All will be injected into all builds, those marked with PlatformType.GwtAll will be in both dev mode and compiled gwt. PlatformType.GwtScript is for compiled / super dev mode. PlatformType.GwtScript is for dev mode only. Use PlatformType.Java to include a class in META-INF/singletons, but exclude from Gwt.

The other platform types will be implemented as needed to support the full PlayN stack.

Author:

James X. Nelson (james@wetheinter.net, @james)

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
Class<?>	implFor

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
int	priority

Element Detail

implFor

public abstract Class<?> implFor

Returns:

- The service interface or base class the inject instance implements / overrides. It is valid for a class (but not an interface) to select itself as the service to target.

priority

public abstract int priority

Returns:

- A descending-order prioritized list used to select the injected implementation. If you expect your override to be further overridden in submodules, pick a negative priority.

Default:

-2147483648