package java.lang;
import java.lang.annotation.*;
/**
* An informative annotation type used to indicate that an interface
* type declaration is intended to be a <i>functional interface</i> as
* defined by the Java Language Specification.
*
* Conceptually, a functional interface has exactly one abstract
* method. Since {@linkplain java.lang.reflect.Method#isDefault()
* default methods} have an implementation, they are not abstract. If
* an interface declares an abstract method overriding one of the
* public methods of {@code java.lang.Object}, that also does
* <em>not</em> count toward the interface's abstract method count
* since any implementation of the interface will have an
* implementation from {@code java.lang.Object} or elsewhere.
*
* <p>Note that instances of functional interfaces can be created with
* lambda expressions, method references, or constructor references.
*
* <p>If a type is annotated with this annotation type, compilers are
* required to generate an error message unless:
*
* <ul> * <li> The type is an interface type and not an annotation type, enum, or class.
* <li> The annotated type satisfies the requirements of a functional interface.
* </ul> *
* <p>However, the compiler will treat any interface meeting the
* definition of a functional interface as a functional interface
* regardless of whether or not a {@code FunctionalInterface}
* annotation is present on the interface declaration.
*
* @jls 4.3.2. The Class Object
* @jls 9.8 Functional Interfaces
* @jls 9.4.3 Interface Method Body
* @since 1.8
*/
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface FunctionalInterface {}
Conceptually, a functional interface has exactly one abstract method.
Since default methods have an implementation, they are not abstract.
If an interface declares an abstract method overriding one of the public methods of java.lang.Object, that also does not count toward the interface's abstract method count since any implementation of the interface will have an implementation from java.lang.Object or elsewhere.
打捞要点之后有这么三点：
- a functional interface has exactly one abstract method.
要声明FunctionalInterface的接口只能有1个抽象方法;
- Since default methods have an implementation, they are not abstract.
因为default方法有实现，所以它也不是抽象方法, 所以不在列;
- If an interface declares an abstract method overriding one of the public methods of java.lang.Object, that also does not count toward the interface's abstract method count since any implementation of the interface will have an implementation from java.lang.Object or elsewhere.
因为这里限定抽象方法只能有1个，那么如果我的接口里声明了一个 抽象方法"String toString();"或者"boolean equals(Object obj);"这样的，算不算呢？ --->答案是： 不算这个，因为任何实现接口的对象都会继承Object，所以这些public的Object的方法，不算在列的。
也就是说，你的接口可以声名如下：
/**
* Created by niewj on 2017/10/26.
*/
@FunctionalInterface
public interface FunctionalInterfaceSummary {
int doSum(int x, int y); // 抽象方法
String toString(); // 不占1的数额
boolean equals(Object obj); // 不占1的数额
// boolean equals(); // 这个会占1的数额， 因为这不是Object中的方法
default void display() {
System.out.println("show sth..");
}
}
小结：
- 如果一个接口里只限定一个抽象方法，则可以用注解@FunctionalInterface 限定；
- 声明为函数式接口之后，就有以下特征：
a. 只有一个抽象方法；
b. Object类中的public的方法也在接口里写出来的,也可以,因为这写不算；
c. default方法不算， 因为它们是implementation。不是abstract！
