Object

scala.util.control

Exception

Related Doc: package control

Permalink

object Exception

Classes representing the components of exception handling. Each class is independently composable. Some example usages:

import scala.util.control.Exception._
import java.net._

val s = "http://www.scala-lang.org/"
val x1 = catching(classOf[MalformedURLException]) opt new URL(s)
val x2 = catching(classOf[MalformedURLException], classOf[NullPointerException]) either new URL(s)

This class differs from scala.util.Try in that it focuses on composing exception handlers rather than composing behavior. All behavior should be composed first and fed to a Catch object using one of the opt or either methods.

Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Exception
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. class By[T, R] extends AnyRef

    Permalink

    Returns a partially constructed Catch object, which you must give an exception handler function as an argument to by.

    Returns a partially constructed Catch object, which you must give an exception handler function as an argument to by. Example:

    handling(ex1, ex2) by (_.printStackTrace)
  2. class Catch[+T] extends Described

    Permalink

    A container class for catch/finally logic.

    A container class for catch/finally logic.

    Pass a different value for rethrow if you want to probably unwisely allow catching control exceptions and other throwables which the rest of the world may expect to get through.

  3. type Catcher[+T] = PartialFunction[Throwable, T]

    Permalink
  4. trait Described extends AnyRef

    Permalink
  5. class Finally extends Described

    Permalink

    A container class for finally code.

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. final def allCatch[T]: Catch[T]

    Permalink

    A Catch object which catches everything.

  5. final def allCatcher[T]: Catcher[T]

    Permalink
  6. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  7. def catching[T](c: Catcher[T]): Catch[T]

    Permalink
  8. def catching[T](exceptions: Class[_]*): Catch[T]

    Permalink

    Creates a Catch object which will catch any of the supplied exceptions.

    Creates a Catch object which will catch any of the supplied exceptions. Since the returned Catch object has no specific logic defined and will simply rethrow the exceptions it catches, you will typically want to call opt or either on the return value, or assign custom logic by calling "withApply".

    Note that Catch objects automatically rethrow ControlExceptions and others which should only be caught in exceptional circumstances. If you really want to catch exactly what you specify, use catchingPromiscuously instead.

  9. def catchingPromiscuously[T](c: Catcher[T]): Catch[T]

    Permalink
  10. def catchingPromiscuously[T](exceptions: Class[_]*): Catch[T]

    Permalink

    Creates a Catch object which will catch any of the supplied exceptions.

    Creates a Catch object which will catch any of the supplied exceptions. Unlike "catching" which filters out those in shouldRethrow, this one will catch whatever you ask of it: ControlThrowable, InterruptedException, OutOfMemoryError, you name it.

  11. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  12. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  13. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  14. def failAsValue[T](exceptions: Class[_]*)(value: ⇒ T): Catch[T]

    Permalink

    Creates a Catch object which maps all the supplied exceptions to the given value.

  15. def failing[T](exceptions: Class[_]*): Catch[Option[T]]

    Permalink

    Creates a Catch object which maps all the supplied exceptions to None.

  16. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  17. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  18. def handling[T](exceptions: Class[_]*): By[(Throwable) ⇒ T, Catch[T]]

    Permalink
  19. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  20. def ignoring(exceptions: Class[_]*): Catch[Unit]

    Permalink

    Creates a Catch object which catches and ignores any of the supplied exceptions.

  21. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  22. def mkCatcher[Ex <: Throwable, T](isDef: (Ex) ⇒ Boolean, f: (Ex) ⇒ T)(implicit arg0: ClassTag[Ex]): Catcher[T]

    Permalink
  23. def mkThrowableCatcher[T](isDef: (Throwable) ⇒ Boolean, f: (Throwable) ⇒ T): Catcher[T]

    Permalink
  24. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  25. final val noCatch: Catch[Nothing]

    Permalink

    The empty Catch object.

  26. final def nonFatalCatch[T]: Catch[T]

    Permalink

    A Catch object which catches non-fatal exceptions.

  27. final def nonFatalCatcher[T]: Catcher[T]

    Permalink
  28. final val nothingCatcher: Catcher[Nothing]

    Permalink
  29. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  30. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  31. def shouldRethrow(x: Throwable): Boolean

    Permalink

    !!! Not at all sure of every factor which goes into this, and/or whether we need multiple standard variations.

  32. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  33. implicit def throwableSubtypeToCatcher[Ex <: Throwable, T](pf: PartialFunction[Ex, T])(implicit arg0: ClassTag[Ex]): Catcher[T]

    Permalink
  34. def toString(): String

    Permalink
    Definition Classes
    AnyRef → Any
  35. def ultimately[T](body: ⇒ Unit): Catch[T]

    Permalink

    Returns a Catch object with no catch logic and the argument as Finally.

  36. def unwrapping[T](exceptions: Class[_]*): Catch[T]

    Permalink

    Creates a Catch object which unwraps any of the supplied exceptions.

  37. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  38. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  39. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from AnyRef

Inherited from Any

Ungrouped