src/share/classes/java/util/function/LongBinaryOperator.java

rev 6189 : 8004015: Add Extends and deaults for basic functional interface types
Summary: Adds the appropriate extends and default methods for  core functional interfaces used by the JSR335 libraries.
Reviewed-by: duke

*** 25,37 ****
  package java.util.function;
  
  /**
   * An operation on two {@code long} operands yielding a {@code long} result.
   *
   * @since 1.8
   */
! public interface LongBinaryOperator {
  
      /**
       * Returns the {@code long} result of the operation upon the {@code long}
       * operands. The parameters are named {@code left} and {@code right} for
       * operations where the order of parameters matters.
--- 25,55 ----
  package java.util.function;
  
  /**
   * An operation on two {@code long} operands yielding a {@code long} result.
   *
+  * <p>This is the primitive type specialization of {@link BinaryOperator} for
+  * {@code long} and also may be used as a {@code BinaryOperator<Long>}. When
+  * used as a {@code BinaryOperator} the default {@code operate} implementation
+  * provided by this interface neither accepts null parameters nor does it return
+  * null results.
+  *
   * @since 1.8
   */
! public interface LongBinaryOperator extends BinaryOperator<Long> {
! 
!     /**
!      * {@inheritDoc}
!      *
!      * @param left {@inheritDoc}, must be non-null
!      * @param right {@inheritDoc}, must be non-null
!      * @return {@inheritDoc}, always non-null
!      */
!     @Override
!     public default Long operate(Long left, Long right) {
!         return operateAsLong((long)left, (long)right);
!     }
  
      /**
       * Returns the {@code long} result of the operation upon the {@code long}
       * operands. The parameters are named {@code left} and {@code right} for
       * operations where the order of parameters matters.