instance()
instance(string $class_name, string $class_file, \array[string] $class_interfaces, array $constructor_args = array(), boolean $cache_class = TRUE, string $cache_instance_key = NULL) : object
Retorna una instancia de la clase indicada.
Parameters
| string | $class_name | nombre de la clase a instanciar |
| string | $class_file | archivo que define la clase $class_name; si es vacío se asume que la clase ya está disponible |
| \array[string] | $class_interfaces | nombres de interfaces que debe implementar la clase instanciada |
| array | $constructor_args | parámetros para pasar al constructor de la clase |
| boolean | $cache_class | ¿se debe guardar la clase en un cache para reusarla la siguiente vez que se solicite? |
| string | $cache_instance_key | clave usada para guardar la instancia creada en un cache; la siguiente vez que se solicite una instancia con esta clave, se retorna la instancia creada previamente |
Throws
- \XgapGenericFactoryException
si hay algún problema al instanciar; para determinar la causa se puede usar {@link XgapGenericFactoryException::getCode()} en la excepción disparada, junto con las constantes XgapGenericFactoryException::COD_*