#2861: Support throw of static methods

[Aerendir]

#2889 (general discussion: #2861).

What this should support

function throwThroughStaticMethod()
{
    throw ExcetionFactory::createException();
}

Explanation

See the test case here: https://github.com/rectorphp/rector/blob/71ad810c8c777def532af6ff22be6d4d900b3bdd/rules/coding-style/tests/Rector/Throw_/AnnotateThrowablesRector/Fixture/factory_static_method_with_return_dockblock.php.inc

The problem is to read the Docblock of the invoked method.

One approach, as suggested in #2861 (#2861 (comment)) is to use the reflection.

Currently it is possible to obtain the Docblock using reflection, but the docblock is obtained as a simple string and it cannot be parsed.

Obtaining a simple string is useless, as it makes impossible to know which classes are actually returned.

    /**
     * This is the DocComment of createExceptionEccolo().
     *
     * @param int $code
     *
     * @return TheException|TheExceptionTheSecond|TheExceptionTheThird|\RuntimeException
     */

Is TheException something like Namespace1\TheException or is it Namespace2\TheExeception?

Without being able to access a parsed version of the Docblock, it is impossible to know what is returned by the invoked static method.

@TomasVotruba , WDYT?

[Aerendir]

@TomasVotruba , ready to be merged! 💪

[TomasVotruba]

Great job!