pro.projo.interfaces.annotation

Annotation Type Interface

@Target(value=PACKAGE)
 @Retention(value=RUNTIME)
 @Repeatable(value=Interfaces.class)
public @interface Interface

The Interface annotation captures the necessary information for generating an interface from an existing class (or existing interface) while filtering for certain modifiers. This also works for modifiers that are not compatible with interfaces, like e.g. static, which is useful for extracting factory interfaces and similar patterns. For example, the original class may have a number of static final methods for creating new objects; in the generated interface these methods will just appear as regular non-static, non-final methods.

Author:

Mirko Raner

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
Class<?>	from
String	generate

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Map[]	map
Modifier[]	modifiers Indicates which modifiers a method in the original class must have so that it will be included in the generated interface.

Element Detail

generate

public abstract String generate

Returns:

the simple name of the interface to be generated

from

public abstract Class<?> from

Returns:

the original class (or interface) from which the new interface will be generated

modifiers

public abstract Modifier[] modifiers

Indicates which modifiers a method in the original class must have so that it will be included in the generated interface. By default, this list is empty, i.e. all methods will be included, irrespective of their modifiers. If this list contains more than one element, the modifiers are combined using an and operation; for example, if the list is PUBLIC, FINAL, STATIC then only those methods will be included that are public and final and static. To realize an or operation, multiple @Interface annotations need to be used.

Returns:

the method modifiers to be used for filtering

Default:

{}

map

public abstract Map[] map

Returns:

optional type mappings, if any

Default:

{}