Exceptions for XPClass::get*()

Rationale

Allow for chaining, be consistent with other APIs (if a hasX method exists, the getX method will throw an exception) and the getAnnotation() method.

The following can be written in a more concise way:

  $m= XPClass::forName('util.cmd.Runner')->getMethod('main');
  if (!$m) throw new ElementNotFoundException('No "main" method');
  $m->invoke(NULL, array($args));

New:

  XPClass::forName('util.cmd.Runner')->getMethod('main')->invoke(NULL, array($args));

BC break

The following will no longer work:

  if (!($m= $class->getMethod($name))) {
    // The method does not exist
  }

...and must be rewritten to use hasMethod():

  if (!$class->hasMethod($name)) {
    // The method does not exist
  }
  $m= $class->getMethod($name);

If the first version is run, the block below the getMethod() call will never be reached (as it will throw an exception).

n/a

None.

- BC break - increases minor version (at the time of writing, that would mean the next release would be 5.7.0)

- http://xp-framework.net/rfc/contrib/rfc0164.diff Implementing patch

<EOF>