¿Qué son los "decoradores" y cómo se usan?

Tengo curiosidad por saber qué son exactamente los decoradores en AngularJS. No hay mucha información en línea para los decoradores, excepto por una propaganda en la documentación de AngularJS y una breve (aunque interesante) mención en un video de YouTube .

Como dicen los chicos de Angular, un decorador es:

Decoración del servicio, permite al decorador interceptar la creación de la instancia del servicio. La instancia devuelta puede ser la instancia original o una nueva instancia que delegue a la instancia original.

Realmente no sé qué significa eso , y no estoy seguro de por qué separarías esta lógica del servicio en sí. Por ejemplo, si quisiera devolver algo diferente en diferentes condiciones, simplemente pasaría diferentes argumentos a las funciones relevantes o usaría otra función que comparta ese estado privado.

Todavía soy una especie de novato de AngularJS, así que estoy seguro de que es solo ignorancia y / o malos hábitos lo que aprendí.

Un caso de uso de buena $provide.decoratores cuando se necesita hacer menor "pellizco" en alguna de terceros / servicio de aguas arriba, de la que depende su módulo, dejando intacto el servicio (ya que no es el propietario / mantenedor del servicio). Aquí hay una demostración en plunkr.

Los decoradores nos permiten separar las preocupaciones transversales y permiten que los servicios preserven el principio de responsabilidad única sin preocuparse por el código de "infraestructura".

Usos prácticos de decoradores:

• Almacenamiento en caché: si tenemos un servicio que realiza llamadas HTTP potencialmente costosas, podemos envolver el servicio en un decorador de almacenamiento en caché que verifica el almacenamiento local antes de realizar la llamada externa.
• Depuración / seguimiento: tenga un interruptor según su configuración de desarrollo / producción que decore sus servicios con envolturas de depuración o seguimiento.
• Regulación: ajusta las llamadas que se desencadenan con frecuencia en un contenedor antirrebote. Nos permite interactuar fácilmente con servicios de tarifa limitada, por ejemplo.

En todos estos casos, limitamos el código del servicio a su responsabilidad principal.

decoratorpuede interceptar la instancia de servicio creada por factory, service, value, provider, y brinda las opciones para cambiar alguna instance(service)que de otro modo no sería configurable / con opciones.

También puede proporcionar instancias simuladas para fines de prueba, por ejemplo $http.

En palabras simples, podemos decir que es como un método de extensión. Por ej. Tenemos una clase y tiene dos métodos y en el tiempo de ejecución queremos agregar más métodos y luego usar Decorator.

No podemos usar $ provide.decorator con constantes porque no podemos cambiar las constantes que están cargando la propiedad de solo lectura.

En resumen, los decoradores se pueden describir de la siguiente manera:

Una función decoradora intercepta la creación de un servicio, lo que le permite anular o modificar el comportamiento del servicio.

Utiliza el $provideservicio por angular y modifica o reemplaza la implementación de otro servicio

$provide.decorator('service to decorate',['$delegate', function($delegate) {
  // $delegate - The original service instance, 
  //             which can be replaced, monkey patched, 
  //             configured, decorated or delegated to. 
  //             ie here what is there in the 'service to decorate'

  //   This function will be invoked, 
  //   when the service needs to be provided 
  //   and should return the decorated service instance.
  return $delegate;
}]);

Ejemplo:

$provide.decorator('$log', ['$delegate', function($delegate) {
  // This will change implementation of log.war to log.error
  $delegate.warn = $delegate.error; 
  return $delegate;
}]);

Aplicaciones

Además de la respuesta @JBland.

• Configuración de configuración regional amplia de la aplicación: -

  Puedes encontrar un ejemplo aquí

• Changiging comportamiento predeterminado e implementación existente de un servicio por servicio angular: -

  Puedes encontrar un ejemplo aquí

• Cambio de comportamiento de una función en diferentes entornos.