raboof/pekko
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions 11

incorporate review: add docs, see #1952

Browse source
This commit is contained in:
Roland 2012-07-04 10:29:44 +02:00
parent 3c8a15e2df
commit 804c182cc0
1 changed files with 16 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

17
akka-actor/src/main/scala/akka/japi/JavaAPI.scala
View file

@ -58,6 +58,10 @@ object PurePartialFunction {
* `isCheck == true` and the latter to `isCheck == false` for those cases where * `isCheck == true` and the latter to `isCheck == false` for those cases where
* this is important to know. * 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
* <i>that</i> expensive).
*
* {{{ * {{{
* new PurePartialFunction<Object, String>() { * new PurePartialFunction<Object, String>() {
* public String apply(Object in, boolean isCheck) { * public String apply(Object in, boolean isCheck) {
@ -74,7 +78,9 @@ object PurePartialFunction {
* The typical use of partial functions from Akka looks like the following: * The typical use of partial functions from Akka looks like the following:
* *
* {{{ * {{{
* if (pf.isDefinedAt(x)) pf.apply(x) * if (pf.isDefinedAt(x)) {
* pf.apply(x);
* }
* }}} * }}}
* *
* i.e. it will first call `PurePartialFunction.apply(x, true)` and if that * i.e. it will first call `PurePartialFunction.apply(x, true)` and if that
@ -90,6 +96,15 @@ abstract class PurePartialFunction[A, B] extends scala.runtime.AbstractFunction1
final def apply(x: A): B = try apply(x, false) catch { case NoMatch ⇒ throw new MatchError } final def apply(x: A): B = try apply(x, false) catch { case NoMatch ⇒ throw new MatchError }
} }
/**
* This is a specialized variant of PartialFunction which is <b><i>only
* applicable if you know that `isDefinedAt(x)` is always called before
* `apply(x)`—with the same `x` of course.</i></b>
*
* `match(x)` will be called for `isDefinedAt(x)` only, and its semantics
* are the same as for [[akka.japi.PurePartialFunction]] (apart from the
* missing because unneeded boolean argument).
*/
abstract class CachingPartialFunction[A, B <: AnyRef] extends scala.runtime.AbstractFunction1[A, B] with PartialFunction[A, B] { abstract class CachingPartialFunction[A, B <: AnyRef] extends scala.runtime.AbstractFunction1[A, B] with PartialFunction[A, B] {
import PurePartialFunction._ import PurePartialFunction._