Package akka.japi

Class JavaPartialFunction<A,​B>

  • All Implemented Interfaces:
    scala.Function1<A,​B>, scala.PartialFunction<A,​B>
    public abstract class JavaPartialFunction<A,​B>
extends scala.runtime.AbstractPartialFunction<A,​B>
    Helper for implementing a *pure* partial function: it will possibly be invoked multiple times for a single &ldquo;application&rdquo;, because its only abstract method is used for both isDefinedAt() and apply(); the former is mapped to isCheck == true and the latter to isCheck == false for those cases where this is important to know.

    Failure to match is signaled by throwing noMatch(), i.e. not returning normally (the exception used in this case is pre-allocated, hence not that expensive). 

    
 new JavaPartialFunction<Object, String>() {
   public String apply(Object in, boolean isCheck) {
     if (in instanceof TheThing) {
       if (isCheck) return null; // to spare the expensive or side-effecting code
       return doSomethingWithTheThing((TheThing) in);
     } else {
       throw noMatch();
     }
   }
 }

    The typical use of partial functions from Akka looks like the following: 

    
 if (pf.isDefinedAt(x)) {
   pf.apply(x);
 }

    i.e. it will first call JavaPartialFunction.apply(x, true) and if that does not throw noMatch() it will continue with calling JavaPartialFunction.apply(x, false).

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  JavaPartialFunction.NoMatch$  
      static class  JavaPartialFunction.NoMatchException  

      • Nested classes/interfaces inherited from interface scala.Function1

        scala.Function1.UnliftOps<A extends java.lang.Object,​B extends java.lang.Object>, scala.Function1.UnliftOps$

      • Nested classes/interfaces inherited from interface scala.PartialFunction

        scala.PartialFunction.ElementWiseExtractor<A extends java.lang.Object,​B extends java.lang.Object>, scala.PartialFunction.ElementWiseExtractor$

    • Method Summary

      All Methods Static Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      B apply​(A x)  
      abstract B apply​(A x, boolean isCheck)  
      <A1 extends A,​B1>
      B1      		 applyOrElse​(A1 x, scala.Function1<A1,​B1> default_)  
      boolean isDefinedAt​(A x)  
      static java.lang.RuntimeException noMatch()  

      • Methods inherited from class scala.runtime.AbstractPartialFunction

        andThen, andThen, apply$mcDD$sp, apply$mcDF$sp, apply$mcDI$sp, apply$mcDJ$sp, apply$mcFD$sp, apply$mcFF$sp, apply$mcFI$sp, apply$mcFJ$sp, apply$mcID$sp, apply$mcIF$sp, apply$mcII$sp, apply$mcIJ$sp, apply$mcJD$sp, apply$mcJF$sp, apply$mcJI$sp, apply$mcJJ$sp, apply$mcVD$sp, apply$mcVF$sp, apply$mcVI$sp, apply$mcVJ$sp, apply$mcZD$sp, apply$mcZF$sp, apply$mcZI$sp, apply$mcZJ$sp, compose, compose, elementWise, lift, orElse, runWith, toString, unapply

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

    • Constructor Detail

      • JavaPartialFunction

        public JavaPartialFunction()

    • Method Detail

      • noMatch

        public static final java.lang.RuntimeException noMatch()

      • apply

        public abstract B apply​(A x,
                        boolean isCheck)
                 throws java.lang.Exception
        Throws:
        java.lang.Exception

      • isDefinedAt

        public final boolean isDefinedAt​(A x)

      • apply

        public final B apply​(A x)
        Specified by:
        apply in interface scala.Function1<A,​B>
        Overrides:
        apply in class scala.runtime.AbstractPartialFunction<A,​B>

      • applyOrElse

        public final <A1 extends A,​B1> B1 applyOrElse​(A1 x,
                                                    scala.Function1<A1,​B1> default_)
        Specified by:
        applyOrElse in interface scala.PartialFunction<A,​B>
        Overrides:
        applyOrElse in class scala.runtime.AbstractPartialFunction<A,​B>