interface ParamConverterInterface

interface ParamConverterInterface {
    
    /**
     * Converts path variables to their corresponding objects.
     *
     * @param mixed $value
     *   The raw value.
     * @param mixed $definition
     *   The parameter definition provided in the route options.
     * @param string $name
     *   The name of the parameter.
     * @param array $defaults
     *   The route defaults array.
     *
     * @return mixed|null
     *   The converted parameter value.
     */
    public function convert($value, $definition, $name, array $defaults);
    
    /**
     * Determines if the converter applies to a specific route and variable.
     *
     * @param mixed $definition
     *   The parameter definition provided in the route options.
     * @param string $name
     *   The name of the parameter.
     * @param \Symfony\Component\Routing\Route $route
     *   The route to consider attaching to.
     *
     * @return bool
     *   TRUE if the converter applies to the passed route and parameter, FALSE
     *   otherwise.
     */
    public function applies($definition, $name, Route $route);

}