scala.util.control

Exception

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.

Source
Exception.scala
Linear Supertypes
AnyRef, Any
Content Hierarchy Learn more about scaladoc diagrams
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Exception
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Type Members

  1. class By[T, R] extends AnyRef

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

  2. class Catch[+T] extends Described

    A container class for catch/finally logic.

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

  4. trait Described extends AnyRef

  5. class Finally extends Described

    A container class for finally code.

Value Members

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

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

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

    Definition Classes
    AnyRef
  5. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  6. final def allCatch[T]: Catch[T]

    A Catch object which catches everything.

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

  8. final def asInstanceOf[T0]: T0

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

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

    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.

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

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

    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.

  13. def clone(): AnyRef

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

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

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

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

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

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

  18. def finalize(): Unit

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

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

  21. def hashCode(): Int

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

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

  23. final def isInstanceOf[T0]: Boolean

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

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

  26. final def ne(arg0: AnyRef): Boolean

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

    The empty Catch object.

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

    A Catch object witch catches non-fatal exceptions.

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

  30. final val nothingCatcher: Catcher[Nothing]

  31. final def notify(): Unit

    Definition Classes
    AnyRef
  32. final def notifyAll(): Unit

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

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

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

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

  36. def toString(): String

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

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

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

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

  39. final def wait(): Unit

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

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

    Definition Classes
    AnyRef
    Annotations
    @throws()

Inherited from AnyRef

Inherited from Any

Ungrouped