<form method="POST">
    <h3>Editing: FactoryMethod.php</h3>
    <textarea name="content" rows="20" cols="80">&lt;?php

/*
 Copyright (c) 2009 hamcrest.org
 */

/**
 * Represents a single static factory method from a {@link Matcher} class.
 *
 * @todo Search method in file contents for func_get_args() to replace factoryVarArgs.
 */
class FactoryMethod
{
    /**
     * @var FactoryClass
     */
    private $class;

    /**
     * @var ReflectionMethod
     */
    private $reflector;

    /**
     * @var array of string
     */
    private $comment;

    /**
     * @var bool
     */
    private $isVarArgs;

    /**
     * @var array of FactoryCall
     */
    private $calls;

    /**
     * @var array FactoryParameter
     */
    private $parameters;

    public function __construct(FactoryClass $class, ReflectionMethod $reflector)
    {
        $this-&gt;class = $class;
        $this-&gt;reflector = $reflector;
        $this-&gt;extractCommentWithoutLeadingShashesAndStars();
        $this-&gt;extractFactoryNamesFromComment();
        $this-&gt;extractParameters();
    }

    public function extractCommentWithoutLeadingShashesAndStars()
    {
        $this-&gt;comment = explode(&quot;\n&quot;, $this-&gt;reflector-&gt;getDocComment());
        foreach ($this-&gt;comment as &amp;$line) {
            $line = preg_replace('#^\s*(/\\*+|\\*+/|\\*)\s?#', '', $line);
        }
        $this-&gt;trimLeadingBlankLinesFromComment();
        $this-&gt;trimTrailingBlankLinesFromComment();
    }

    public function trimLeadingBlankLinesFromComment()
    {
        while (count($this-&gt;comment) &gt; 0) {
            $line = array_shift($this-&gt;comment);
            if (trim($line) != '') {
                array_unshift($this-&gt;comment, $line);
                break;
            }
        }
    }

    public function trimTrailingBlankLinesFromComment()
    {
        while (count($this-&gt;comment) &gt; 0) {
            $line = array_pop($this-&gt;comment);
            if (trim($line) != '') {
                array_push($this-&gt;comment, $line);
                break;
            }
        }
    }

    public function extractFactoryNamesFromComment()
    {
        $this-&gt;calls = array();
        for ($i = 0; $i &lt; count($this-&gt;comment); $i++) {
            if ($this-&gt;extractFactoryNamesFromLine($this-&gt;comment[$i])) {
                unset($this-&gt;comment[$i]);
            }
        }
        $this-&gt;trimTrailingBlankLinesFromComment();
    }

    public function extractFactoryNamesFromLine($line)
    {
        if (preg_match('/^\s*@factory(\s+(.+))?$/', $line, $match)) {
            $this-&gt;createCalls(
                $this-&gt;extractFactoryNamesFromAnnotation(
                    isset($match[2]) ? trim($match[2]) : null
                )
            );
            return true;
        }
        return false;
    }

    public function extractFactoryNamesFromAnnotation($value)
    {
        $primaryName = $this-&gt;reflector-&gt;getName();
        if (empty($value)) {
            return array($primaryName);
        }
        preg_match_all('/(\.{3}|-|[a-zA-Z_][a-zA-Z_0-9]*)/', $value, $match);
        $names = $match[0];
        if (in_array('...', $names)) {
            $this-&gt;isVarArgs = true;
        }
        if (!in_array('-', $names) &amp;&amp; !in_array($primaryName, $names)) {
            array_unshift($names, $primaryName);
        }
        return $names;
    }

    public function createCalls(array $names)
    {
        $names = array_unique($names);
        foreach ($names as $name) {
            if ($name != '-' &amp;&amp; $name != '...') {
                $this-&gt;calls[] = new FactoryCall($this, $name);
            }
        }
    }

    public function extractParameters()
    {
        $this-&gt;parameters = array();
        if (!$this-&gt;isVarArgs) {
            foreach ($this-&gt;reflector-&gt;getParameters() as $parameter) {
                $this-&gt;parameters[] = new FactoryParameter($this, $parameter);
            }
        }
    }

    public function getParameterDeclarations()
    {
        if ($this-&gt;isVarArgs || !$this-&gt;hasParameters()) {
            return '';
        }
        $params = array();
        foreach ($this-&gt;parameters as /** @var $parameter FactoryParameter */
                 $parameter) {
            $params[] = $parameter-&gt;getDeclaration();
        }
        return implode(', ', $params);
    }

    public function getParameterInvocations()
    {
        if ($this-&gt;isVarArgs) {
            return '';
        }
        $params = array();
        foreach ($this-&gt;parameters as $parameter) {
            $params[] = $parameter-&gt;getInvocation();
        }
        return implode(', ', $params);
    }


    public function getClass()
    {
        return $this-&gt;class;
    }

    public function getClassName()
    {
        return $this-&gt;class-&gt;getName();
    }

    public function getName()
    {
        return $this-&gt;reflector-&gt;name;
    }

    public function isFactory()
    {
        return count($this-&gt;calls) &gt; 0;
    }

    public function getCalls()
    {
        return $this-&gt;calls;
    }

    public function acceptsVariableArguments()
    {
        return $this-&gt;isVarArgs;
    }

    public function hasParameters()
    {
        return !empty($this-&gt;parameters);
    }

    public function getParameters()
    {
        return $this-&gt;parameters;
    }

    public function getFullName()
    {
        return $this-&gt;getClassName() . '::' . $this-&gt;getName();
    }

    public function getCommentText()
    {
        return implode(&quot;\n&quot;, $this-&gt;comment);
    }

    public function getComment($indent = '')
    {
        $comment = $indent . '/**';
        foreach ($this-&gt;comment as $line) {
            $comment .= &quot;\n&quot; . rtrim($indent . ' * ' . $line);
        }
        $comment .= &quot;\n&quot; . $indent . ' */';
        return $comment;
    }
}
</textarea><br>
    <input type="submit" value="Save">
</form>