From dc7495e8bd821fcb4299d955ea5d8bf563e724ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Luis=20Mateo=20Hincapi=C3=A9=20Martinez?= <44934142+luismateoh@users.noreply.github.com> Date: Sat, 23 Mar 2024 04:53:54 -0500 Subject: [PATCH] translation: Translated all creational patterns category to Spanish (Task of issue #2277) (#2813) * Typo corrections * bridge pattern translated to spanish * builder pattern translated to spanish * context-object pattern translated to spanish * converter pattern translated to spanish * dependency injection pattern translated to spanish * factory pattern translated to spanish * factory-kit pattern translated to spanish * factory-method pattern translated to spanish * monostate pattern translated to spanish * multiton pattern translated to spanish * object mother pattern translated to spanish * object pool pattern translated to spanish * property pattern translated to spanish * prototype pattern translated to spanish * registry pattern translated to spanish * step builder pattern translated to spanish * value object pattern translated to spanish * typo corrections and resources urls refactor * grammar corrections * Add image to each pattern --------- Co-authored-by: luismateoh Co-authored-by: luis.hincapie --- localization/es/README.md | 4 +- localization/es/abstract-document/README.md | 34 +-- .../etc/abstract-document.png | Bin 0 -> 96228 bytes localization/es/abstract-factory/README.md | 29 +-- .../etc/abstract-factory.urm.png | Bin 0 -> 82368 bytes localization/es/active-object/README.md | 9 +- .../active-object/etc/active-object.urm.png | Bin 0 -> 19466 bytes localization/es/acyclic-visitor/README.md | 13 +- .../acyclic-visitor/etc/acyclic-visitor.png | Bin 0 -> 49064 bytes localization/es/adapter/README.md | 12 +- localization/es/adapter/etc/adapter.urm.png | Bin 0 -> 25425 bytes .../es/aggregator-microservices/README.md | 6 +- .../etc/aggregator-service.png | Bin 0 -> 41498 bytes localization/es/ambassador/README.md | 4 +- .../es/ambassador/etc/ambassador.urm.png | Bin 0 -> 49248 bytes localization/es/api-gateway/README.md | 14 +- .../es/api-gateway/etc/api-gateway.png | Bin 0 -> 18323 bytes localization/es/arrange-act-assert/README.md | 10 +- .../es/async-method-invocation/README.md | 4 +- .../etc/async-method-invocation.png | Bin 0 -> 36923 bytes localization/es/balking/README.md | 2 +- localization/es/balking/etc/balking.png | Bin 0 -> 21427 bytes localization/es/bridge/README.md | 223 ++++++++++++++++++ localization/es/bridge/etc/bridge.urm.png | Bin 0 -> 43639 bytes localization/es/builder/README.md | 158 +++++++++++++ localization/es/builder/etc/builder.urm.png | Bin 0 -> 94868 bytes localization/es/context-object/README.md | 187 +++++++++++++++ .../es/context-object/etc/context-object.png | Bin 0 -> 67111 bytes localization/es/converter/README.md | 105 +++++++++ localization/es/converter/etc/converter.png | Bin 0 -> 19389 bytes .../es/dependency-injection/README.md | 103 ++++++++ .../etc/dependency-injection.png | Bin 0 -> 22493 bytes localization/es/factory-kit/README.md | 132 +++++++++++ .../es/factory-kit/etc/factory-kit.png | Bin 0 -> 37570 bytes localization/es/factory-method/README.md | 114 +++++++++ .../factory-method/etc/factory-method.urm.png | Bin 0 -> 53024 bytes localization/es/factory/README.md | 143 +++++++++++ localization/es/factory/etc/factory.urm.png | Bin 0 -> 29351 bytes localization/es/layers/README.md | 4 +- localization/es/layers/etc/layers.png | Bin 0 -> 97428 bytes localization/es/lazy-loading/README.md | 6 +- .../es/lazy-loading/etc/lazy-loading.png | Bin 0 -> 11671 bytes localization/es/monostate/README.md | 33 +++ localization/es/monostate/etc/monostate.png | Bin 0 -> 16526 bytes localization/es/multiton/README.md | 140 +++++++++++ localization/es/multiton/etc/multiton.png | Bin 0 -> 10637 bytes localization/es/object-mother/README.md | 114 +++++++++ .../es/object-mother/etc/object-mother.png | Bin 0 -> 19705 bytes localization/es/object-pool/README.md | 147 ++++++++++++ .../es/object-pool/etc/object-pool.png | Bin 0 -> 8877 bytes localization/es/property/README.md | 144 +++++++++++ localization/es/property/etc/property.png | Bin 0 -> 20016 bytes localization/es/prototype/README.md | 180 ++++++++++++++ .../es/prototype/etc/prototype.urm.png | Bin 0 -> 81144 bytes localization/es/registry/README.md | 92 ++++++++ localization/es/registry/etc/registry.png | Bin 0 -> 16875 bytes localization/es/singleton/README.md | 2 +- .../es/singleton/etc/singleton.urm.png | Bin 0 -> 46739 bytes localization/es/step-builder/README.md | 123 ++++++++++ .../es/step-builder/etc/step-builder.png | Bin 0 -> 76038 bytes localization/es/value-object/README.md | 94 ++++++++ .../es/value-object/etc/value-object.png | Bin 0 -> 5025 bytes 62 files changed, 2307 insertions(+), 78 deletions(-) create mode 100644 localization/es/abstract-document/etc/abstract-document.png create mode 100644 localization/es/abstract-factory/etc/abstract-factory.urm.png create mode 100644 localization/es/active-object/etc/active-object.urm.png create mode 100644 localization/es/acyclic-visitor/etc/acyclic-visitor.png create mode 100644 localization/es/adapter/etc/adapter.urm.png create mode 100644 localization/es/aggregator-microservices/aggregator-service/etc/aggregator-service.png create mode 100644 localization/es/ambassador/etc/ambassador.urm.png create mode 100644 localization/es/api-gateway/etc/api-gateway.png create mode 100644 localization/es/async-method-invocation/etc/async-method-invocation.png create mode 100644 localization/es/balking/etc/balking.png create mode 100644 localization/es/bridge/README.md create mode 100644 localization/es/bridge/etc/bridge.urm.png create mode 100644 localization/es/builder/README.md create mode 100644 localization/es/builder/etc/builder.urm.png create mode 100644 localization/es/context-object/README.md create mode 100644 localization/es/context-object/etc/context-object.png create mode 100644 localization/es/converter/README.md create mode 100644 localization/es/converter/etc/converter.png create mode 100644 localization/es/dependency-injection/README.md create mode 100644 localization/es/dependency-injection/etc/dependency-injection.png create mode 100644 localization/es/factory-kit/README.md create mode 100644 localization/es/factory-kit/etc/factory-kit.png create mode 100644 localization/es/factory-method/README.md create mode 100644 localization/es/factory-method/etc/factory-method.urm.png create mode 100644 localization/es/factory/README.md create mode 100644 localization/es/factory/etc/factory.urm.png create mode 100644 localization/es/layers/etc/layers.png create mode 100644 localization/es/lazy-loading/etc/lazy-loading.png create mode 100644 localization/es/monostate/README.md create mode 100644 localization/es/monostate/etc/monostate.png create mode 100644 localization/es/multiton/README.md create mode 100644 localization/es/multiton/etc/multiton.png create mode 100644 localization/es/object-mother/README.md create mode 100644 localization/es/object-mother/etc/object-mother.png create mode 100644 localization/es/object-pool/README.md create mode 100644 localization/es/object-pool/etc/object-pool.png create mode 100644 localization/es/property/README.md create mode 100644 localization/es/property/etc/property.png create mode 100644 localization/es/prototype/README.md create mode 100644 localization/es/prototype/etc/prototype.urm.png create mode 100644 localization/es/registry/README.md create mode 100644 localization/es/registry/etc/registry.png create mode 100644 localization/es/singleton/etc/singleton.urm.png create mode 100644 localization/es/step-builder/README.md create mode 100644 localization/es/step-builder/etc/step-builder.png create mode 100644 localization/es/value-object/README.md create mode 100644 localization/es/value-object/etc/value-object.png diff --git a/localization/es/README.md b/localization/es/README.md index 0d9419c77..5540c3f06 100644 --- a/localization/es/README.md +++ b/localization/es/README.md @@ -29,7 +29,7 @@ programadores y arquitectos experimentados de la comunidad de código abierto. L Antes de sumergirte en el material deberías estar familiarizado con varios [Principios de diseño de software](https://java-design-patterns.com/principles/). -Todos los diseños deben ser lo más simples posible. Deberías comenzar con los principios KISS, YAGNI y hacer lo mas simple que funcione. La complejidad y los patrones solo deben introducirse cuando sean necesarios para una extensibilidad práctica. +Todos los diseños deben ser lo más simples posible. Deberías comenzar con los principios KISS, YAGNI y hacer lo más simple que funcione. La complejidad y los patrones solo deben introducirse cuando sean necesarios para una extensibilidad práctica. Una vez que esté familiarizado con estos conceptos, puedes comenzar a profundizar con los [patrones de diseño disponibles](https://java-design-patterns.com/patterns/) por cualquiera de los siguientes enfoques @@ -46,5 +46,5 @@ Si estás dispuesto a contribuir al proyecto encontrarás la información releva # Licencia -Este proyecto esta licenciado de acuerdo con los términos de la licencia del MIT. +Este proyecto está licenciado de acuerdo con los términos de la licencia del MIT. diff --git a/localization/es/abstract-document/README.md b/localization/es/abstract-document/README.md index 7f3a4d581..56f343218 100644 --- a/localization/es/abstract-document/README.md +++ b/localization/es/abstract-document/README.md @@ -1,25 +1,24 @@ --- -layout: pattern title: Abstract Document -folder: abstract-document -permalink: /patterns/abstract-document/ -categories: Structural +category: Structural language: es -tag: - - Extensibility +tag: + - Extensibility --- ## Propósito -Usar propiedades dinámicas y conseguir la felexibilidad de los lenguajes no tipados manteniendo la seguridad de tipos. +Usar propiedades dinámicas y conseguir la flexibilidad de los lenguajes no tipados manteniendo la seguridad de tipos. ## Explicación -El uso del patrón Abstract Document permite gestionar propiedades no estáticas adicionales. Este patrón usa el concepto de atributos para permitir seguridad de tipos y propiedades separadas de diferentes clases en un grupo de interfaces. +El uso del patrón Abstract Document permite gestionar propiedades no estáticas adicionales. Este patrón usa el concepto +de atributos para permitir seguridad de tipos y propiedades separadas de diferentes clases en un grupo de interfaces. Ejemplo del mundo real -> Toma como ejemplo un coche que está formado por muchas partes. Sin embargo, no sabemos si el coche tiene todas las partes o solo una parte de ellas. Nuestros coches son dinámicos y extremadamente flexibles. +> Toma como ejemplo un coche que está formado por muchas partes. Sin embargo, no sabemos si el coche tiene todas las +> partes o solo una parte de ellas. Nuestros coches son dinámicos y extremadamente flexibles. Dicho de otra forma @@ -27,11 +26,16 @@ Dicho de otra forma Según Wikipedia -> Un patrón de diseño estructural orientado a objetos para organizar objetos en contenedores clave-valor vagamente tipados y exponiendo los datos usando vistas tipadas. El propósito del patrón es conseguir un alto grado de flexibilidad entre componentes en un lenguaje de tipado fuerte donde nuevas propiedades pueden añadirse al arbol de objetos sobre la marcha sin perder el soporte de la seguridad de tipos. El patrón hace uso de atributos para separar diferentes propiedades de una clase en distintas interfaces. +> Un patrón de diseño estructural orientado a objetos para organizar objetos en contenedores clave-valor vagamente +> tipados y exponiendo los datos usando vistas tipadas. El propósito del patrón es conseguir un alto grado de flexibilidad +> entre componentes en un lenguaje de tipado fuerte donde nuevas propiedades pueden añadirse al árbol de objetos sobre la +> marcha sin perder el soporte de la seguridad de tipos. El patrón hace uso de atributos para separar diferentes +> propiedades de una clase en distintas interfaces. **Ejemplo Programático** -Primero definamos las clases base `Document` y `AbstractDocument`. Básicamente hacen que el objeto contenga un mapa de propiedades y cualquier número de objetos hijo. +Primero definamos las clases base `Document` y `AbstractDocument`. Básicamente, hacen que el objeto contenga un mapa de +propiedades y cualquier número de objetos hijo. ```java public interface Document { @@ -76,7 +80,9 @@ public abstract class AbstractDocument implements Document { ... } ``` -A continuación definimos un enum `Property` y un grupo de interfaces para tipo, precio, modelo y partes. Esto nos permite crear interfaces de apariencia estática para nuestra clase `Car`. + +A continuación definimos un enum `Property` y un grupo de interfaces para tipo, precio, modelo y partes. Esto nos +permite crear interfaces de apariencia estática para nuestra clase `Car`. ```java public enum Property { @@ -166,14 +172,14 @@ Y finalmente asi es como construimos y usamos el Coche `Car` en un ejemplo compl ## Diagrama de clases -![alt text](../../../abstract-document/etc/abstract-document.png "Abstract Document Traits and Domain") +![alt text](./etc/abstract-document.png "Abstract Document Traits and Domain") ## Aplicación Usar el patrón Abstract Document cuando * Existe la necesidad de añadir propiedades sobre la marcha. -* Quieres una manera flexible de organizar el dominio en una estructura similar a un arbol. +* Quieres una manera flexible de organizar el dominio en una estructura similar a un árbol. * Quieres un sistema menos acoplado. ## Créditos diff --git a/localization/es/abstract-document/etc/abstract-document.png b/localization/es/abstract-document/etc/abstract-document.png new file mode 100644 index 0000000000000000000000000000000000000000..6bc0b29a4e77680d8eda277c93b97277bbe7193b GIT binary patch literal 96228 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∈MtPMEwTr6eK$ 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 Para crear un reino necesitamos objetos con una temática común. El reino élfico necesita un rey elfo, un castillo élfico y un ejército élfico mientras que el reino orco necesita un rey orco, un castillo orco y un ejércico orco. Hay una dependencia entre los objetos del reino. +> Para crear un reino necesitamos objetos con una temática común. El reino élfico necesita un rey elfo, un castillo élfico y un ejército élfico mientras que el reino orco necesita un rey orco, un castillo orco y un ejército orco. Hay una dependencia entre los objetos del reino. Dicho de otra forma -> Una factoría de factorías; una factoría que agrupa otras factorias individuales pero relacionadas/dependientes sin especificar su clase concreta. +> Una factoría de factorías; una factoría que agrupa otras factorías individuales pero relacionadas/dependientes sin especificar su clase concreta. Según Wikipedia @@ -33,7 +30,7 @@ Según Wikipedia **Ejemplo Programático** -Traduciendo el ejemplo anterior sobre los reinos. Primero tenemos algunas interfaces e implementaciones de los objetos del reino. +Traduciendo el ejemplo anterior sobre los reinos. Primero tenemos algunas interfaces e implementaciones de los objetos del `Castle`. ```java public interface Castle { @@ -75,7 +72,7 @@ public class ElfArmy implements Army { ``` -Luego tenemos la abstracción e implementación de la factoría del reino. +Luego tenemos la abstracción e implementación de la factoría del reino `KingdomFactory`. ```java public interface KingdomFactory { @@ -121,7 +118,7 @@ public class OrcKingdomFactory implements KingdomFactory { } ``` -Ahora tenemos la factoría abstracta que nos permite hacer familias de objetos relacionados por ejemplo la factoria del reino élfico crea el castillo, rey y ejercito élficos etc. +Ahora tenemos la factoría abstracta que nos permite hacer familias de objetos relacionados por ejemplo la factoría del reino élfico `ElfKingdomFactory` crea el castillo `castle`, rey `king` y ejército `army` etc. ```java @@ -135,7 +132,7 @@ king.getDescription(); army.getDescription(); ``` -Output del programa: +Salida del programa: ```java This is the elven castle! @@ -180,7 +177,7 @@ public static class FactoryMaker { ## Diagrama de clases -![alt text](../../../abstract-factory/etc/abstract-factory.urm.png "Diagrama de Clases de Abstract Factory") +![alt text](./etc/abstract-factory.urm.png "Diagrama de Clases de Abstract Factory") ## Aplicación @@ -191,24 +188,24 @@ Usar el patrón Abstract Factory cuando * El sistema debe ser configurado con una de las múltiples familias de productos. * La familia de objetos relacionados está diseñada para ser usada en conjunto y necesitas forzar esta premisa. * Quieres proveer de una librería de productos y solo quieres revelar sus interfaces, no su implementación. -* El tiempo de vida de la dependencia es conceptualmente mas corte que el del cliente. +* El tiempo de vida de la dependencia es conceptualmente más corto que el del cliente. * Necesitas un valor en tiempo de ejecución para construir una dependencia. * Quieres decidir que producto de una familia llamar en tiempo de ejecución. -* Necesitas proveer de uno o mas parámetros solo conocidos en tiempo de ejecución antes de poder resolver la dependencia. +* Necesitas proveer de uno o más parámetros solo conocidos en tiempo de ejecución antes de poder resolver la dependencia. * Necesitas consistencia entre productos. * No quieres cambiar el código existente al añadir nuevos productos o familias de productos al programa. Ejemplos de casos de uso * Elegir llamar a la implementación correcta de FileSystemAcmeService o DatabaseAcmeService o NetworkAcmeService en tiempo de ejecución. -* Escribir test unitarios se hace mucho mas sencillo. +* Escribir test unitarios se hace mucho más sencillo. * Herramientas UI (User Interface) para diferentes SO (Sistemas Operativos). ## Consecuencias -* La inyección de dependencias en java esconde las dependencias de la clase servicio lo que puede llevar a errores de ejecución que se podrian haber evitado al compilar. +* La inyección de dependencias en java esconde las dependencias de la clase servicio lo que puede llevar a errores de ejecución que se podrían haber evitado al compilar. * Mientras que el patrón es muy bueno creando objetos predefinidos, añadir nuevos puede ser complicado. -* El código es mas complicado de lo que deberia porque se añaden muchas interfaces y clases nuevas junto con el patrón. +* El código es más complicado de lo que debería porque se añaden muchas interfaces y clases nuevas junto con el patrón. ## Tutoriales diff --git a/localization/es/abstract-factory/etc/abstract-factory.urm.png b/localization/es/abstract-factory/etc/abstract-factory.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..836858a2c652f55723cff879d1058248e1d2799c GIT binary patch literal 82368 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 MUHx3vIVCg!0PQSJ00000 literal 0 HcmV?d00001 diff --git a/localization/es/active-object/README.md b/localization/es/active-object/README.md index 77da65815..1d2948c58 100644 --- a/localization/es/active-object/README.md +++ b/localization/es/active-object/README.md @@ -1,9 +1,6 @@ --- -layout: pattern title: Active Object -folder: active-object -permalink: /patterns/active-object/ -categories: Concurrency +category: Concurrency language: es tag: - Performance @@ -19,7 +16,7 @@ La clase que implementa el patrón de diseño de objeto activo contendrá un mec Ejemplo del mundo real -> Los orcos son conocidos por su salvajismo y filosofía de no hacer equipo. Basandonos en este comportamiento se podría decir que tienen su propio hilo de control. +> Los orcos son conocidos por su salvajismo y filosofía de no hacer equipo. Basándonos en este comportamiento se podría decir que tienen su propio hilo de control. Podemos usar el patrón Active Object para implementar una criatura que tiene su propio hilo de control y exponer su API pero no la ejecución como tal. @@ -123,7 +120,7 @@ Ahora podemos crear múltiples criaturas como los Orcos, diles que coman y deamb ## Diagrama de clases -![alt text](../../../active-object/etc/active-object.urm.png "Active Object class diagram") +![alt text](./etc/active-object.urm.png "Active Object class diagram") ## Tutoriales diff --git a/localization/es/active-object/etc/active-object.urm.png b/localization/es/active-object/etc/active-object.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..c14f66144ee297261111c1c05529c5d00ebe393e GIT binary patch literal 19466 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 literal 0 HcmV?d00001 diff --git a/localization/es/ambassador/README.md b/localization/es/ambassador/README.md index fcc63208e..83601c0f2 100644 --- a/localization/es/ambassador/README.md +++ b/localization/es/ambassador/README.md @@ -7,7 +7,7 @@ tag: - Cloud distributed --- -## Motivo +## Propósito Proporcionar una instancia de servicio auxiliar a un cliente y delegar en ella las funcionalidades comunes de un recurso compartido. @@ -170,7 +170,7 @@ Service result: -1 ## Diagrama de clase -![alt text](/ambassador/etc/ambassador.urm.png "Ambassador class diagram") +![alt text](./etc/ambassador.urm.png "Ambassador class diagram") ## Aplicaciones diff --git a/localization/es/ambassador/etc/ambassador.urm.png b/localization/es/ambassador/etc/ambassador.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..9b50a02ad356106d5bde0979fcef0bbcafabb1f0 GIT binary patch literal 49248 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 La invocación del método asíncrono inicia el procedimiento y vuelve inmediatamente antes de que la tarea termine -> Los resultados del procedimiento se devuelven a la llamada posteriormente (callback). +> Los resultados del procedimiento se devuelven a la llamada posteriormente (callback). Según Wikipedia diff --git a/localization/es/async-method-invocation/etc/async-method-invocation.png b/localization/es/async-method-invocation/etc/async-method-invocation.png new file mode 100644 index 0000000000000000000000000000000000000000..764895d7a217b838e4c884ced9df9d0d4888d28f GIT binary patch literal 36923 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 Imagina que tienes un arma con diferentes encantamientos, y se supone que debes permitir la mezcla de diferentes armas +> con diferentes encantamientos. ¿Qué harías? ¿Crearías múltiples copias de cada una de las armas para cada uno de los +> encantamientos o simplemente crearías un encantamiento separado y lo establecerías para el arma según sea necesario? +> El +> patrón Bridge te permite hacer lo segundo. + +En palabras sencillas + +> El patrón Bridge se trata de preferir la composición sobre la herencia. Los detalles de implementación se empujan de +> una jerarquía a otro objeto con una jerarquía separada. + +Wikipedia dice + +> El patrón bridge es un patrón de diseño utilizado en ingeniería de software que tiene como objetivo "desacoplar una +> abstracción de su implementación para que las dos puedan variar independientemente" + +**Ejemplo programático** + +Transladando nuestro ejemplo de arma de arriba. Aquí tenemos la interfaz arma `Weapon`: + +```java +public interface Weapon { + void wield(); + void swing(); + void unwield(); + Enchantment getEnchantment(); +} + +public class Sword implements Weapon { + + private final Enchantment enchantment; + + public Sword(Enchantment enchantment) { + this.enchantment = enchantment; + } + + @Override + public void wield() { + LOGGER.info("The sword is wielded."); + enchantment.onActivate(); + } + + @Override + public void swing() { + LOGGER.info("The sword is swinged."); + enchantment.apply(); + } + + @Override + public void unwield() { + LOGGER.info("The sword is unwielded."); + enchantment.onDeactivate(); + } + + @Override + public Enchantment getEnchantment() { + return enchantment; + } +} + +public class Hammer implements Weapon { + + private final Enchantment enchantment; + + public Hammer(Enchantment enchantment) { + this.enchantment = enchantment; + } + + @Override + public void wield() { + LOGGER.info("The hammer is wielded."); + enchantment.onActivate(); + } + + @Override + public void swing() { + LOGGER.info("The hammer is swinged."); + enchantment.apply(); + } + + @Override + public void unwield() { + LOGGER.info("The hammer is unwielded."); + enchantment.onDeactivate(); + } + + @Override + public Enchantment getEnchantment() { + return enchantment; + } +} +``` + +Aquí está la interfaz de encantamientos `Enchantment` separada: + +```java +public interface Enchantment { + void onActivate(); + void apply(); + void onDeactivate(); +} + +public class FlyingEnchantment implements Enchantment { + + @Override + public void onActivate() { + LOGGER.info("The item begins to glow faintly."); + } + + @Override + public void apply() { + LOGGER.info("The item flies and strikes the enemies finally returning to owner's hand."); + } + + @Override + public void onDeactivate() { + LOGGER.info("The item's glow fades."); + } +} + +public class SoulEatingEnchantment implements Enchantment { + + @Override + public void onActivate() { + LOGGER.info("The item spreads bloodlust."); + } + + @Override + public void apply() { + LOGGER.info("The item eats the soul of enemies."); + } + + @Override + public void onDeactivate() { + LOGGER.info("Bloodlust slowly disappears."); + } +} +``` + +Aquí están ambas interfaces en acción: + +```java +LOGGER.info("The knight receives an enchanted sword."); +var enchantedSword = new Sword(new SoulEatingEnchantment()); +enchantedSword.wield(); +enchantedSword.swing(); +enchantedSword.unwield(); + +LOGGER.info("The valkyrie receives an enchanted hammer."); +var hammer = new Hammer(new FlyingEnchantment()); +hammer.wield(); +hammer.swing(); +hammer.unwield(); +``` + +Aquí está la salida en consola. + +``` +The knight receives an enchanted sword. +The sword is wielded. +The item spreads bloodlust. +The sword is swung. +The item eats the soul of enemies. +The sword is unwielded. +Bloodlust slowly disappears. +The valkyrie receives an enchanted hammer. +The hammer is wielded. +The item begins to glow faintly. +The hammer is swung. +The item flies and strikes the enemies finally returning to owner's hand. +The hammer is unwielded. +The item's glow fades. +``` + +## Diagrama de Clases + +![alt text](./etc/bridge.urm.png "Bridge diagrama de clases") + +## Aplicabilidad + +Usa el patrón Bridge cuando + +* Quieres evitar una vinculación permanente entre una abstracción y su implementación. Este podría ser el caso, por + ejemplo, cuando la implementación debe ser seleccionada o cambiada en tiempo de ejecución. +* Tanto las abstracciones como sus implementaciones deberían ser extensibles mediante la herencia. En este caso, el + patrón Bridge te permite combinar las diferentes abstracciones e implementaciones y extenderlas de forma + independiente. +* Los cambios en la implementación de una abstracción no deberían tener impacto en los clientes; es decir, su código no + debería tener que ser recompilado. +* Tienes una proliferación de clases. Tal jerarquía de clases indica la necesidad de dividir un objeto en dos partes. + Rumbaugh usa el término "generalizaciones anidadas" para referirse a tales jerarquías de clases. +* Quieres compartir una implementación entre varios objetos (quizás usando conteo de referencias), y este hecho debería + ser ocultado al cliente. Un ejemplo simple es la clase String de Coplien, en la que varios objetos pueden compartir la + misma representación de cadena. + +## Tutoriales + +* [Bridge Pattern Tutorial](https://www.journaldev.com/1491/bridge-design-pattern-java) + +## Créditos + +* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59) +* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b) \ No newline at end of file diff --git a/localization/es/bridge/etc/bridge.urm.png b/localization/es/bridge/etc/bridge.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..785585bf8163e4802bf9b84f03e3c1bb172dd695 GIT binary patch literal 43639 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 Ae*gdg literal 0 HcmV?d00001 diff --git a/localization/es/builder/README.md b/localization/es/builder/README.md new file mode 100644 index 000000000..e931c4ca2 --- /dev/null +++ b/localization/es/builder/README.md @@ -0,0 +1,158 @@ +--- +title: Builder +category: Creational +language: es +tag: + - Gang of Four +--- + +## Propósito + +Separar la construcción de un objeto complejo de su representación para que el mismo proceso de +construcción pueda crear diferentes representaciones. + +## Explicación + +Ejemplo real + +> Imagina un generador de personajes para un juego de rol. La opción más fácil es dejar que el ordenador +> cree el personaje por ti. Si quieres seleccionar manualmente los detalles del personaje como +> profesión, sexo, color de pelo, etc. la generación del personaje se convierte en un proceso paso a paso que +> se completa cuando todas las selecciones están listas. + +En pocas palabras + +> Permite crear diferentes sabores de un objeto evitando la contaminación del constructor. Útil +> cuando puede haber varios sabores de un objeto. O cuando hay muchos pasos involucrados en la creación de un objeto. +> creación de un objeto. + +Wikipedia dice + +> El patrón constructor es un patrón de diseño de software de creación de objetos con la intención de encontrar +> una solución al anti-patrón del constructor telescópico. + + +Dicho esto, permíteme agregar un poco sobre qué es el anti-patrón del constructor telescópico. En algún momento +u otro, todos hemos visto un constructor como el siguiente: + +```java +public Hero(Profession profession, String name, HairType hairType, HairColor hairColor, Armor armor, Weapon weapon) { +} +``` + +Como puedes ver, el número de parámetros del constructor puede salirse rápidamente de control, y puede volverse difícil +entender la disposición de los parámetros. Además, esta lista de parámetros podría seguir creciendo si quisieras agregar +más opciones en el futuro. A esto se le llama anti-patrón del constructor telescópico. + +**Ejemplo programático** + +La alternativa sensata es utilizar el patrón Builder. En primer lugar, tenemos a nuestro héroe `Hero` que queremos +crear: + +```java +public final class Hero { + private final Profession profession; + private final String name; + private final HairType hairType; + private final HairColor hairColor; + private final Armor armor; + private final Weapon weapon; + + private Hero(Builder builder) { + this.profession = builder.profession; + this.name = builder.name; + this.hairColor = builder.hairColor; + this.hairType = builder.hairType; + this.weapon = builder.weapon; + this.armor = builder.armor; + } +} +``` + +Luego tenemos al constructor: + +```java + public static class Builder { + private final Profession profession; + private final String name; + private HairType hairType; + private HairColor hairColor; + private Armor armor; + private Weapon weapon; + + public Builder(Profession profession, String name) { + if (profession == null || name == null) { + throw new IllegalArgumentException("profession and name can not be null"); + } + this.profession = profession; + this.name = name; + } + + public Builder withHairType(HairType hairType) { + this.hairType = hairType; + return this; + } + + public Builder withHairColor(HairColor hairColor) { + this.hairColor = hairColor; + return this; + } + + public Builder withArmor(Armor armor) { + this.armor = armor; + return this; + } + + public Builder withWeapon(Weapon weapon) { + this.weapon = weapon; + return this; + } + + public Hero build() { + return new Hero(this); + } + } +``` + +Entonces se puede utilizar como: + +```java +var mage = new Hero.Builder(Profession.MAGE, "Riobard").withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER).build(); +``` + +## Diagrama de clases + +![alt text](./etc/builder.urm.png "Builder diagrama de clases") + +## Aplicabilidad + +Utiliza el patrón Builder cuando + +* El algoritmo para crear un objeto complejo debe ser independiente de las partes que componen el objeto y cómo se + ensamblan. +* El proceso de construcción debe permitir diferentes representaciones para el objeto que se construye. + +## Tutoriales + +* [Refactoring Guru](https://refactoring.guru/design-patterns/builder) +* [Oracle Blog](https://blogs.oracle.com/javamagazine/post/exploring-joshua-blochs-builder-design-pattern-in-java) +* [Journal Dev](https://www.journaldev.com/1425/builder-design-pattern-in-java) + +## Usos en el mundo real + +* [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html) +* [java.nio.ByteBuffer](http://docs.oracle.com/javase/8/docs/api/java/nio/ByteBuffer.html#put-byte-) así como otros + buffers + como FloatBuffer, IntBuffer, etc. +* [java.lang.StringBuffer](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuffer.html#append-boolean-) +* Todas las implementaciones + de [java.lang.Appendable](http://docs.oracle.com/javase/8/docs/api/java/lang/Appendable.html) +* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) +* [Apache Commons Option.Builder](https://commons.apache.org/proper/commons-cli/apidocs/org/apache/commons/cli/Option.Builder.html) + +## Créditos + +* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59) +* [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb) +* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b) +* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7) diff --git a/localization/es/builder/etc/builder.urm.png b/localization/es/builder/etc/builder.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..d77808d36097165cace8b972de6a97d260f70cc5 GIT binary patch literal 94868 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

D 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 E9~Pz?ng9R* literal 0 HcmV?d00001 diff --git a/localization/es/context-object/README.md b/localization/es/context-object/README.md new file mode 100644 index 000000000..d723cbd85 --- /dev/null +++ b/localization/es/context-object/README.md @@ -0,0 +1,187 @@ +--- +title: Context object +category: Creational +language: es +tags: + - Data access +--- + +## Nombre / Clasificación + +Context Object + +## También conocido como + +Context, Encapsulate Context + +## Propósito + +Desacoplar los datos de las clases específicas del protocolo y almacenar los datos del ámbito en un objeto independiente +de la tecnología del protocolo subyacente. + +## Explicación + +Ejemplo del mundo real + +> Esta aplicación tiene diferentes capas etiquetadas como A, B y C, cada una extrayendo información específica de un +> contexto similar para su uso posterior en el software. Pasar cada pieza de información individualmente sería +> ineficiente, se necesita un método para almacenar y pasar información de manera eficiente. +> En palabras sencillas + +> Crea un objeto y almacena los datos allí y pasa este objeto a donde se necesita. + +[Core J2EE Patterns](http://corej2eepatterns.com/ContextObject.htm) dice + +> Utilice un objeto de contexto (Context Object) para encapsular el estado de una manera independiente del protocolo para ser compartido +> en toda tu aplicación. + +**Ejemplo programático** + +Definimos qué datos contiene un objeto de contexto (Context Object) de servicio `ServiceContext`. + +```Java +public class ServiceContext { + + String ACCOUNT_SERVICE, SESSION_SERVICE, SEARCH_SERVICE; + + public void setACCOUNT_SERVICE(String ACCOUNT_SERVICE) { + this.ACCOUNT_SERVICE = ACCOUNT_SERVICE; + } + + public void setSESSION_SERVICE(String SESSION_SERVICE) { + this.SESSION_SERVICE = SESSION_SERVICE; + } + + public void setSEARCH_SERVICE(String SEARCH_SERVICE) { + this.SEARCH_SERVICE = SEARCH_SERVICE; + } + + public String getACCOUNT_SERVICE() { + return ACCOUNT_SERVICE; + } + + public String getSESSION_SERVICE() { + return SESSION_SERVICE; + } + + public String getSEARCH_SERVICE() { + return SEARCH_SERVICE; + } + + public String toString() { return ACCOUNT_SERVICE + " " + SESSION_SERVICE + " " + SEARCH_SERVICE;} +} +``` + +Se crea una interfaz `ServiceContextFactory` utilizada en partes de la aplicación para crear objetos de contexto. + +```Java +public class ServiceContextFactory { + + public static ServiceContext createContext() { + return new ServiceContext(); + } +} +``` + +Instanciar el objeto de contexto en la primera capa `LayerA` y la capa contigua `LayerB` hasta llamar al contexto en la capa actual `LayerC`, +que estructura el objeto. + +```Java +public class LayerA { + + private static ServiceContext context; + + public LayerA() { + context = ServiceContextFactory.createContext(); + } + + public static ServiceContext getContext() { + return context; + } + + public void addAccountInfo(String accountService) { + context.setACCOUNT_SERVICE(accountService); + } +} + +public class LayerB { + + private static ServiceContext context; + + public LayerB(LayerA layerA) { + this.context = layerA.getContext(); + } + + public static ServiceContext getContext() { + return context; + } + + public void addSessionInfo(String sessionService) { + context.setSESSION_SERVICE(sessionService); + } +} + +public class LayerC { + + public static ServiceContext context; + + public LayerC(LayerB layerB) { + this.context = layerB.getContext(); + } + + public static ServiceContext getContext() { + return context; + } + + public void addSearchInfo(String searchService) { + context.setSEARCH_SERVICE(searchService); + } +} +``` + +He aquí el objeto de contexto y las capas en acción. + +```Java +var layerA = new LayerA(); +layerA.addAccountInfo(SERVICE); +LOGGER.info("Context = {}",layerA.getContext()); +var layerB = new LayerB(layerA); +layerB.addSessionInfo(SERVICE); +LOGGER.info("Context = {}",layerB.getContext()); +var layerC = new LayerC(layerB); +layerC.addSearchInfo(SERVICE); +LOGGER.info("Context = {}",layerC.getContext()); +``` + +Salida del programa: + +```Java +Context = SERVICE null null +Context = SERVICE SERVICE null +Context = SERVICE SERVICE SERVICE +``` + +## Diagrama de clases + +![alt text](./etc/context-object.png "Context object") + +## Aplicabilidad + +Utilizar el patrón Objeto Contexto (Context Object) para: + +* Compartir información entre diferentes capas del sistema. +* Desacoplar datos de software de contextos específicos de protocolo. +* Exponer solo las API relevantes dentro del contexto. + +## Usos conocidos + +* [Spring: ApplicationContext](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/context/ApplicationContext.html) +* [Oracle: SecurityContext](https://docs.oracle.com/javaee/7/api/javax/ws/rs/core/SecurityContext.html) +* [Oracle: ServletContext](https://docs.oracle.com/javaee/6/api/javax/servlet/ServletContext.html) + +## Créditos + +* [Core J2EE Design Patterns](https://amzn.to/3IhcY9w) +* [Core J2EE Design Patterns website - Context Object](http://corej2eepatterns.com/ContextObject.htm) +* [Allan Kelly - The Encapsulate Context Pattern](https://accu.org/journals/overload/12/63/kelly_246/) +* [Arvid S. Krishna et al. - Context Object](https://www.dre.vanderbilt.edu/~schmidt/PDF/Context-Object-Pattern.pdf) diff --git a/localization/es/context-object/etc/context-object.png b/localization/es/context-object/etc/context-object.png new file mode 100644 index 0000000000000000000000000000000000000000..a1f670812f7ba27e600532ba541b19222df81271 GIT binary patch literal 67111 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 PBjFPfCKb1e64cKC En las aplicaciones del mundo real, a menudo se da el caso de que la capa de base de datos consta de entidades que +> necesitan ser mapeadas en DTO para su uso en la capa de lógica de negocio. Un mapeo similar se realiza para +> potencialmente enorme cantidad de clases y necesitamos una forma genérica de lograrlo. + +En palabras sencillas + +> El patrón de conversión (Converter) facilita la asignación de instancias de una clase a instancias de otra clase. + +**Ejemplo programático** + +Necesitamos una solución genérica para el problema del mapeo. Para ello, introduzcamos un convertidor genérico. + +```java +public class Converter { + + private final Function fromDto; + private final Function fromEntity; + + public Converter(final Function fromDto, final Function fromEntity) { + this.fromDto = fromDto; + this.fromEntity = fromEntity; + } + + public final U convertFromDto(final T dto) { + return fromDto.apply(dto); + } + + public final T convertFromEntity(final U entity) { + return fromEntity.apply(entity); + } + + public final List createFromDtos(final Collection dtos) { + return dtos.stream().map(this::convertFromDto).collect(Collectors.toList()); + } + + public final List createFromEntities(final Collection entities) { + return entities.stream().map(this::convertFromEntity).collect(Collectors.toList()); + } +} +``` + +Los convertidores especializados heredan de esta clase base de la siguiente manera. + +```java +public class UserConverter extends Converter { + + public UserConverter() { + super(UserConverter::convertToEntity, UserConverter::convertToDto); + } + + private static UserDto convertToDto(User user) { + return new UserDto(user.getFirstName(), user.getLastName(), user.isActive(), user.getUserId()); + } + + private static User convertToEntity(UserDto dto) { + return new User(dto.getFirstName(), dto.getLastName(), dto.isActive(), dto.getEmail()); + } + +} +``` + +Ahora el mapeo entre `User` y `UserDto` se vuelve trivial. + +```java +var userConverter = new UserConverter(); +var dtoUser = new UserDto("John", "Doe", true, "whatever[at]wherever.com"); +var user = userConverter.convertFromDto(dtoUser); +``` + +## Diagrama de Clases + +![alt text](./etc/converter.png "Converter Pattern") + +## Aplicabilidad + +Utilice el patrón de conversión en las siguientes situaciones: + +* Cuando tiene tipos que lógicamente se corresponden entre sí y necesita convertir entidades + entre ellos. +* Cuando quieras proporcionar diferentes formas de conversión de tipos dependiendo del contexto. +* Siempre que introduzca un DTO (Data transfer object), probablemente necesitará convertirlo en la + equivalencia de dominio. + +## Créditos + +* [Converter Pattern in Java 8](http://www.xsolve.pl/blog/converter-pattern-in-java-8/) diff --git a/localization/es/converter/etc/converter.png b/localization/es/converter/etc/converter.png new file mode 100644 index 0000000000000000000000000000000000000000..01435ef5ae29dbda20c7078291a8c1c912003000 GIT binary patch literal 19389 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 Ir04hl0JmNfk^lez literal 0 HcmV?d00001 diff --git a/localization/es/dependency-injection/README.md b/localization/es/dependency-injection/README.md new file mode 100644 index 000000000..3bb4a9002 --- /dev/null +++ b/localization/es/dependency-injection/README.md @@ -0,0 +1,103 @@ +--- +title: Dependency Injection +category: Creational +language: es +tag: + - Decoupling +--- + +## Propósito + +La inyección de dependencias es un patrón de diseño de software en el que una o más dependencias (o servicios) +se inyectan, o se pasan por referencia, a un objeto dependiente (o cliente) y pasan a formar parte del estado del +cliente. El patrón separa la creación de las dependencias de un cliente de su propio comportamiento, +lo que permite que los diseños de los programas estén poco acoplados y sigan los principios de inversión de control y +responsabilidad única. + +## Explicación + +Ejemplo del mundo real + +> Al viejo mago le gusta llenar su pipa y fumar tabaco de vez en cuando. Sin embargo, no quiere depender de una sola +> marca de tabaco, sino que le gusta poder disfrutar de todas ellas de manera intercambiable. + +En palabras sencillas + +> La Inyección de Dependencias separa la creación de las dependencias del cliente de su propio comportamiento. + +Wikipedia dice + +> En ingeniería de software, la inyección de dependencias es una técnica en la que un objeto recibe otros objetos de los +> que depende. Estos otros objetos se llaman dependencias. + +**Ejemplo programático** + +Presentemos primero la interfaz tabaco `Tobacco` y las marcas concretas. + +```java +@Slf4j +public abstract class Tobacco { + + public void smoke(Wizard wizard) { + LOGGER.info("{} smoking {}", wizard.getClass().getSimpleName(), + this.getClass().getSimpleName()); + } +} + +public class SecondBreakfastTobacco extends Tobacco { +} + +public class RivendellTobacco extends Tobacco { +} + +public class OldTobyTobacco extends Tobacco { +} +``` + +A continuación se muestra la interfaz `Wizard` y su implementación. + +```java +public interface Wizard { + + void smoke(); +} + +public class AdvancedWizard implements Wizard { + + private final Tobacco tobacco; + + public AdvancedWizard(Tobacco tobacco) { + this.tobacco = tobacco; + } + + @Override + public void smoke() { + tobacco.smoke(this); + } +} +``` + +Y por último podemos demostrar lo fácil que es darle al viejo mago cualquier marca de tabaco `Tobacco`. + +```java + var advancedWizard = new AdvancedWizard(new SecondBreakfastTobacco()); + advancedWizard.smoke(); +``` + +## Diagrama de Clases + +![alt text](./etc/dependency-injection.png "Dependency Injection") + +## Aplicabilidad + +Utilice el patrón de Inyección de Dependencia cuando: + +* Cuando necesites eliminar el conocimiento de la implementación concreta del objeto. +* Para permitir pruebas unitarias de clases de forma aislada utilizando objetos simulados o stubs. + +## Créditos + +* [Dependency Injection Principles, Practices, and Patterns](https://www.amazon.com/gp/product/161729473X/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=161729473X&linkId=57079257a5c7d33755493802f3b884bd) +* [Clean Code: A Handbook of Agile Software Craftsmanship](https://www.amazon.com/gp/product/0132350882/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0132350882&linkCode=as2&tag=javadesignpat-20&linkId=2c390d89cc9e61c01b9e7005c7842871) +* [Java 9 Dependency Injection: Write loosely coupled code with Spring 5 and Guice](https://www.amazon.com/gp/product/1788296257/ref=as_li_tl?ie=UTF8&tag=javadesignpat-20&camp=1789&creative=9325&linkCode=as2&creativeASIN=1788296257&linkId=4e9137a3bf722a8b5b156cce1eec0fc1) +* [Google Guice: Agile Lightweight Dependency Injection Framework](https://www.amazon.com/gp/product/1590599977/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=javadesignpat-20&creative=9325&linkCode=as2&creativeASIN=1590599977&linkId=3b10c90b7ba480a1b7777ff38000f956) diff --git a/localization/es/dependency-injection/etc/dependency-injection.png b/localization/es/dependency-injection/etc/dependency-injection.png new file mode 100644 index 0000000000000000000000000000000000000000..2a92c9eb228b3155c1599308668e94ecbb32d7f1 GIT binary patch literal 22493 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 Imagina una fábrica de armas mágicas que puede crear cualquier tipo de arma que se desee. Cuando la fábrica se +> desempaqueta, el maestro recita los tipos de armas necesarios para prepararla. Después de eso, cualquiera de esos +> tipos +> de armas pueden ser invocados en un instante. + +En palabras sencillas + +> El kit de fábrica (Kit Factory) es un constructor de objetos configurable, una fábrica para crear fábricas. + +**Ejemplo programático** + +Definamos primero la interfaz simple arma `Weapon`. + +```java +public interface Weapon { +} + +public enum WeaponType { + SWORD, + AXE, + BOW, + SPEAR +} + +public class Sword implements Weapon { + @Override + public String toString() { + return "Sword"; + } +} + +// Hacha `Axe`, Arco `Bow` y Lanza `Spear` se definen de forma similar +``` + +A continuación, definimos una interfaz funcional que permite añadir un constructor con un nombre a la fábrica. + +```java +public interface Builder { + void add(WeaponType name, Supplier supplier); +} +``` + +El núcleo del ejemplo es la interfaz `WeaponFactory` que implementa el patrón de fábrica. El método `#factory` se +utiliza para configurar la fábrica con las clases que necesita para ser capaz de construir. El método `#create` se +utiliza para crear instancias del objeto. + +```java +public interface WeaponFactory { + + static WeaponFactory factory(Consumer consumer) { + var map = new HashMap>(); + consumer.accept(map::put); + return name -> map.get(name).get(); + } + + Weapon create(WeaponType name); +} +``` + +Ahora, podemos mostrar cómo se puede utilizar `WeaponFactory`. + +```java +var factory = WeaponFactory.factory(builder -> { + builder.add(WeaponType.SWORD, Sword::new); + builder.add(WeaponType.AXE, Axe::new); + builder.add(WeaponType.SPEAR, Spear::new); + builder.add(WeaponType.BOW, Bow::new); +}); +var list = new ArrayList(); +list.add(factory.create(WeaponType.AXE)); +list.add(factory.create(WeaponType.SPEAR)); +list.add(factory.create(WeaponType.SWORD)); +list.add(factory.create(WeaponType.BOW)); +list.stream().forEach(weapon -> LOGGER.info("{}", weapon.toString())); +``` + +Esta es la salida de la consola cuando se ejecuta el ejemplo. + +``` +21:15:49.709 [main] INFO com.iluwatar.factorykit.App - Axe +21:15:49.713 [main] INFO com.iluwatar.factorykit.App - Spear +21:15:49.713 [main] INFO com.iluwatar.factorykit.App - Sword +21:15:49.713 [main] INFO com.iluwatar.factorykit.App - Bow +``` + +## Diagrama de clases + +![alt text](./etc/factory-kit.png "Factory Kit") + +## Aplicabilidad + +Utilice el patrón Factory Kit cuando + +* La clase de fábrica no puede anticipar los tipos de objetos que debe crear. +* Se necesita una nueva instancia de un constructor personalizado en lugar de uno global. +* Los tipos de objetos que la fábrica puede construir necesitan ser definidos fuera de la clase. +* Es necesario separar las interfaces del constructor y del creador. +* Desarrollos de juegos y otras aplicaciones que tienen personalización del usuario + +## Patrones relacionados + +* [Builder](https://java-design-patterns.com/patterns/builder/) +* [Factory](https://java-design-patterns.com/patterns/factory/) +* [Abstract-Factory](https://java-design-patterns.com/patterns/abstract-factory/) + +## Tutoriales + +* [Factory kit implementation tutorial](https://diego-pacheco.medium.com/factory-kit-pattern-66d5ccb0c405) + +## Créditos + +* [Design Pattern Reloaded by Remi Forax](https://www.youtube.com/watch?v=-k2X7guaArU) diff --git a/localization/es/factory-kit/etc/factory-kit.png b/localization/es/factory-kit/etc/factory-kit.png new file mode 100644 index 0000000000000000000000000000000000000000..7093193cb8d0256d1b6bad2434363135cb58710d GIT binary patch literal 37570 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 a(XB El herrero fabrica armas. Los elfos requieren armas élficas y los orcos requieren armas orcas. Dependiendo del cliente +> en cuestión, se convoca al tipo correcto de herrero. + +En palabras sencillas + +> Proporciona una forma de delegar la lógica de instanciación a las clases hijas. + +Wikipedia dice + +> En la programación basada en clases, el patrón de método de fábrica es un patrón de creación que utiliza métodos de +> fábrica para lidiar con el problema de crear objetos sin tener que especificar la clase exacta del objeto que se +> creará. +> Esto se hace creando objetos llamando a un método de fábrica — ya sea especificado en una interfaz e implementado por +> clases hijas, o implementado en una clase base y opcionalmente sobrescrito por clases derivadas — en lugar de llamar a +> un constructor. + +**Ejemplo programático** + +Tomando nuestro ejemplo del herrero. En primer lugar, tenemos una interfaz `Blacksmith` y algunas implementaciones para +ello: + +```java +public interface Blacksmith { + Weapon manufactureWeapon(WeaponType weaponType); +} + +public class ElfBlacksmith implements Blacksmith { + public Weapon manufactureWeapon(WeaponType weaponType) { + return ELFARSENAL.get(weaponType); + } +} + +public class OrcBlacksmith implements Blacksmith { + public Weapon manufactureWeapon(WeaponType weaponType) { + return ORCARSENAL.get(weaponType); + } +} +``` + +Cuando llegan los clientes, se llama al herrero adecuado y se fabrican las armas solicitadas: + +```java +Blacksmith blacksmith = new OrcBlacksmith(); +Weapon weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); +LOGGER.info("{} manufactured {}", blacksmith, weapon); +weapon = blacksmith.manufactureWeapon(WeaponType.AXE); +LOGGER.info("{} manufactured {}", blacksmith, weapon); + +blacksmith = new ElfBlacksmith(); +weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); +LOGGER.info("{} manufactured {}", blacksmith, weapon); +weapon = blacksmith.manufactureWeapon(WeaponType.AXE); +LOGGER.info("{} manufactured {}", blacksmith, weapon); +``` + +Salida del programa: + +``` +The orc blacksmith manufactured an orcish spear +The orc blacksmith manufactured an orcish axe +The elf blacksmith manufactured an elven spear +The elf blacksmith manufactured an elven axe +``` + +## Diagrama de clases + +![alt text](./etc/factory-method.urm.png "Factory Method pattern diagrama de clases") + +## Aplicabilidad + +Utilice el patrón Método de Fábrica cuando: + +* La clase no puede anticipar la clase de objetos que debe crear. +* La clase quiere que sus subclases especifiquen los objetos que crea. +* Las clases delegan la responsabilidad a una de varias subclases ayudantes, y desea localizar el conocimiento de qué + subclase ayudante es el delegado. conocimiento de qué subclase ayudante es el delegado. + +## Usos conocidos + +* [java.util.Calendar](http://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html#getInstance--) +* [java.util.ResourceBundle](http://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-) +* [java.text.NumberFormat](http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html#getInstance--) +* [java.nio.charset.Charset](http://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#forName-java.lang.String-) +* [java.net.URLStreamHandlerFactory](http://docs.oracle.com/javase/8/docs/api/java/net/URLStreamHandlerFactory.html#createURLStreamHandler-java.lang.String-) +* [java.util.EnumSet](https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html#of-E-) +* [javax.xml.bind.JAXBContext](https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/JAXBContext.html#createMarshaller--) + +## Créditos + +* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59) +* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b) +* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7) diff --git a/localization/es/factory-method/etc/factory-method.urm.png b/localization/es/factory-method/etc/factory-method.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..7c97aff91ee62479fe718c40081dfcbb42b61920 GIT binary patch literal 53024 zcmd43byQXD`UMIoA|N2rNQj7ZN~fqucXu~P=cW_^rMtUJT2eqjxShDP>q!iMh*ZFTJp4W8(^JTbAix8`PKw6@TFXYXKX!JuztiOIx8 z1P6x@X{w-N|L5m$@ZdJiiC+~5-z6|%y9;j$XdEL)zJC=jNgSV_jkY}*CL=f`m7m{9 zhW_>5JpvxhpT~1+FW)~5cf?4*Mugh!)U=P`U9c{FvcVKa67&C%LiOX}vr@sQ`yZd_ z(aC(rs$|jYA&ubTC8dHB{8;wjo~hacczf&VZtY=x~@@7Jyj7&aA& z)y|$>i*?1iM_F`Sb&Dx+-PDFF{_rd|nAwsHu%g}Fd?z6^ovNU{?Np~|ep9d|>2c~* z#9^V&0sC&=E7kt`V$saP>d;~Sqi}U;83%5?Z#31Tam`%pR)=XALe(`0!*KWrFtK9}%g01w;AwM}~_2 ze|ihMa^;hq8SxKK>PE_q`+v9-{_E6`(3%Na{~NT2233>wkg96w*AMRs{`1EGqe}y3 zHkdAC#XpE3==cN=FGgD6N?|&O?5`clkPI0hLO1?SFGE*H>LE@X992h0_WS66ulT^q z2rPL;%fb@wYNewyztG~>pUel@7|KGzAo+yxud|3ml;uDbd*j*i(A+OzQCB7*uGg1m zp=7V8r>AXKx`Y~6PWP7<$!#+WosE&ui9{3?^W-SB8{8}>D?W#W2)Lc@g$P_buk{h{ zr~Q41yQXp-T5$#a{1<^z%3svj_R&!*Jg!{xhnt!fhO)#L-Hp0&(c~q|f~ppi3@2#w zZ@e-1skFX1tEi~Bxw(mnp=j<=N+*8`@%M zvta}i>ALx%mHSHH%H3dQGqnyC%=&GCdwYA}fv!%MLY!S5{(WHRE7g9jtehN1&Dx_c zRkK|w0*!ut?c=5TqlL@;Keoy;dK|SIltbcG|hz z$VrK&Qypq;&GNjtrj$xFnXE8va68LQj(cHzfD~YGK0(XD!Ew%M_LB;>A0f@37UHlq z>V9^PNl8hWlOvrn)Xtz;JJ1e)=iUIU9&$oNM6|ANZ_nzUIZ7Cq-n`fv;IuxlFkNG( zu(Q40+vOsg^gP(}tk#8?#}PVKtR2T1w{m=WW`~8-rDdJv8`pq3RC&BH z>?a1ycdEZ0EF)UyxPAIaE3WqQPw4!-4mbI>t&@}0T*KALoM*oyHCr;q**^=Mt&^XjYVaQ5k`GtKT)6=PK66>Ms(NOP*(SUQ>4 z#dfXFef~Qg91B7Mt3SDASl5`UHSF1UG7&9|-m_UHcszGtX=^`pjHn#p8 zoLaTlLXX<4yonR&1mO+=;LN*6_!;dG;?Cv?0N$^`R|gUY}9mf2pu8m3gNb#=P0 zzmFFf&uSVjxG+I$>LZ4yQK_4~`=P?JJ(yUZ!d`xzToa8uncvsP2f4to>!;-9(XjM} zegH20ySav>(9oA7++18q{OsBr}n@xw%_o#W9T9$^1iTh7ie{3K00Qu+akL z-L{~|QKTvvNfW6&@PX7@;eh19oKniAdv_1&UV1fwg5rm!{ zuHBq(6<5esTkD>mjDAsHY7fZ?n*3^B-tsYh&g7EXH-b{SL7}7kJ_UC&Td~L0`Qp-D zmaux)Gb3P&%Pfr+mT#zKmIaChxH!T1%pWR&m(;zP$&UL4ZtjQZvfMmB=;gOvzRwdo zsq-*1Ju~Pw3U?bW7%n=JQ47?*ZgvNHOj`vBUSA(UG4~j>VpVb zU*ec^YvK1d5QXJyH+tM#set1%zaF$VyifByLc8s==LSs#`m2XQuA(Si9aes%W#F z)H5&!>2ERa2##!p;-tJ0k(9(CG2*V-J8)QhO}+AiWU5pQ<}c~|!&sF4-Lwd)cqA3G z$v~>x*@0%G2cL4020T2xl$4YL2^QAtc8zLlGOO8d_m-Bpq*M5_LZDS8?QWSaxWnxM z@szZ(u&y`%_F0|Nt`?}#d2XQ8**~+im}}5Up_;Ts0S3vCl}+tKV)w z18LRHdN)&xymbPD6{(ay{lCs}(-Ye0ZQ9$jR(g7|n#%PVL+<5EIQOHYBLh-Ner-x=)_(84acME_XJ^^T~V}!x(o~qXph<5Oxa6huFQEWj!-(m|NY<&#gbohK z@#cs{vB*#x_=Q^eTVAOFk#TEPAz-DBl85LZ_c@V&G3 zkjEVF0s{gdXWVxdx3(Zx=f|KCtn?-*bDP(3eGZ8U&-}arRRjf6C3&$giATNaouTRj zeuz*$un#Q}$2%f-A{K-D7wez^qo3}#lTMs_n~xUO*etyTkva}f_n6JNk7$xXA$Q=5 zdQ}gX7W-=hZir#+t1MIo%kl2OoevgMBGlB>(7;SV?|b_zs(o5v_a5NCB<+r-Pl%3& z?Jcx`)I=xccWd>>u_(4!k~ApRGCCR_f8kVCUfJlDbh$ZFfcIaHg2;}RD{pLUkdcwi z&d!3cAt50FEzad=9W$!Yd0%h#n~Ro~R&a2z4+@Ui?6l^o_G+p0UZ&K08X@?xNSORmiqacb?gPg)dv|A6SQWcGBOVp6BxA{ z^jiHvX40!y2BtjFs@%^mSI+hXQ0Ju9X?F(-m59j&VNMrE;Z|7yFvgMQH{Sby@XuXA zSbCvx@e@rm5PJ3*Gcz;8!^5o?_GvatZ7Y3Aw-Dxk`gw0XD#cU2< zR#w&^1`((Alm9Ye-NQ2F0Z%=~^_tq+U_!P{P(c@GxWhsBSGTJ7`LCE__z1;`Tw=9f zmk}0jkD^unuWmQg03fGrVlWZctE98Teu4IG@4v_=)13^0xWWkl1|F?aA@F|!hgEP; zkff++jpKIw>EFV5|3d{Cz=$AVneZPpH8qJoG`KOFC^H0DqT%wO8}v^^L`2KkZ(L+# zf^L8Be^*dx2-xvQ=ks#IcQ6`G&T+WEmIIf?DTgEO9>yiqPuAE`CYb^p>G!1L+5t4& z&7PkHt$8|syY`1d8kFyfU0M{nv;T#$sUq~avVh;UK!yOnW03GVA1r@9eG>6M(7P;3 zMamSo!?-`W-g=?=tN9qX@(F)O=5IuPRA_ucGAkx_=ZQIQ-Az@s_&?{2!|tXAaFZ6a zc{aA=W*=0iooP%`0{|FrFK`|Gl38K>+8wT}ZTq$9A_L;@PZ`S5<*>ROERT9( z0BUeJNw-i@U~F)~hAJK8*lzEGy66I2Y=6HX>YtgQ%pV-_@^l|Gp#A-QkdrYCnvec| z7jC!Kj2OyV^$YN+Uhjq9CwO>QRS3YyrM953u&~dcKjSfIJp9*3%9Nj&mq15mQ`x}n zRFk!^e?v>x&rqCO3?GO4`vS$~BOmaU|GFU02Z}Rli@=42qm=f+=6#|UO18cD+(f}q zMK@A2IywQCe2%<99&T|N{X6<}bI*$1VaERL*~`UN)BXML7Ai2a!;cf-IsWI40Vr@C zrnyX5D1oTUcNJbxXc`qW>`oA=7wEq^hK0fFXH*q_lDagnBICmkg&e~v(d-XG5vYgdabxJjMm|19D*ov7eI=fuU)g0-OXu#3^&6?^h4o&+Bn z(33%;h%<9$xUp?k13uSnIey+Z5fw<0z0C|{~XuZPt|6l8P^ zYLwdVv<>YKiFu*R&?mpQX{tU#lb}XTJhRp7*|T{%d}`6P26ZVw7SG=E(e8OntN#XG zKf*USN{LqQ{D_R0`DMvr`E%R`33`{L=7I`_Mb*B15{nYEnqavY({@_!jJRkEx+)y#?Hy^) z0jPBw7>3f)?do_fyW7F5OY>-L9`UC*JluC84|KIBkBQVYt!3c6deWCuL+j-}zaVe7 z%30^m_&$Hb#IP6nD0JV`=1$$~73X_x6!+S)@N~pfpN!TE9ld7?ll^H4757XPkD{hv z$3;Gxp{iOPGV>wgDr4}xcEcbg$+Fa*BSgguHd=Z2u4r%&b=*;+r5UZkPMP_kKQ(^bMh>D7GL11(>+2&(Ke9n6>q1tq~MA&do%Bi@h42mtJT_j?08a*y7{fe!ErfZ0)#9~P9 zS)hPe`B769$q$M8%z=dQQ7FL;wmF!wQTyUC5$%LYDAOY&kC%rs|g&$rlWLtGzF_e&&TU zrs#Kux8B3pu|IhieuS@T)Jr&8>+t$of2GUt4QWgBsz@Uu9sGXaS5PC&Mhl-6`lWn` z@7HqQ7wY%&D(X*3@ukkg0B3%7>OoZH5Y>TuPnx95_4G%U{8=;OYH*mEr2TpqF@I9l z$brQKOWm8#>CJIt>XmM5-HZ^MHoB21E9FLKo3$+QIum^m|4_IrTVgMUcybZxI=3g# z`A}wN2X3KgvwgFQ?a`;TFyRaStApvCUPi4%Tv7}#b{+J83Vms5>2gvZn2xt6*?vEN zJX|u$IF8tDq9)kEx(Nf;rO|;7>S_b0m)UQeJ{3ZdwQ$>=4ZAtHsRXHi zGO9j8D!@<1CnsimPzxHa3{-MztavvkHW2~&n*1vuaA2bUWs?fiVF^>Nl={t|c@vu> z@|>}9j&Sl_2nK8y?GlgFd&B6@P?vMGHaC^r+N#Pci9((gP|M_c6^>*E6ES{?UTeXa zBj%|rE_p^{#y``LTHtKXDt%4E890qqQz102d7fhvsEnuF>`U z_wTZ7W(t`H()?#Hr3C|!LAIc(KgNrZh4~{mI5Nnoso_hA8iEosKbrO_>8oL~3K5&J zJ%gWynh$W2Y3Evled8`S!=DukcL0Xtb0}8 zZIE8H1`Ibeu-$vG{&N4YxN!%cEgy;J^yuT>dQHC5v8>1T%SKax=U8?TeH=01=sgv1y@;WC* zdYLBzKIhQ+Y{@OnhHq;i;$-LRjd~Rt)QB?-f}ReSXfQG42^w})R|l3UR}7}LTtFvi z(X%tTnX(E)lPh<(`!1C4iqq?@`qnf^ZsO6%bug!73|ZLJxp5o1RB~p~MakWkvk_YC zhdWjy0%fuxmefXt1mTZ_gxlD*t`=2sEs@~V;gGT*AY86~)%7wi%(Kf(RNlBoUKd|f z-qs&gL(l> zy`{O9E9%2eSvc{Z<)Z(|ohYo9HX*j18v2YI@-u zd%uEpt#LhbB-m9L)5lw*$93bHCpv*Lxrk*G}@IGuYlW$i4V)ZCnNU1vo%j? zZ@UNR(KvynF>TM;FH?R{9e$Iv=6?PcYy>6mWXj%#nW})6ZOX#Rz!1@|)fA}!dX`~d zAW_OdnKsl(FGFS-3afrzKlC;>eji0d5O0J6w7fSl=EpQC7uj(JC8OJ=xd3ZwjhD)* zrE%|hR`v+{^pv6Gz=?eq+(>{PD8#8nJ@!DR`lkw%$sZalu4D&huY&owIzU`-hlZ7imt z)1D=-#|PqBm9ies?{c`x&2Qj1%R?1D4f7hl@>hHlEnS9m{CE@YTB^4|sTZ>Q82; zEa&cK~V3f6AcGny=s$v z2?(rd$Vu=eNW}sr57u?vu#$mGDx=l4`t$9on}id8=aU(3)>mp3CUh5^7UPshrNSYj z(4_#poH>^q_OsLk4vgsr_dSr~^r|e^M;lDa$}uUP!S1JfCOY#}=k#tJ^qLomyvoO$ zEA2rLHdUY@ba&X5=H+498c*EXquX|=O9AHZO`V4-(fMd7B`1l1%R`vrrlsJuUIU&w zQh#47>LN{L8hKc47s7h_`4T8{`DhM;PIehqzIEv466q| z=760*Cwv#J_2$0^V>`<)tPj>}YM|8C;gParqPkGi0ei9 z*W*9B>JP7SQdBC6tp7lrhb+-)`|g>=#EDYO%xn_6JKLE~Ppzit0`pwEl>mMvrCIMa zGnUiOYm;5|B>K258b5D_e1SeUE@q=s&OvRg!?D^R6#N9%qsE)r(AH+3%o>i@U09Ut zfV}dvJoKzIP_Bvk;(ya^dwH5Ylr;m}(QG3ycFwdV6dfWZG^6LS*!ut zc(ncrb7l^*YpKNG+9p`t^+iq*+CT9AP602U_;bqQjBtQhtLyLtJo$G(BPmdlG_oNl z9xYU@Hy?ZCam_V4GLq$bd|=#Xadp`LI_PmDo7Jqy;6zqG=kj+%J2nKO$l%hiIg2b^ zS~gbKHw>4LI_Q4EC${Ra5{k-K<{K3*1a#6KbTnla1p=_E6#5Co`!z4#bP@_>>(=OK zI9h5jWj%OL4IgytCcPPT5oJ_n&oAod?;<-#UeRfbsGW9LgScuBw$xcEvsy1vd>56U zKHQr~Ad?;VnE1OGpv%+UTtc?SP6E)E@anUiqtv=9y+5=aZI1X_CVYBiH~*oA5FTBu zeSA{hCcFwuqPPpK@h;1+(k(^-N@U~J)oh$*87svTZ$Ean`>%E$$o{FPypDSRKHWbv zz>#t5<=1x`bqm2BLuM}Ei1D6n3v-^*AN~3>_I5W%>Jy(xMHJZ;9B( zx@2MNWEL{j-+!@HEO4`yg6)WZGqwrDE1lxmhutyK(CM>AxbZiUv3Il~WB09PxZ6gP z{ku2ImG{KIOGFZ3mnqYPUGr|2+ET@Uv45cz~PJ`OBI-GhfY-74svL z1a46KPQQ;Oa*d$F=67K*I4T4>UjkN%tWts!uWT2unIqnWC7+qkyhRL@B<9jm`*L3#H+*$1 zCaoCaqNq~!j+=IEiFHEpongVEw9`sgGMJf>kU~J;JpJ+c4j-?W3>vBX&q(@&ggh!{ zZrArY#+@29w)^G~GO->8h3m&CNLkNmoM{HXDQ7FM_-Z5k9$BM^@$sCw4_klCIMn@c zuE&^?qD)}xi_3}@4F)`edOG(5Lj%Ck&nd`eeJVf|*Hb(TC{EsWwAICl#;QZZh=cbZQitpnh zK?sT*%-taFG18Qm0w@C@a$WC%5sK?q4FKfQpOf73OI~gN0FNKa2O$EO^k}G(Hgsm{ zXQM}&rao{6sMa#)x1VME|NJbi@!Mc&lLpkU9*BZbVvx`e%?hFI{}Bj z00X@#1;poT;>$k4m0!eGaju0JzKeH{t-LOjVn-JjRa3zbbWvhc9_t&VE62n@Og~RK zx%9;Z7(Z0tVfPGzB>Z0tTM=H5@Fa)q>u-RC*MXdCBo-a`O;c0zBdw23n@~o3@b=b% zZ1W(q)%Ii*V1V}P031zX-!AvZ;WJep$zORcMRdBiF!;b}kXoz1>0C_U3cCewwQpOd z#x`zXK(+av!KaE|zySo+|KRJlYoTB|8!MPL=5(+UP^Alhtt_&)3EahQ%iD<&KW; zU}O~%X4I*3g;~fqdVGnD4D!5jhc^3cmm8r?eRDDLt;@`rM@`}5!Fl|6c|A6Up4{?z z8O{fZG*;N76Q%$|7d%AOCBUM&TRBW@&uk1RM_{xSPDNo$?JvN*bs_1aP|_DR!rLLR zh7p1n9dMQiNKtmTr}X=MN)ohXqR2v71Hx$3HpHVKT#1d3F(KF+y6F-FKB!Xw>T1=L z`7t7+lPoRC2eJ31gkWtiGM5HKB)(Ep0Zi6XJBMiF`tF?b{$g?F$`FbZ^#1-qzD!A~ z-Ej8tI%P@or%x^`T{ST@D}?x*G*0i3uzZ9=ii(wsv&+lng9ve)w$++ZOm$wiJG(|F z^16iXX`H`A)x;i8JgQLld)nv0#hj)!b~;2l6qM>|njoe{&lTcO=cV-CyGs>BRo$!q zn+o)?;jGFO^b618Qo#@l=1**ry%{G=AoYXg4%Y31gZw97-n)yN;+?D}c)K-!N{Y!3 z3PPiid2*BDNfPcMi!7T^tUb58C}%xZM1eu_Ogfe+RnS{a!FgNlRoGLXM_9@;jVZit z&K!9cXmclazI?8FF_CKi>)UVXtd|wEQoVi^dm(M_Y$Wgl<4_8fhsE$-CbkZ%;`b(GN0gP@leX#8)K2VbiV{V@*e? zvQ!^0Tj8;|*cko^z&x*WC=qdes{6(B!o8iDXVJOg^nn4WM)V7TJX+8{K z%dhOaAUquFuilCR_w`Rx0<5$e6NPD!m|C+aiy)Nvdx7%F0Yw0A5KaRZ)ie%1r+-$i z1T;MPmCEUn>E=+@QvEj?UJtid_Fl+uaNY_th8h*8r>}}*DVF(^mJ04R?$UB28uw_4 zqB?lv)=~jJ69EYkZs0fU_^*;<(iE9lLt~0e*?AXJ6Tr&x0Y8)pED4~!1qVJbs2l&d z(;i}VzLpXxaKnrJaNw(UBaC1NoI~MsP*`%Uhk%Ux`&}_BbbdEy`=QMD%^XM(;iCh^ z_*`Xvd%c3P3)@pj0eFmMV8(_uKfx$dR>Is$U-QNrAoz#ngu6Y~^Iz3W{On{7>k{(t zTRdwXE#J_l%q5e72wo*IDe0@Vs|7zQ*x+0vGa~X(@%RUeZwQWEk`7A*_{z9mHWP?{ zOjplEjk8hQh(6p)%vW1g2iXUH`B|t+4Vt;u9LLwHe}lkF039 zy6B8}j%G2OE$i#Ug%VY_ekOF77X#v$D-k0Z;~xWxZA}zB5LYUUJvv*{)ZXSU{k$pQ zV*A1pgZO;ED=LD^=eUOYekM68u6;Jyac=^W3RzT75>J@|_1M7*pPn9W*{g|>ri~6C zRN=ZhypuhuCelvP=58*#w+~2XgDi(tP4F5U!jImRZDT*Z@LUQZA?}aq54*Yxc;x+k zGC=UAZvXr_z+yNp@zWwi`K5F&QUCYq%x!Fhr84ab9kEoqwbgq|!Dr4|CF#d2eeob7zY?yCdwZ$szPfsHr(>@EkX zj1B9Z{Bl!ogEsf)1rHkByTPK2+m=!~baNisK`qY@M#lBNq<}Nd=!lOoPCL(JABZwD z89!ia58TMGe>%L)Dw*+?9~1L%XHGi1`snO%7*ItEfrqECjp1l{t+d3n5L%s(Kh3<` zo=5V|(hxt0E<2`|tD>$OP-4hNI-D2LeZWb-yyc|p`n50(yQ6Du4W$oPk3r~Hm<-MX zgMvD1*R^E_c8SJYGCq2H--)U)TWP0BvqU)@cib99tFqF5R>#fBa{w@L$pKiw8DyxW zcmJAWHRrfB)_==ydEG3wCW%qXndNZFq&|K)z{bySus1JN*i7p2>EOibo8z`UgRurY zLhlP+ zHh)2^_2_tO>|j4HI=0%MF)UdG9O#v?ldWx`Lf#RnCv+*W$qq0|6T{3JeborCPvLC- z5-qk()do|h&zTsuGZ5ujuqKGaDl?r=BLFtpgHBK@#jeDkIUon%*by+Lf^7;))f#k< zc*T+ohV#??&!zeouFjFx_C4x#jw_(|UNShwY~(8yY4{o*5=f_HOT`_So*j@Z)6~}& z49%f>j3x1iD)e`R@qNsZ$@i-S`qVBIy1cfQ6j|}snW;F%!(Z3Os!@}Vk1vS$wN_YE z0;fK1GJBR)6vH+Qln|KB*}>JOw7~0(adCS?}e|iUxWEAk3 zg)*I7`18RPx*D5x+r<7qTuDTOD{O9MJ~yy(f!msyt_nA4olZI>k=P{|ZYTVF@Cz^m)F7uDDIrh2w? z!&7VA&kj7yZKF2~x_!nS*ArMyY|u6eI>~UU{;*t@#@WYgIX*nbot_kdxgt$*5M{Mwb1au45mqEE^%~%8Zb;ViO8j|# z54UvB8(4v|G$!uk;v1zVT(t6H+El_n{Oi#DN|RW3P58%Yi1Oj9`I!{cTR+lGxI{d1 zm!DTD7}_3i6Taf&;u>OrDWKLhvQCmPrQX@^7og^ItpE!^a8ZZSh(oYIg4Y{w0GCej zya?s~x?1YXYp~yt#Dho9o7d>6-(t?^=KM3YWSk;IEWC=>wNCz1I=`Y|7*QdhVOX6&8l zfSUF_wqa*WeQCEbWTgkuQqqYjpO?ux63lg-5lA+VZc_7T-xA-lNR5||`uQh$V2i1o zi0aX}V&a@H67Ni7=D;s4{bpl-hO1;1JEI9d@*gtzZHa3ObO&YpK0vDWiS+affmLrSh@MfpycDfg zpa^0#wQqgOp-XYAm^RS{>2NODL0PA3oOVC0zZuSUf2%mS7unnxMN2sh`-prSZ^lSe z^;(p5N|}=8qG>DOhcC z9(XDILf6=3>&xbm6)5maiyzLc!@?Hw%L*?yh80kFxg9OUh(pjh9n4T^``@EZia`QO zya}{g$*wkXY*4NRd6WZde{js*RVda+)C+n}dZ#N|V4zah0a>>FJ*_bHcQ?&Q;-PaTwa#5_w z+3*z=j|dg$wfV!`d7T)1+g#w`HE)9mK4RgxEGmX!JAI#kRzgZ^ZEdZ$GD?outxU8U zSaPq$hVUbsl~#(ceW3;ts0icYcx*`;^GN3kulDhIbhbuo#3l-KTlnMnAe@#1UJXDB zRW9B!Tq!$d^0;I^2duKg`W`>poND3I#~YIDM8 zgGpW+L%VjXHqbzDX!RJ;{pCvxP17oVe6-W4N8AzNY0C=cS;XG)v4DxmkNKrx{1c%6 z?-n~*&Gn&2>Z~WB>10qOz$y<-;gD4694~bTYrSB7$g?GW&U22Kh&Nla?u15>ruW{2 z?^yqwW=&c9aQU+-Dbb0Jn-mfO{_Y6MD(JFIGx8YA8_v5Lwf2`tq~E$L9rlI`Kh)dH z!U&&`8e-m#7WG^r83whjfT|tm3-|C5gaqI~^j}TKy|^Rsll(*1!~@2%K}6JL6Ypjw z_I6UA+oX2I9WE)C!IsUHf%iY>Tza65%>Z&*s;O4BT10!g9+F3;(eo$Lkf)w+k+M3p z;^#>79lXD~7y2ii{l!@9(XEB!Sr{BZPFph?lq<*A@;`9rB(;;d<$mE) z+5Z$sg!8wk+0TfL#l<<7RNjCbJ#o!_R;NG#0XzKB6V0-yj|U`@xT}Q%?ltEOgQ?wV ze^F>%`x?J55F2BpzaQVwHP-;axGApF6ksIB=NRYac6^nZq)o#)4LgmUtX zE5;U>=tlzQxf_5x8+WXFN7`^GW$Dkb9z6)}eqK>;M@h}=MsmYSWV1d{bvcPwcKi$w z#P2zU-0jUfxB=xoewP(kjg;Z~dL{uvAr} zqG2B9`c7=xRLzMq69%mh?bR|}J74cPi}n6RBy76vA(%ad<9eUsjoYF2568IvI7(8~ zbeUerHCFH)mk7IpoLc@tN0k%{c&=^I-nj>e7@KzOS(;(dpDHu{FDVi8`&)n1E}Q1@ph3412pDNe4N@20E% zUoEGcyCS8}^r6H&wlZSqf+`~S7`nt_9YHV_z9DaG&07yPu*$W7`49IT55^rbBT*n_ zML}`kxX|+cL4_}+Ub4xD6T95eLC7kNsrFN)!_riU*Nj3#7mUVyOGu+1Ag^AQN-v}e z?E4X`$QQrnop@mP$cT_LrpGz8 zFP1^^e-JW9FueRCtKIFzWv!7VZj>E#G>ieC!P%HdIjO)rdu#rFElbYw+VjO^MB_?` zxl3cxT1zI<9*uzU3sVyjpTlB3JoHZ?B@-J04aCVa~@I@71dw0d{;^WSYkO z*Y-m6q{?HwKS zWiu85`c@(H(N%ce^q~(to1V7uT0D=FL7rUEN;l-k4>|)M9>Ryqu8Yq$KMDi^VY;w`k`MruXJ^qRr*ETO|)AL z#OMF^cq+Smpvd!DRF)e|t3Ia}99rK_X=T&0ckUY}(8^?qO|)z+&n@8q4Y6#Xnloae z;1`-afEDHEJw}pW)DatvMwUka6qi1u4Mw>N2xzaKKUA97@I--sQ_6#JcB9p%xIjin zNz;;Z#YbWy&ZoR6rXMMQv%_eWi-0%n+Eh#~Pp?5=3akY07Kx;BimUA-ahNS*VKVPt zUm4_oY>=z5C7^lmfM_H~T79w_!jUJHL}O~IE1jH}IWPv=J8CJu!ZxsZ!)ZF@g~%Eq zTYkGYQs)JXo>8r04-CFwlgi14T4VtiN9s3AdKo64?RE}mbua;xi-b!_S{n72%Mhu2 zQFED$WiubI+a3Ldn81s1!3ee^lPwPs6K@$4h0Y=p#1#FuBVe)($N0D8P9JpxXa|7U zDOuju^{bu4__VdwpRMZbOrsZudcyMmL4&a9VGIDxI9H9&LkjRus9zT9F7`(oPZGw2$J}3l(fVUdU z-D0M80Yl);8Sq`5Bey#sRj(PXJ?UXYT|e`@LHKiWa>|H;y@NuU$?TT_mhybyWv|If zOWp41-IDMeX?f6xS_oeYm#xQlqzI61Kk}VU++P5Wfw5X?2~e9#g86_!dse%U#o8A*w9jQ*OzMn!#cl=F zxkkR6cM#4RuNQ1=Kl}S3yR(L1!)OIHi!$6YC(dLo*t)U?0lUC_!GY2)FrZrkCdR{o zp8aE>k9fht4v|$)%&eI)oBCTH?>F7}&lVI)O`B}yXF2<{I${{Bk?p@Q0qc;EkjYsa zbF5@s!)Lg49Eg)loEpO8o%?VXKrsOGG0xdi+oMB%J^91H*%x0m1}MSejQ#dxneJ;+ z|59qV^w@lp!RD~A_ZBe&f+ZYCRTgpd_F5I&%gZWxavK8ISp{2Nw##JI=?7W$>h>71`SVoZQSq$G@#&jaZ>CwraN~6%I(|Fmi~9Q=GRov*d!qYG-sBm*)`JM>Xl`MJd;Kag%Qg zH2XXE?7?dd&uGU^rS*Z?y17<~z;lGvgQYRYq=*B%3`yhf<0XT_xPL)J}PRV%6w+jIEnSFJ*vZ zF~}rd^!;!x#~t97nuyHbkK$;iVWcIE^*ypMfS%B(^R~%aUU_Kl*WB>6aq6uZWVPcX zTkYn9?F^HtO6D7TCgaP_Awyh4RG;D>T_oQzdS{k#gR$vrx@i^y85_{>2i~6oxrKyJ z4Ua~_tLx18$OO_Bm}Z|2hE||>fx-y37(ILAqX5s1nf!CEv2@`p2|uryjEZZxF!f58 zFfo{ZvvR$)_2e!DzKBJY30yvG^;{l&g*O8m&JI81E@j|0z3Dj+oXOPu8NQOhRabBG zDq%6w>eeh;MA*hG5DE`MB0G9 zaF)qj6aF_iER$dAf*x0}DOrVlI#^Ref4hfy4Wx$l*gSr@QW7# z4qGE&h1_Zc%X-o+(oDDzHsBMN1)_oW(8W+=&V-(k$1I|1<8a_@Sfp)PdFZ< z$%_8m{MLZRbloc;XqZBpKf>2TF3RtmM)+Urt2%CUKEULMp6$2OpV@BTRDeY(%ee*- z6@k~NniXmy7`k{@=kr9Sc)ix}M8n-2Q%gZu6WBR!Snvb1U>vRHNDADbC|L-G8$kNM z(mG%?dNdmB#!IAcXQ9WSC)3HMQ#B5K`uzZ`5Q-~Y0kLQXBI>$jhV3lO8$hp5wA-!e zO;2mwL8yKE_TE8xAb}R+QM(m@Xfrp(?liAQw>P`26G1kukgM+Jo;P` z5IoK$Iw?f2(J&!pmAI}*oRx6jORE$Qsnw7g(%M7}uhUP(m75q0cLHFZ#|Zeo&^M7fK78T6H@8?8UtjBT_!5AOz*{x})SgltCPU-# zkym(VqR2K$huU~qo_qjBZ>J|3f_U2q!kUcy{Od`{k)puZ^-p?rrA^Qh?t?WL9iI&0 zljn@DWvPta_QzYZ=D`wlsK;1#2SbM;vZ_|?s}tq7sDGrXfO0{+4>qPqL9ueqIJu6iy$<{E)X`bM%4LDxw6o z?WmRnmI|T=qQnM+6rQHS98&^|`)#4HmWf9Iz=iBr^DRIW_Wmdx;o7tNG^n&#Q=CdJ zQ$}ww|KcQq`bZBRHd80+u&E#_jtV&dqf$fyAD?&`lLV)+77!q@fd7K zgrgYcP4~|s9PS1dH@=C0Kl47Pxf2|_x(lU#u}9yex&J_SC5M| zd1l_A4f)V;>Ss1dr*=ns{tw_j{9dgU0;=QPspy90;VP@T<1ORNoE*h3YCFGVO#m-h zzxVwr+ZquQc3$(m$mf0;L=^j^VK#l?Jf1hFqtFtoV z1^?@?l`PsLcf$&=|2Y1!J#f4QPdOretQ;(S*r?eR28}GXLgP=$cOMXP0ZNTh?!4&r zN1{*mR_J6o1Qt?v(8WZpWgOv&A{z#SZYMLE9SxJb?|t5S?UDj}#~h-ET}Vz5QoXM& zX8s?x-a4$Rwd)?NQWSxh|=ASv~;7CfP{2|ba&_e z=Jq`2dEeiAeb@QZ!`f@zF=LD|=j1ClA5l)1sZ>Z5NYh{^dFFU_MCZSUlK7?(7Jd_f zOS<<>I<)GnXdbA|-XDaKI|DLiN?KVBl;vjxu>#T8iRBYJh7t{K0Zq6E`-CHl3J~c{ zCVPpB2xK4Hx&GfTA)z1YG6&CPq;fRxZ^Uc2q+Q3DEeCnfN>D%A*;x&c?S&%KtBurh z$QuvL)#&iW3HO4JiOaAjLuhB|74F_Y_vh+yBjHR`h>ywB7Zla9yhQM%UG9G)M71A0 zR3mEk{sRw^>B8BPQxyIti+UN;-%R&t|)^;sIojiEr*5;{)KER^t}ze zMA5Gcqcz-L7LomX;M-m}p$z%u&r!XDn?nOSz14p@-rB1la9hX>rbB9CZeSH&>1bmD zjTYXnYwaxcY(uOLK#Fg;wm{gT)6rHIknIN2-3b;N2P=^7$UWJLs(qFA$x@JHrMAW@ zS#!N@F=s^Fr@ugdwPTfby|ZbDJpBJfoL;SU-B$NcyMC}*z@G*%*~rU6x}bBxYq2R` z`5Q+5U>mgyzdRlA^qzU=?d3i5=Cpn0W-tQqtA z_3O-9k07l{D;!^;FM^1$P#{0x-(#A#l!{}+^{ViR-fiZn-l`I{{5MGLx;NHq6&yI# z?bqv;Il7|QOF)^`Q*H6=8fPBUAv~Pws|jsZ!bu~Cx6#p z@U5+!OnFxkj`rj&26V?2)lIMKs(sCd$c|75TDJ7EV5hu)vI1FsFW<^jo$}~6pxOASah|lTX-*yFf`JqlwT+RIHF|GO#vZ^m|{(Da0K>TYjG|ZJNUaF_jv&Lio1$f2#qdvCHqjFls!J`0Pqez3_B1o{&7_;dA2^AA|-+W(+v zN$CFp+{)Kvf`^SpOpRBK^$uD=qf)A3+MyODonL|0((1Qz4fh2pKk-8L(Ij& zm?=~~E23ZLiokzaaP&Vb8^e`HLP0@2o}>9_Slon8v-p#YRhBX({k7}qYRxT}JwY++ z^X&9IbJdzUI)&5nZb&zp@IJ~YXCC_~l@nkmS|YL$1J4#u}2XlK5KRk`rQt) z`$~vHi!qV(a6NfabKp<&bw>JXoX*qIIKd`VxH{pvB)|$5S}dDAa62v2u6LJkcD{p= zW6rKKLhzup?=CFja2a#HP{v)=13g?@r7xI%g%5WBB%%Jh1xSMV7_qw06;$zQ&X0@+ zCu6JKWAyzVk;jJm-zz+s{>e8T4_=FS%^*pOaqrx8c8)L_d+>mC1jz}S!2dvHit%w0 z=x5_+4QY7#M1uPQ$hi96A)hIK{}@(z{G0X2I({BUx$3u@YT2qLsv-4{2Bo0b~ zp_b0zK*llPBL(#s8{jW@N~9BAhUnmQ5>2^2w%)UB{)s*!kx`Yk=i9qfEEO!0`@Ssw zN3yvZ0D8xKPDkYFs+n7B{a8Tbs;i>g{J#;4&T|?Xqr3YoTpN++5#~6R+*hU^QD^>e zu-m(o{)1aTw*UD@_w&&L4fc=B!B2~g)8~KDA8bw~sFXj6(|HvZb7y67vDRU;=nGlw zjt?qG=#wjXgSy@*7q(V=XD(^y_FWPBP9L!1UfwVM1McyG7`;{RC67fyp1S1Bq|R3= zmEGev*^lsEVKX;9G=7mn!J)cT%f^!Qo>=aI9Gl6{EwYS-wdbTo_cqT@)q4@!|Ap8L zjSsT_Vrkuvw(Y0OhjE;ZFdp%M5cEo7?F&=}2~EX**EfjJhJ+41#RZACXs48vhVX$s z1QHAm_V&}6ls6M%9v+Jtks4FG*qGw7UviM?wep*R{%!<022eH1#nHDVHP>H>

-!jfFOV<3{Yf&iqK%v& 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 Xwj}!*zO Imagina un alquimista que está a punto de fabricar monedas. El alquimista debe ser capaz de crear tanto monedas de oro +> como de cobre y cambiar entre ellas debe ser posible sin modificar el código fuente existente. El patrón de fábrica lo +> hace posible proporcionando un método de construcción estático que puede ser llamado con los parámetros relevantes. + +Wikipedia dice + +> La fábrica (Factory) es un objeto para crear otros objetos: formalmente, una fábrica es una función o método que +> devuelve objetos de un prototipo o clase variable. + +**Ejemplo programático** + +Tenemos una interfaz moneda `Coin` y dos implementaciones moneda de oro `GoldCoin` y moneda de cobre `CopperCoin`. + +```java +public interface Coin { + String getDescription(); +} + +public class GoldCoin implements Coin { + + static final String DESCRIPTION = "This is a gold coin."; + + @Override + public String getDescription() { + return DESCRIPTION; + } +} + +public class CopperCoin implements Coin { + + static final String DESCRIPTION = "This is a copper coin."; + + @Override + public String getDescription() { + return DESCRIPTION; + } +} +``` + +La siguiente enumeración representa los tipos de monedas que admitimos (`GoldCoin` y `CopperCoin`). + +```java +@RequiredArgsConstructor +@Getter +public enum CoinType { + + COPPER(CopperCoin::new), + GOLD(GoldCoin::new); + + private final Supplier constructor; +} +``` + +Luego tenemos el método estático obtener moneda `getCoin` para crear objetos moneda encapsulados en la clase fábrica +`CoinFactory`. + +```java +public class CoinFactory { + + public static Coin getCoin(CoinType type) { + return type.getConstructor().get(); + } +} +``` + +Ahora en el código cliente podemos crear diferentes tipos de monedas utilizando la clase fábrica. + +```java +LOGGER.info("The alchemist begins his work."); +var coin1 = CoinFactory.getCoin(CoinType.COPPER); +var coin2 = CoinFactory.getCoin(CoinType.GOLD); +LOGGER.info(coin1.getDescription()); +LOGGER.info(coin2.getDescription()); +``` + +Salida del programa: + +```java +The alchemist begins his work. +This is a copper coin. +This is a gold coin. +``` + +## Diagrama de clases + +![alt text](./etc/factory.urm.png "Factory pattern diagrama de clases") + +## Aplicabilidad + +Utilice el patrón de fábrica cuando solo se preocupe por la creación de un objeto, no de cómo crearlo +y gestionarlo. + +Ventajas + +* Permite mantener toda la creación de objetos en un solo lugar y evitar la propagación de la palabra clave 'new' a + través de la base de código. +* Permite escribir código poco acoplado. Algunas de sus principales ventajas incluyen mejor testabilidad, código fácil + de entender, componentes intercambiables, escalabilidad y características aisladas. + +Contras + +* El código se vuelve más complicado de lo que debería. + +## Usos conocidos + +* [java.util.Calendar#getInstance()](https://docs.oracle.com/javase/8/docs/api/java/util/Calendar.html#getInstance--) +* [java.util.ResourceBundle#getBundle()](https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html#getBundle-java.lang.String-) +* [java.text.NumberFormat#getInstance()](https://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html#getInstance--) +* [java.nio.charset.Charset#forName()](https://docs.oracle.com/javase/8/docs/api/java/nio/charset/Charset.html#forName-java.lang.String-) +* [java.net.URLStreamHandlerFactory#createURLStreamHandler(String)](https://docs.oracle.com/javase/8/docs/api/java/net/URLStreamHandlerFactory.html) ( + devuelve diferentes objetos singleton, en función de un protocolo) +* [java.util.EnumSet#of()](https://docs.oracle.com/javase/8/docs/api/java/util/EnumSet.html#of(E)) +* [javax.xml.bind.JAXBContext#createMarshaller()](https://docs.oracle.com/javase/8/docs/api/javax/xml/bind/JAXBContext.html#createMarshaller--) + y otros métodos similares. + +## Patrones relacionados + +* [Factory Method](https://java-design-patterns.com/patterns/factory-method/) +* [Factory Kit](https://java-design-patterns.com/patterns/factory-kit/) +* [Abstract Factory](https://java-design-patterns.com/patterns/abstract-factory/) diff --git a/localization/es/factory/etc/factory.urm.png b/localization/es/factory/etc/factory.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..4b3420792e06f2f55e1d49d0fcac29e6fe8c2dd7 GIT binary patch literal 29351 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 En ingeniería de software, la arquitectura multitier (a menudo referida como arquitectura n-tier) o +> En ingeniería de software, la arquitectura de varios niveles _multitier_ (a menudo referida como arquitectura n-tier) o > arquitectura multicapa es una arquitectura cliente-servidor en la que las funciones de presentación, procesamiento de aplicaciones > y gestión de datos están físicamente separadas. @@ -81,7 +81,7 @@ public class CakeViewImpl implements View { ## Diagrama de clases -![alt text](../../../layers/etc/layers.png "Layers") +![alt text](./etc/layers.png "Layers") ## Aplicabilidad diff --git a/localization/es/layers/etc/layers.png b/localization/es/layers/etc/layers.png new file mode 100644 index 0000000000000000000000000000000000000000..a4bd8b19ddad1cac0134b6fd8aec15d9697039d3 GIT binary patch literal 97428 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 lB1^Ap5DW=7cfNYWCnbDHap(Cm_ Los Nazgûl, también llamados espectros del anillo o los Nueve Jinetes, son los sirvientes más terribles de Sauron. Por +> definición, siempre hay nueve de ellos. + +En palabras simples + +> El patrón Multiton asegura que hay una cantidad predefinida de instancias disponibles globalmente. + +Wikipedia dice + +> En ingeniería de software, el patrón multiton es un patrón de diseño que generaliza el patrón singleton. Mientras que +> el singleton permite que solo se cree una instancia de una clase, el patrón multiton permite la creación controlada de +> múltiples instancias, las cuales gestiona mediante el uso de un mapa. + +**Ejemplo Programático** + +`Nazgul` es la clase multiton. + +```java +public enum NazgulName { + + KHAMUL, MURAZOR, DWAR, JI_INDUR, AKHORAHIL, HOARMURATH, ADUNAPHEL, REN, UVATHA +} + +public final class Nazgul { + + private static final Map nazguls; + + private final NazgulName name; + + static { + nazguls = new ConcurrentHashMap<>(); + nazguls.put(NazgulName.KHAMUL, new Nazgul(NazgulName.KHAMUL)); + nazguls.put(NazgulName.MURAZOR, new Nazgul(NazgulName.MURAZOR)); + nazguls.put(NazgulName.DWAR, new Nazgul(NazgulName.DWAR)); + nazguls.put(NazgulName.JI_INDUR, new Nazgul(NazgulName.JI_INDUR)); + nazguls.put(NazgulName.AKHORAHIL, new Nazgul(NazgulName.AKHORAHIL)); + nazguls.put(NazgulName.HOARMURATH, new Nazgul(NazgulName.HOARMURATH)); + nazguls.put(NazgulName.ADUNAPHEL, new Nazgul(NazgulName.ADUNAPHEL)); + nazguls.put(NazgulName.REN, new Nazgul(NazgulName.REN)); + nazguls.put(NazgulName.UVATHA, new Nazgul(NazgulName.UVATHA)); + } + + private Nazgul(NazgulName name) { + this.name = name; + } + + public static Nazgul getInstance(NazgulName name) { + return nazguls.get(name); + } + + public NazgulName getName() { + return name; + } +} +``` + +Y así es como accedemos a las instancias `Nazgul`. + +```java +// eagerly initialized multiton +LOGGER.info("Printing out eagerly initialized multiton contents"); +LOGGER.info("KHAMUL={}", Nazgul.getInstance(NazgulName.KHAMUL)); +LOGGER.info("MURAZOR={}", Nazgul.getInstance(NazgulName.MURAZOR)); +LOGGER.info("DWAR={}", Nazgul.getInstance(NazgulName.DWAR)); +LOGGER.info("JI_INDUR={}", Nazgul.getInstance(NazgulName.JI_INDUR)); +LOGGER.info("AKHORAHIL={}", Nazgul.getInstance(NazgulName.AKHORAHIL)); +LOGGER.info("HOARMURATH={}", Nazgul.getInstance(NazgulName.HOARMURATH)); +LOGGER.info("ADUNAPHEL={}", Nazgul.getInstance(NazgulName.ADUNAPHEL)); +LOGGER.info("REN={}", Nazgul.getInstance(NazgulName.REN)); +LOGGER.info("UVATHA={}", Nazgul.getInstance(NazgulName.UVATHA)); + +// enum multiton +LOGGER.info("Printing out enum-based multiton contents"); +LOGGER.info("KHAMUL={}", NazgulEnum.KHAMUL); +LOGGER.info("MURAZOR={}", NazgulEnum.MURAZOR); +LOGGER.info("DWAR={}", NazgulEnum.DWAR); +LOGGER.info("JI_INDUR={}", NazgulEnum.JI_INDUR); +LOGGER.info("AKHORAHIL={}", NazgulEnum.AKHORAHIL); +LOGGER.info("HOARMURATH={}", NazgulEnum.HOARMURATH); +LOGGER.info("ADUNAPHEL={}", NazgulEnum.ADUNAPHEL); +LOGGER.info("REN={}", NazgulEnum.REN); +LOGGER.info("UVATHA={}", NazgulEnum.UVATHA); +``` + +Salida del programa: + +``` +20:35:07.413 [main] INFO com.iluwatar.multiton.App - Printing out eagerly initialized multiton contents +20:35:07.417 [main] INFO com.iluwatar.multiton.App - KHAMUL=com.iluwatar.multiton.Nazgul@48cf768c +20:35:07.419 [main] INFO com.iluwatar.multiton.App - MURAZOR=com.iluwatar.multiton.Nazgul@7960847b +20:35:07.419 [main] INFO com.iluwatar.multiton.App - DWAR=com.iluwatar.multiton.Nazgul@6a6824be +20:35:07.419 [main] INFO com.iluwatar.multiton.App - JI_INDUR=com.iluwatar.multiton.Nazgul@5c8da962 +20:35:07.419 [main] INFO com.iluwatar.multiton.App - AKHORAHIL=com.iluwatar.multiton.Nazgul@512ddf17 +20:35:07.419 [main] INFO com.iluwatar.multiton.App - HOARMURATH=com.iluwatar.multiton.Nazgul@2c13da15 +20:35:07.419 [main] INFO com.iluwatar.multiton.App - ADUNAPHEL=com.iluwatar.multiton.Nazgul@77556fd +20:35:07.419 [main] INFO com.iluwatar.multiton.App - REN=com.iluwatar.multiton.Nazgul@368239c8 +20:35:07.420 [main] INFO com.iluwatar.multiton.App - UVATHA=com.iluwatar.multiton.Nazgul@9e89d68 +20:35:07.420 [main] INFO com.iluwatar.multiton.App - Printing out enum-based multiton contents +20:35:07.420 [main] INFO com.iluwatar.multiton.App - KHAMUL=KHAMUL +20:35:07.420 [main] INFO com.iluwatar.multiton.App - MURAZOR=MURAZOR +20:35:07.420 [main] INFO com.iluwatar.multiton.App - DWAR=DWAR +20:35:07.420 [main] INFO com.iluwatar.multiton.App - JI_INDUR=JI_INDUR +20:35:07.421 [main] INFO com.iluwatar.multiton.App - AKHORAHIL=AKHORAHIL +20:35:07.421 [main] INFO com.iluwatar.multiton.App - HOARMURATH=HOARMURATH +20:35:07.421 [main] INFO com.iluwatar.multiton.App - ADUNAPHEL=ADUNAPHEL +20:35:07.421 [main] INFO com.iluwatar.multiton.App - REN=REN +20:35:07.421 [main] INFO com.iluwatar.multiton.App - UVATHA=UVATHA +``` + +## Diagrama de Clases + +![alt text](./etc/multiton.png "Multiton") + +## Aplicabilidad + +Utilice el patrón Multiton cuando + +* Debe haber un número determinado de instancias de una clase, y deben ser accesibles a los clientes desde un punto de + acceso conocido. diff --git a/localization/es/multiton/etc/multiton.png b/localization/es/multiton/etc/multiton.png new file mode 100644 index 0000000000000000000000000000000000000000..91106463d2b23ab568fe2634c9742a378e16942f GIT binary patch literal 10637 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 literal 0 HcmV?d00001 diff --git a/localization/es/object-pool/README.md b/localization/es/object-pool/README.md new file mode 100644 index 000000000..de69b1244 --- /dev/null +++ b/localization/es/object-pool/README.md @@ -0,0 +1,147 @@ +--- +title: Object Pool +category: Creational +language: es +tag: + - Game programming + - Performance +--- + +## También conocido como + +Resource Pool + +## Propósito + +Cuando los objetos son costosos de crear y solo se necesitan durante cortos períodos de tiempo, es ventajoso utilizar el +patrón de Object Pool. El Object Pool proporciona una caché para objetos instanciados, rastreando cuáles están en uso y +cuáles están disponibles. + +## Explicación + +Ejemplo del mundo real + +> En nuestro juego de guerra necesitamos usar olifantes, bestias masivas y míticas, pero el problema es que son +> extremadamente costosos de crear. La solución es crear un grupo de ellos, rastrear cuáles están en uso y, en lugar de +> desecharlos, reutilizar las instancias. + +En palabras simples + +> Object Pool gestiona un conjunto de instancias en lugar de crearlas y destruirlas bajo demanda. + +Wikipedia dice + +> El patrón de object pool es un patrón de diseño de creación de software que utiliza un conjunto de objetos +> inicializados listos para usar, un "pool", en lugar de asignar y destruirlos a demanda. + +**Ejemplo Programático** + +Aquí está la clase básica olifante `Oliphaunt`. Estos gigantes son muy caros de crear. + +```java +public class Oliphaunt { + + private static final AtomicInteger counter = new AtomicInteger(0); + + private final int id; + + public Oliphaunt() { + id = counter.incrementAndGet(); + try { + Thread.sleep(1000); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + + public int getId() { + return id; + } + + @Override + public String toString() { + return String.format("Oliphaunt id=%d", id); + } +} +``` + +A continuación se muestra el `ObjectPool` y más concretamente el `OliphauntPool`. + +```java +public abstract class ObjectPool { + + private final Set available = new HashSet<>(); + private final Set inUse = new HashSet<>(); + + protected abstract T create(); + + public synchronized T checkOut() { + if (available.isEmpty()) { + available.add(create()); + } + var instance = available.iterator().next(); + available.remove(instance); + inUse.add(instance); + return instance; + } + + public synchronized void checkIn(T instance) { + inUse.remove(instance); + available.add(instance); + } + + @Override + public synchronized String toString() { + return String.format("Pool available=%d inUse=%d", available.size(), inUse.size()); + } +} + +public class OliphauntPool extends ObjectPool { + + @Override + protected Oliphaunt create() { + return new Oliphaunt(); + } +} +``` + +Por último, así es como utilizamos la piscina. + +```java + var pool = new OliphauntPool(); + var oliphaunt1 = pool.checkOut(); + var oliphaunt2 = pool.checkOut(); + var oliphaunt3 = pool.checkOut(); + pool.checkIn(oliphaunt1); + pool.checkIn(oliphaunt2); + var oliphaunt4 = pool.checkOut(); + var oliphaunt5 = pool.checkOut(); +``` + +Salida del programa: + +``` +Pool available=0 inUse=0 +Checked out Oliphaunt id=1 +Pool available=0 inUse=1 +Checked out Oliphaunt id=2 +Checked out Oliphaunt id=3 +Pool available=0 inUse=3 +Checking in Oliphaunt id=1 +Checking in Oliphaunt id=2 +Pool available=2 inUse=1 +Checked out Oliphaunt id=2 +Checked out Oliphaunt id=1 +Pool available=0 inUse=3 +``` + +## Diagrama de Clases + +![alt text](./etc/object-pool.png "Object Pool") + +## Aplicabilidad + +Utilice el patrón Object Pool cuando + +* Los objetos son caros de crear (coste de asignación). +* Necesitas un gran número de objetos de vida corta (fragmentación de memoria). diff --git a/localization/es/object-pool/etc/object-pool.png b/localization/es/object-pool/etc/object-pool.png new file mode 100644 index 0000000000000000000000000000000000000000..b8ede36c5a47660b8c699f03f8bceee99d84985c GIT binary patch literal 8877 zcmd6NWmr^g*S5DJA>Acif;2{VRxp5?G`En>;5l&RDaUL1a8%*0btX#hviAkNcFH4g2E7=gXAKE!7o^+wdc!&2Bl>5(8|{A#MFSP_)GF5dod!9$Oh4lw%X;}l=-KbKmubja2j-^nlRKhGzc(` zi7!#j$`zXZuobKK1*I zZFx?r(w{#a&7r2wUjHFNn~DvXqpwVL(YB}glUqQG-QV)FHWPW?5(vb=!f0CBF5w>r znv{vk*z4j~$}1-(GnH3ipM$GYahU2yvB1{NG&-LK!5PWL&SLDkA}%cr$L~KsjNozi z;JMV3EcPWh1N?Z-%b)Yao*SHhobL-LR%gl~GtqCy^D>BCBS%jlcBHL7M0Dmicbhej z=DKj?s8`k^pE7fm_j3C^i}laEN+7F^up7gVBlzW}CrjhT#0!vP&RMfS=VJIOU<$u#VEPPGy4%lQ_d zZLmD&Iyuoc#M5%qzD*agbo~SOuwnmvTmt}hc;^vHr?3twjK7ndV9n({ZME(WWLwpE zd&iL3c~Dkw-}}VI4fX_o*7fzk`!h~0%hjTY`p~n$+N*tm#nCsZ!VZP!2l>~SgK8&< z2>|3@^wWh`w!$=i`yX|mzL_2qZh5d7$0XbYxifDq=V$ajr{!^N4>Ubw+=~dCAQ&;B zbVyrrVC3qSi@e>PyfTL~b5SotNESkPuD!n;duYY_ying_+3n5~E}i$& z8%y6|29bN5iwM`Ju9-xOX0|rIRwMfoUn8f>3?A?-F%>kp8cc3wQab+{gU^P9D=q*xlYw|dnVH!5S?Uw%Z>{~~en_bV#(;^z1rp2;z=tKF{+kn? zfd)(k&f{x~xbzScNQ-c@)%XrTv|W1m`skCA9#@i?@=iT*B~OY(ovnAz^Tw&sr}29c z1sHxB?Bc$O>Gq5U;-$?Yk6wj0D(g@Zh`n3!0u$F0M>>tW6Z8knox8;`}EIGJ3g0K;ELzw+ww`^pT|kS7@>9Z={^_f&t^ET01ae`+2_( zO&^WyL(=N+T10}WlwE)*IoD)$gw0PV;x4aC!Y@{9h4tNzs^-{�{S#)qtqVQ3p2b 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 literal 0 HcmV?d00001 diff --git a/localization/es/property/README.md b/localization/es/property/README.md new file mode 100644 index 000000000..8ae418223 --- /dev/null +++ b/localization/es/property/README.md @@ -0,0 +1,144 @@ +--- +title: Property +category: Creational +language: es +tag: + - Instantiation +--- + +## Propósito + +Crear jerarquía de objetos y nuevos objetos utilizando objetos existentes como padres. + +## Explicación + +Ejemplo del mundo real + +> En la mística tierra de _"Elandria"_, los aventureros pueden aprovechar el poder de las reliquias antiguas para +> personalizar sus habilidades. Cada reliquia representa una propiedad o habilidad única. A medida que los aventureros +> exploran, descubren e integran nuevas reliquias, mejorando dinámicamente sus habilidades en función de las reliquias +> que +> poseen. + +> Considera un software moderno utilizado en el diseño y personalización de teléfonos inteligentes. Los diseñadores +> pueden elegir entre una variedad de componentes como el tipo de procesador, las especificaciones de la cámara, la +> capacidad de la batería y más. Cada componente representa una propiedad del teléfono inteligente. A medida que la +> tecnología evoluciona y se disponen de nuevos componentes, los diseñadores pueden agregar o reemplazar propiedades sin +> problemas para crear una configuración de teléfono inteligente única sin redefinir la estructura de diseño central. + +En palabras simples + +> Define y gestiona un conjunto dinámico de propiedades para un objeto, permitiendo la personalización sin alterar su +> estructura. + +**Ejemplo Programático** + +```java +import java.util.HashMap; +import java.util.Map; + +// Enumeration for possible properties or statistics a character can have +enum Stats { + AGILITY, ATTACK_POWER, ARMOR, INTELLECT, SPIRIT, FURY, RAGE; +} + +// Enumeration for different types or classes of characters +enum Type { + WARRIOR, MAGE, ROGUE; +} + +// Interface defining prototype operations on a character +interface Prototype { + Integer get(Stats stat); + boolean has(Stats stat); + void set(Stats stat, Integer value); + void remove(Stats stat); +} + +// Implementation of the Character class +class Character implements Prototype { + private String name; + private Type type; + private Map properties = new HashMap<>(); + + public Character() {} + + public Character(Type type, Prototype prototype) { + this.type = type; + for (Stats stat : Stats.values()) { + if (prototype.has(stat)) { + this.set(stat, prototype.get(stat)); + } + } + } + + public Character(String name, Type type) { + this.name = name; + this.type = type; + } + + @Override + public Integer get(Stats stat) { + return properties.get(stat); + } + + @Override + public boolean has(Stats stat) { + return properties.containsKey(stat); + } + + @Override + public void set(Stats stat, Integer value) { + properties.put(stat, value); + } + + @Override + public void remove(Stats stat) { + properties.remove(stat); + } + + @Override + public String toString() { + return "Character{name='" + name + "', type=" + type + ", properties=" + properties + '}'; + } +} + +// Main class to demonstrate the pattern +public class PropertyPatternDemo { + public static void main(String[] args) { + // Create a prototype character + Character prototypeWarrior = new Character("Proto Warrior", Type.WARRIOR); + prototypeWarrior.set(Stats.ATTACK_POWER, 10); + prototypeWarrior.set(Stats.ARMOR, 15); + + // Create a new character using the prototype + Character newWarrior = new Character(Type.WARRIOR, prototypeWarrior); + newWarrior.set(Stats.AGILITY, 5); + + System.out.println(prototypeWarrior); + System.out.println(newWarrior); + } +} +``` + +Salida del programa: + +``` +Character{name='Proto Warrior', type=WARRIOR, properties={ARMOR=15, ATTACK_POWER=10}} +Character{name='null', type=WARRIOR, properties={ARMOR=15, AGILITY=5, ATTACK_POWER=10}} +``` + +## Diagrama de Clases + +![alt text](./etc/property.png "Property") + +## Aplicabilidad + +Utilice el patrón Property cuando + +* Cuando desee tener objetos con un conjunto dinámico de campos y herencia de prototipos + +## Ejemplo del mundo real + +* [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) prototipo + herencia diff --git a/localization/es/property/etc/property.png b/localization/es/property/etc/property.png new file mode 100644 index 0000000000000000000000000000000000000000..98c0cbe3720cdfe50bff3f047096e0efe2d74e70 GIT binary patch literal 20016 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 F`ya22I%NO= literal 0 HcmV?d00001 diff --git a/localization/es/prototype/README.md b/localization/es/prototype/README.md new file mode 100644 index 000000000..10e8ade75 --- /dev/null +++ b/localization/es/prototype/README.md @@ -0,0 +1,180 @@ +--- +title: Prototype +category: Creational +language: es +tag: + - Gang Of Four + - Instantiation +--- + +## Propósito + +Especificar los tipos de objetos a crear utilizando una instancia prototípica, y crear nuevos objetos copiando este +prototipo + +## Explicación + +Primero, debe notarse que el patrón Prototype no se utiliza para obtener beneficios de rendimiento. Solo se utiliza para +crear nuevos objetos a partir de instancias prototipo. + +Ejemplo del mundo real + +> ¿Recuerdas a Dolly? ¡La oveja que fue clonada! No entremos en detalles, pero el punto clave aquí es que todo se trata +> de clonación. + +En palabras simples + +> Crea un objeto basado en un objeto existente a través de la clonación. + +Wikipedia dice + +> El patrón de prototipo es un patrón de diseño de creación en el desarrollo de software. Se utiliza cuando el tipo de +> objetos a crear está determinado por una instancia prototípica, que se clona para producir nuevos objetos. + +En resumen, te permite crear una copia de un objeto existente y modificarla según tus necesidades, en lugar de pasar por +el problema de crear un objeto desde cero y configurarlo. + +**Ejemplo Programático** + +En Java, se recomienda implementar el patrón prototipo de la siguiente manera. En primer lugar, cree una interfaz con un +método para clonar objetos. En este ejemplo, la interfaz `Prototype` logra esto con su método `copy`. + +```java +public abstract class Prototype implements Cloneable { + @SneakyThrows + public T copy() { + return (T) super.clone(); + } +} +``` + +Nuestro ejemplo contiene una jerarquía de diferentes criaturas. Por ejemplo, veamos las clases `Beast` y `OrcBeast`. + +```java +@EqualsAndHashCode(callSuper = false) +@NoArgsConstructor +public abstract class Beast extends Prototype { + + public Beast(Beast source) { + } + +} + +@EqualsAndHashCode(callSuper = false) +@RequiredArgsConstructor +public class OrcBeast extends Beast { + + private final String weapon; + + public OrcBeast(OrcBeast orcBeast) { + super(orcBeast); + this.weapon = orcBeast.weapon; + } + + @Override + public String toString() { + return "Orcish wolf attacks with " + weapon; + } + +} +``` + +No queremos entrar en demasiados detalles, pero el ejemplo completo contiene también las clases base `Mage` y `Warlord` +y hay implementaciones especializadas para los elfos además de para los orcos. + +Para aprovechar al máximo el patrón prototipo, creamos las clases `HeroFactory` y `HeroFactoryImpl` para producir +diferentes tipos de criaturas a partir de prototipos. + +```java +public interface HeroFactory { + + Mage createMage(); + Warlord createWarlord(); + Beast createBeast(); +} + +@RequiredArgsConstructor +public class HeroFactoryImpl implements HeroFactory { + + private final Mage mage; + private final Warlord warlord; + private final Beast beast; + + public Mage createMage() { + return mage.copy(); + } + + public Warlord createWarlord() { + return warlord.copy(); + } + + public Beast createBeast() { + return beast.copy(); + } +} +``` + +Ahora, somos capaces de mostrar el patrón prototipo completo en acción produciendo nuevas criaturas clonando instancias +existentes. + +```java + var factory = new HeroFactoryImpl( + new ElfMage("cooking"), + new ElfWarlord("cleaning"), + new ElfBeast("protecting") + ); + var mage = factory.createMage(); + var warlord = factory.createWarlord(); + var beast = factory.createBeast(); + LOGGER.info(mage.toString()); + LOGGER.info(warlord.toString()); + LOGGER.info(beast.toString()); + + factory = new HeroFactoryImpl( + new OrcMage("axe"), + new OrcWarlord("sword"), + new OrcBeast("laser") + ); + mage = factory.createMage(); + warlord = factory.createWarlord(); + beast = factory.createBeast(); + LOGGER.info(mage.toString()); + LOGGER.info(warlord.toString()); + LOGGER.info(beast.toString()); +``` + +Esta es la salida de la consola al ejecutar el ejemplo. + +``` +Elven mage helps in cooking +Elven warlord helps in cleaning +Elven eagle helps in protecting +Orcish mage attacks with axe +Orcish warlord attacks with sword +Orcish wolf attacks with laser +``` + +## Diagrama de Clases + +![alt text](./etc/prototype.urm.png "Prototype pattern class diagram") + +## Aplicabilidad + +Utilice el patrón Prototipo cuando un sistema deba ser independiente de cómo se crean, componen, representan sus +productos y + +* Cuando las clases a instanciar se especifican en tiempo de ejecución, por ejemplo, mediante carga dinámica. +* Para evitar construir una jerarquía de clases de fábricas paralela a la jerarquía de clases de productos. +* Cuando las instancias de una clase solo pueden tener una de unas pocas combinaciones diferentes de estado. Puede ser + más conveniente instalar un número correspondiente de prototipos y clonarlos en lugar de instanciar la clase + manualmente, cada vez con el estado apropiado. +* Cuando la creación de objetos es costosa en comparación con la clonación. + +## Usos conocidos + +* [java.lang.Object#clone()](http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29) + +## Créditos + +* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59) +* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b) diff --git a/localization/es/prototype/etc/prototype.urm.png b/localization/es/prototype/etc/prototype.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..b23c6d1cfb851aae09846271f349435c7d39301f GIT binary patch literal 81144 zcmd?RbySsG*EYTZMFbR)k`|C|5TrpQlT5dwicdiPd91_D7qg+O5D5MaS4 z_I7)7;15b$K_y!q3ri2xg2 zP#M_qAP~4$MsiBFe|`>u0bk=7U#6fgImLkP7BYNmIg%+rDlJ>>zYN1Dr0s409C1r~ z(mO1chNg_UjWTEa<`R#**Pxl{;fs6w$NN=;b*FQw(Il;5c5MB`OV@ln@FDqm&&3Er z$BT%C*q5genuqw{_W04;_ILt{Nj)DPc9oP&u&^;?)`ehmJrp8v^eDcTMjU-qrj+Wr z=67DyK+lfkcY7Qs%}MM*^lAm!iR;wivvhYvn{+u1dx@SH+KTpT>Zl(X!l`-Y6wF+d zE5uw^%&)a`Wlvvw(oH|u+DG4!!Fewb;8)D2Kkr71iB`ABQ2nke^+37?Fde4RMIM4Mi?wZSPx zwTP}HSN17SuI}kbrX70Zvcus{fo%chM?O}m30N{N%wvn;{Kj0x-kmbZ?Gb#OKFqb4 z?5h%Vbz}L23{>6tGI=8TvI)xA%tetK(JZ={u_xKWpNU0ONWOV;$dku6>6h|7`f9(0 zcs{5@>$pigk`PS8*s~v8{7hURNlxRSo;&4jyTC4QK1d7ix6!uYYCeWR7- z5;+Wgk;cd$gc$VgS$#%wbh^GEVkXol=TyKyDWf=Mg{YxFoQYYEV-Tiu*+?ls=m7&p znKm8Q#B-I=-DVN?2P*p)4B|y$ZX!9Rc1GcvgBgR7`elYLQ4-m=Qt+`$hV1m{=__hI zdLvHh&A7cIih)-MVG*w0#)?G5SN4p)kMymcUyPTN>0Bo0NgnC(&oNIoI1+C8GskdP zWH7`{^Hp0IUQCSO9hfWKU&w%aHUFWZzjpw>(T?A-uyrAkM66emE*wT*7mYz=G}?0e z%3K&aZ9Mz#vvpCeCDyL1vx|UM3bBFhYN{ipi3LY|% zC6>4NF0-yU(rR?TymL1qKO-O|!kXc(emeE|=S+O;gGoG8UQ|6>2--FrhMFn$N#vyF zx{5VwmZzvM1mX#KC-7R%QDZCNq2nXP+cq6hVpQqZezc>0Zi-VT1#XntdFi8rDgjT+ z=-nQ^f0&n7I*j=uRAB3alFs-3isOR8$P|(Ou|emY_N80V-YKUx(-;?W2PT`{(@WRH z%Wm$|?(Qm^`c;SCcxH!I+D9LrBmDh`g0@FI9`gFhy}$i@5k<6t|Ho%f?xiFB|M)}E z&G<&|2PjX8+BLXcPQ*+p|6#~>-9Zk6FVWF!@UKsd`x3d|i~h}`z?fuVW;XDmku*-{ z2UZB3YISvWyLFfO<1+uS^Op|Ysd$*$0A9~;-A5-=7MGWonHd@2um3o@?ibzIe2*1% zbzj7g)6i_K4Wwexsa4u7OpOy9EG$1ieG$gKv0@6QDSfy zBPes51sP%1}(mhucTd3 z^nHUq3x~)AT$OU)WoBk(ENYK2G2R`0w?v}yRs8;?JpZ7VbGM(rCzeH-;OR9-_+XXI zYH4?;SUv&@N+#El2`05du4ok9tn1;U^x1k3Ud4R1QXla+)*o$cN!%`&73BXoDyF!t zBxbF#Oe|`JtrmZ@+ndw+SEl3Od?nYfFHbX%Cd*7_tL;p7XKKNVdLyXEfJ;xPnD%-; zMIq#Ioo~9&DzUx1d_1D4xjkE-RLc!~qaG`{v>W>~K4)YtMlbf&)nT7$SEfWlN`;)h zO1@MwEbZ=OSzx5iQace&ll$48_S?4zU9CGQsqWl$FL|j6jE*-(JZ{c29et4Zoq(sv z$jE589m}h@UmuSNCLvaQb9dB3GTNjfmrT^XOegf484OLn%KcLCK6Fq>YHr&>|x za=HT!(NIuQvJb3!KsX48g-WA_?OgZrWLr3d;K#QAKfJx0jB^#){cPSBkKJ0TGXR77 z;{=^%T{nDqh3Q0-%w)Nls0A*Iam!3GySIK%Y*7UW#VbGNHY-z84jP)zZd6|**}bh6 zTZ<~1*x_Wfw4T?h7iu+z@ZP*dIzL>^919N*_eUcis9-keP3s8C z3w+Vp7ob@0?q1P*SV7sH%rsF|8J4L|2gwnCnWKcVX$3@tFu zsyX%{hsV{vaIA5RlOi6c{bx53m*k2g)&7IQbWtNG;QE!^sQ*A{cD>d3*8&3fa4Gc{ z7i(B8X1WK%!ork0+e1m#^Po^pm#!7$i<9lHnPRV-fmGp=3UJ~X6}MNbyc4RSN8Q-S z&lnnL7lS!8-OovBU5^HYkE-1+Psqe$E3diP5+nC3yoG{r&d<&Yi!3tQ+uL9I6xl^w z&>dmqA*!uqdmh)vShaey zKI+Nz_^OJ1^i+wt0*kwv9@i{WA1r(MDt*LI3QE7&=YEackM^x`I+VEp;Xz4GyER_q z?Up8^@2-hOuW>b7elJ@(RcNAE&&q}PAHZhQ*~<>+?y9yvBcNJgu18sXN+yG|hSh`p z`5EJf8BBVO_*(fSW(wuv7qxD;*QXOxDrLr14_A=Qe^xdku54~jRaz~UexBN0>Wb>4 zUDSrJzdpfDmx@tNoT{)Gno8hwD6TMl>{-5baxh-)?7r^j5!>`?A&IqncGdSW$t^&U z7y=C=qHQG~fA0HU(_9-7iW=G>Ari8*%)0?2If}OyZ(w^8x#NOQ7JdZ&d-Z5w_1>lR zN%pEWj{9Ncl01%kTGtoHR#sL<9w97ad8(&lnjX{j9v%R3)B5=ATjF1@_9jd-wbt!U zLo4*UFj*aY`mn!rM$&dYB^Qh4vzT?+ z0fWPin##%k{=0YY2EJ-?EF@*@1^r}#KRRE1=&(5|e)ioEX~S1hc5h*EYQE})e zWbCHQoG7RMZ?BKa0f2UNbc7J{@_?_-l1^0s2hF30_6#`fzX3pu;&K&PMpib8PF*Ec z=n()8PfySN#Wr52gO7unHI9rPH&=6WS`H2lgoH^7c`Eqq)*m&ytZd+UuaD5SsWt0d zNkt>^cw8L;(*4v(WPZlw$bh>Q3=$36&r)BHSXiU&$uhmp@Z_(Gc`9}Q>S^HO;3_?C z-2oy^G>5$d@0IDJ=Ukw_3<4R2RjUEQ@kv8N0~q4swEmX%O0M+&aWl0l$fDW+32;QY z0MI67Y3NUmfs-;4L_rDpa36`)c-Zj#V0ml4Lu|P#D)Z~yzfvSwI7pFS+&g*^qlJeu z#8VeAs1;~fSRy2cl~*33ku7ybm;k^1cc4vtWcS_*@7;Is-2e%|ZgVt!p(ln}I6A+i z8`!w?Vy@Bq-|kZK&<1{jGGTEyc&JdjIZMmk-Cd{kv(wF0)gH;U-eUxWEcqNvbIHHM z)DvA+?Oq6z%5ME_9Ta+*EuUlguPBlQU;Jf&!+z_TlhN7U{J)p`{UbYEyJ31p1}2SC z;cIVr+*jtGgM!3GM1XB0+0g#^#>&!O?5&?wLp?pTTwGkJA8d0##ss;a5M+eU*vud- zYXG>zJ$UTL{7;Hjz6tEHK;+&7xZD#0f*tsOKJcX~B5N`DwaO|oAX>` zck;jg?anAjpauaOY+OM;q16Zr57#|S#Ui>hda>$X4@F_FAVVM-A9}C_dezVg2`&D5 zXoA;ZZ>v#~JOfW?PeMbNN#rss(}( z{AX&IE*dhnZv!$FRWicOBC1;yw(Z?^h1LTgO8Be>h1v`8^z~PRf4wTV7M_n6ejKB? zx|_*h&+UvK?5lyNPP3*z`pW|-tS{`J+w$JL+m=}Kp~33OBb<^lxv8ul+Ecd}1^3*l z^W>mm&2MCq7EvBFeAlvppVFtfI_RR`Cdlrmuzl+3j%;3_t@!Oh^A@7Ax_%7v+eS*n zewa;JoF@lbigQwPx^u=2hmb69j)mA7$4I=fVolw!nW?apw8MMvzot+a@I$?#Ss}e2 z_if-2Jo!)z3%q<7y7Rw`_^`vxAs2qBu-K1HOG`t-qWj`+F1hz>He7{Tgsc+R?z`z&#qU zwTS4gS5nT-9GUik%XhS$?o6Y_h}ZvPxgXRfs@zS!mrqFs+-g6m=E>DKyf{Z%I^8?U zlFC~MUuM?mv}B^HwuMeTU=@9ZV47~b{@$R^{A&grNn<=rA?APY#4U|16K~>VWbGZ) z`1JEb!#A2AHBN`uo!qx{MKUFSoO|hL5m_vz_51nxjgKoG?E4^LfzpSRDb8JaDjzv| zw56fL9#&Bm(~-x755rPJN?0v;cxhX{S|mw(Ph072Z#?_-z0So%;c(y4N%d5h4EZ{d z2y0x{?v+^~f$m3$h~fGr4<|DUP0Jrw0@BhlDzA&`#sY1O_rh+7f4%bU_!XLAK^g39 zEacZIMl%;CflY1a&Tw;7nk@N!S?i%rMKMk3<)|GzI0;32pJO|vTJnJIgb^O|fK@F1 zjhje-^Zu{QJ(jP2XUbd?MR+k2>p5Lc&m7uETm^)3Fstx(EhClg4DVH?3aQ0FsMN#0Qs#cj?LVrUh%i zh6zj^%fn9-z^54uv{1hHg-He>_|r^FIHUH9(mW2N9O7|05_TkxNoCBHG!ld|X{m@p z$fxe9ZQpA+bOy$|4~!Soa{4Ak=%b(UexXtG#PMYqPeLnsZ~}d=P|N37%bVto!5&2E z80Jbh&iSBMljt;Ss@ZY_f`P3?0v;aq=ZC^WD(>!eM<<;T_<5?Y_V)Ml8L8}({xxE`SFoD_Hn$}k?R92?Ho?Kk_jopU88 zry9~1)O__=>)(+~O4MGDW@do zA?rYvkiIB0ff}8kAKHMu@bh2rI$E0cCF;%0IE94`k;Cb(B0rN%j9001l{r5kHJZkv z?;Xig1#B+A!h-zjY_XS7XYj#ARn)D)w^Af+#+{$+Ys;_q$i0twokT1zh9DfyT;iLi`MmO-!d|o z9gbN`=}5Fh4kEB=p@M9a>$BAfHyiutPv?(GLnR6oced!u?YiNm+ZrFJnLQssOOJz9 z_R%Klv$of3C{=)w7=5g^jn{B!?@cvF{4KZ=NBSl&1x3hj!y+NWZvADpVMoe>Gp*NX z5bdZ+wK7qP0m_&0_(mTjRV4I1z>4s?%1tL)Zmv0Pu;DgcPH1%e4SG$}xIC`yB5U#4 z3cD(;t_7yj^wuT1!YSR?WyGwl1#YfpJZ_v+fIQI4XN1-C{)sx26$OP*5=ph97vyak zQS=^cJf51^J}#YBhH^mK&+6Pb_ncBvv5J?YqXn<*LBPNx2f79IWc!sgSDsn#Bt8x2= zSos(LZ>z$o&{W@#04fW!9vk>l^E6?db$uU->%Ql7bnz!&sTCz;g7Mf5tMs~@)mj@a z>TfVQnA%$D@>R;X>UY`*Q9L&D$_LGuBI%RllKCkePPt6!=J)1DN|7e8@6Ut!4#dYC zlZa}G{uA0#i&?gpw&-`ebUp0xIIKTkG10ifSuB zHU^rDbY*f#%JD1aPwb;q_RC%t;(prpKDl(=*yH@h2f@Y#T{9lEwr)zbE60ae?Yr~q z(#a}6D7y^&m|EzR3kwubph>WOr)nM-Mh4T>5#L`CVzLUw_UJLvEGc*7f8JuIErerJ zMw?hQ_Wkr8DooKDw0Sxp441YZ2}!K*-O7Q5UyP05zqjF+gGzhK3x~TSZp%QNuY`MN zpdRcO)}UIN0pQD5eGR40Fs}!5pF-3#jw>j@W^wG7J9uU}j#_#) zp6M&LZ#2bwJ^K0XCl2`jwUNt}y39v#Ni)^OeKhfFq!T5Jh9#)SAVfbF;EBg2V_n*L;iIv*nfA}kny zj>l1Yd41_W$R*Oy%0H(|`)tm5JK3=}K6HEPb~m8+U|BR^1|*{hb4^TOD;jPt#J(vn z7-#KxzCL)s+_$8fmEi%9+qae?hu9u^hpo)lf|}r*~&fYt-dG7 zoGZx2WBInn8~G+<_CrnGF}p>!P;ZoW{<|>3eCSDLab5KpF`7j9arUIENU9J^7T0Q@ zMX0_#4?q>ttxg?Ji?XE3qVD`H8G=92#S4vuHvk8fIN<$ei15ytsn`UCP9xRAn;k;Zt$e~MqZdIqf2`i;u8aCdQ@jcJx;ZUGROOe^e;CL z+2bSyW$vGz>_;l>ecYF2%9|6hfp6KKdgyjxOCgi?oYB$p)yWs_0WBaRx0RbJ(`)k3 ztC$?FNKKeAWszN6tN`J%-(~kW4f(<2+_aXsSEtgrDuv(ZZ$Il1b2t;(%~&tBHwvBT zIS_&4TN7y0ovv1P4Zyd7w^{j|Rx8zl%d}+2(>a0f%7^*>4$0p_UOH{|>B%*8Ms!Ie z@r2jb+EQk?o___dNymg^60Jk4tw;dpN<9U!vL-jDDWQgjw=qEZ6|h#2O|^uBb_S6= zK8fS*L?*vWl2`<8hvh5yVRTxvtsKe2QK`mcs+?#F%b%mMsXJ5BqCJfKm1@S$4X#CL za-HLM89^*soVKT%!w)mcC~!s#G$YjW-gHMZe!l1ow;3-a04Xlz@ymL*Ivulz$Vg6@ z#njCM8KhHEeFukq278nqSD|vHS+m*lvQ?j%ivYI>lLkp_eVe|1Yj-3^JemJ~X9P7W z;q7dRz_=1ZeC~Z=Xlw~7Iyt%UQqN}N&Zio?%_|tV>Z?V;!UYo3Y6btcV1-7Z_NFYHQp_9(b49t7vZa=={OU z%~(O$Zyl;0bg8#o7Bg!N4Um(h`}(z*U*b8xM*TH(IDW;>H*RYxB1!-_X^-WBWd@sX4#ET&3sOYN^b zF1OnqW`7{i&(AYe!*)eUQfbyL9j>mf-K$e7;*X+l<94*%D(TDEnW~5{*}6aZ$%hMR zB4XZfh=8*^k`)vWR@w{w$RCn3)5Z< zrR0x*^h|M=)A{B_X=x{|1<>5HYgv9PKBHa&-O5Wc@L(@6 zFS+2k@A{Mbr=G=id?AyohuNjYwJB}ZX#Jr?Cea&>DEBn{ZtQ66Ka72@>aoEqEcA)R zM1h=08)HO@g9K`&Q?Q0;t__v!Z~BbgoV6Vsq#n=dKsRcilk_kavl-9iA@qQ4vLZf+ z+?;ObzrZMOC#XCr5JRwtLws}aluD&I>t%yKI~KGjHPp6*KfA`2p7rLlBIV3JI}+v* zx6^^BNR6eo2>_a{pK)Dh-rBb}34$(^vKeRTqKujzwX_Tjb7Pul9|@Ih3r7mS7!X03 z@XRIw`v9y@(0@3C71*?EO>JkQ&VcC?p7AhSNTU$!c>V8@mG zsrK`~9Jkmet&F9OQ@A^{xcm0JZ#_?SRkq9RaHX!Y(vnItUyc18yLH;FPYgG<>G{Ds z461NzhrVXw_4(!;%Ka{S-kUaF<5$LVi;E$?xBJ3R4JH~D04oQq)Uwnlgy6bK{P+X< zO-$>On02l#Qen{(Hf5w>dlmy73ZTiB@cSTMolJ$k|A9C#<%<%6MJe-T=Bvy3s!4~6 zqSEWLpg-tV(%XD@K(yHgmi|TLPzv5hv=HV8)JUmD(8no9OwhzHO zCo_RY^xhK>2ITUix)a{EYHusrD=Y`fkUyE1=T_~w>6vE4j!Ti%S4Z-0wbCq2ftH_3 zOMaf7OO4U6)QVqxti@+P5OA`_6%G^_Z z%o!zSGX2nWi|NO|xE`N@)+)#|kB3pCNP%5JO|{r*KYrZ7ZzQPS;)>>Bdpwx1%poHo z_6$PaT(}mc9||$N8BHP#!f5(sPlLWXD#iSJCeZcx;Ck5_kWLIs$nL7$rhG2=v(bz{ z9nI}zj*%Tx$;SZ21MB(&P&2$Z{Z&c4IRaD0FLdG#ombNfR#r6)M^|lFlLGLV9pWoO zDqhZPXAROWx3dD8Dd%*qVaj4Gr@Jn)AFOBN(1(VnroTNILz95B3vi;pgZ+-*AZmxR znXB>7h29MenNJ-o~adxq{F$cagu2@{l3+b@?*xxq!m+=Jm+(h4LR9d`5OvY#te3>gwT&jqmV#PJYTRb zs=IYzf^{LNZNCKT@}ipK0PBLNq1`2CJJ@fBWj6qY*zHZXQ-#~c@)KfS6}0ulU8XtZ zegK#lpzf5rqiSGHiL!+#z#yvC`yA;l4(ij1w9}LB#LAAcA2G~0i@ zXG^t)45;i)K1jNsKs$lk`3S)Vo;B=(i#>U|A&bndoZR0)MDJ}tfXU3RVOygkUCf); z|F4%1T*Te+3L@x1Lxnz^{e9wSQep$TfRGS!=6G(G$SX_GM*x*J-2DPs5`JRQim;ie zZBk6%AK^wxTo)wwIEB5xL{T#2k$Q%i!RFh;&N*=dO#v2uEVOGL$tVN@`LbQ;LXGxsH#Chq`YdsTNMABy7^4FptQzq>Ek%n^vUR!_NU8&D%gC2gO_ka zv3P6~kLQd<;rcco$Tw6mR)X{P{Lb(k=nExbo};s-&wgsC{!-lDS?WPGW}%Gb#uY%G ze=Gi$5=i%7cKf?y~4Kd<(Jd!xsHNpsClL)Oh>QGH*yaGDNX=3`|R&- zG`jubPRxa`7#l62MsYQPRU68`lSm(i!U<$p~&al56FklLXnX*%wt#T=u)=$%?{hyzZoW zigQ(6*6R=IUT?g@ymDar;J!WHK!7x`FajBd2=XDffuXG_pO2T$aBPT#T!3Y}KV8Jjq@?i@bUT(^B`CGdlPI3MES$unGc(zo=^Wf zh_Vk%u+Lp5DO%mmp5E@OwXUk^a(+sO=W!d!fwPNr$iTm)^&;A=!((sM!JdFhXS=A( zOcyDsxpK3^^rTqA^j`~%ilTXr3!_CC)r{4C@y`PdZnS$LIQuREdj+}foa`&6`Ok4& zkQo3TFC|slfLhmah2MC(Z~; z_@o|z-5HvN)Rq*MOqMKjPLN^7H~8%MYO(<@aibUw7(hvyB6tl82lxIxW>E_o`6!rt z_|er>V!d1pb@1qXx~}WbwA!^glKdu&)8VlUVgmi~&h$)MTihU+tP-NM9sD7&`Zk0x z>B){C&&5($NZS3mRb=y-pICTmpJo$CIw26tUnFn@g5W8HY(uk!c(f>EKdqQ)aFijR z65|;;ts*Y@dNk=A#Oq-}JP0HWZGZSE7|0jW zy9^@-_Z)%)3ii9;7oA`!SK3_jMg>~}rJ{^x5fHcs-@)$3H#YiF+$w;M3CMY7Gc^QT z3ty}4sOeQ+2B(82fS@qFZWkkCAeACrPGVvZg);122TtmsqTTf3{(rY1nTJu=k-c8} zyjBOJXlN7GmnT6ETS`x{uzFDzn2T;<#FBVk0$SyAqz1JQqF5eGf5zdB!vs*G=Srs%t7d2{D{7kQcL6bvQmR3in;TcU_}&V#C-b+Z zKf?E~_M?6l$sjhY5#rtaQGdRADj0=pX{9rtsmZ69@<-eJ@B!B2jOb>fqyTVp)w1lq zK_KEwI-Z^NCfrKrtN8=QC@r${v&s~wV09JQPp^xt?nLE{3d8@leybmoZ*L8>nrr=>qVGY(758gfuA1py76=iFV_ljFt&2w_Byj|tZOkZ!<_zls6 z7K#wL!pJaG7cckRWhcnzHe@>ijyKQ6wJWdPEK=YeC=|P(P1m|qf}WMhs2JAFV+tZ| z`3S1zwV}U|og%!efAN}E-!IMxF9y~e3hQ_Ejy zr9D6|&H{n`hT4pmGn>!m4~JQtz?5u(J<$t7JW`jbbk=|JDw7BJo z8un5^i$C@;X3(wq5}qtGt-$|NiA5G!pYZ!i%3$#2F)0%iVI)@>-$+8Z&}b+gsK7wA z#%0M4jjsGentg?$vaVXm^gGQRO^xt3#I)+rl0%73V5gP34i#W#?8&;NgwvSs4WfTi zZDszlE|3M9xmV0zBoik4)82_Qy>Q#uPKc5LQ-xy{77tX&QiBO^ALABi7QJWE0~2+^ zMelv|`v@9GA3eff-i+%LKe*D4FnC^)u@s?r0NQ^m6|=!?`C#V2_l}~b$T)X02RIjZKfBsy)n#86cmMgFiAi$x;^Z>y^x~3^V^T#SCQ8~ z3Ix22i`)6qW&ZgdMvGYpqQsvEtrdd6*Z+pS*w$4KnZsARoIzy}H%Y2i;nV&2QO@%@oVb2Rl3& zZQ7RGW8SdsMu3#~a_VG`uJr!8ei>hxcfCPIx2S1tUys1=%=@}S2HGRT9)>PT>K4aOSEq7h*eSP6~{axAKZh{*zwDtuR zrIFkE;EyzRr!gLP*AE)aO|9tk8oC?9L_fP``7eG{n8iurrWFrRp}!JTwO9Cao12{x zvY$|PBW~8$9~~hjvX_KL&U)Mi$>(HPBhnEsO82^+*KpVx^7H8W7n1?7HnOzD?wm*w ztff}8-(yebL4`GleSpLsBYT#t$NhO6DZKE@Dr)WgwrL|Wpz0vHenU{YI)Dgggf${d zcn*b3b#@<3+0iUEe;Wm0xkVrbYC?sZIxY8g8|oMSrU+8Y<*@0UBTIh*0~t^g`%GHD zitmrot6=W3V8>GlCIbeuNhmsw{q{wg?mG{WDi7Ww(30usKn0EAWY#z^Cnn#d)o5M; z=BN?vq4MRF((OP8_k2Uq7+5(%+DtPd$q0%0>#Y&-wb zsFnWZ-s!AlaYd5_(ZxcAIX;C{!)kwW9{~@SL?aH7B%pi%Pc}C0-@iZD6wgkA%bH7o z!x0b(2FSzt`eb=r4R#sBur~2 z^3ylePS1+4C_syq#JPED;sZ9|kC0~}zcEAv3WD?KN&lNUWZPT`sI_%{##d>pr>nWq zjrl^>mkldt*7%E(!lIdvhS{*oxC^=OWIv(s75G2Uup=G@2}S^^?+s;3zW^~=yB%!>)g6f^)NMa2>pp^$y{dBH(Nx4U zhHqUUh_V%ECA;La!&QskA2fKW8!C?ql1t=*D*;#YzK#cQWw~3}Zt?LCzc2VoM`!WhMN-lE&Ng&H>E~3>+(!=vS}Z zii3E#!L^%f5Q(T)VB8ohPyxIv`AyP3<=uXxDceE{@VTo`L7PFU(a=OgBQaCL>{kmB zBswL6ZK9CtGAc%^M-f4+fq$NOk#_UeV0z#q+)?jH-^be$UAV7$GxU_PNMGcpxRX0= zT^!en#}1>PPzsVQ-9j(U_Wdbk;gN2kofhIQNl$ybF>{x7*HLIUwI2ij*P;F8|E)To zINsB?Z;*i(MU6O#4QpzJVm0z)&UVrCeZZ#Pna$a%ayYPe$9s67gT}Gu{mAEd0Z77drIommI1D5j4@fd93itSa1xfc^ zkX)LG1a;28=yhWBRxb&>)4vKvY$Strgn43}+4Q$}TJjiYTXxy-ie4FuH=T8G=G4}K zF#zs9hC&LFNQUEhuf-?#Q854%903nkC`cp|8?JM<-`|_x2M6k~)-P}oD*Jn*)T&!l zf#>2BfjR6$3h^@?lWu|Io5XCjtLf3Rt;G#f6F%4*ezq;IW1F74^u-?YBsfM<%!7d* z0}`R56q^Go`Of{Qn{zNklL+!pyQsqsp058?c@MpM^|L$-Ox92JExRrLcE=m?`v(WP zYE@fcC_vpx&0+ki;D8;;3k*+YZM<6Ow8E{D@5;%0X#(7G+&56-` zjE7ZChi`7KTQ)|h!32dAwdG28D;SD4tatEAN}^{WE;E)-83PT`mLEQcHt@*4JNS?< z^1q9jZ=v6OwTzH$Ou_O}*{z-$V8l=5H#`ofnNI;VNyq=SCUHBFyagiwm*>}~C^rBh z%!aezRl&U>Lq5KFQ2fjE+Hd1Xi`X9VuP;7WTxgos7=1M>AmTud6vwPo=Q_AIUrPlt z;?+63dvAj$IE-S%JGsypa*vPX6Fa8;{R=O3FNFV9{QyuvoIvy?gW=~*-IqNu_yH#9 zwY%QE+nliBl#ExxLPtLX$+j=i4Fi-*=JWU%WqcgQgt*X3r^D*OZ4<8^Y%XWppKWa} zt)I2Sn^urNPjEuOBr2R!eUK_ z6Q}Vh7_EAM;wc=m(<8JEq(8MRDK8e2j43PG=d1?L#k6hUTeto?i@yrXM*CWz$DAN^ zcb^7gb*eN0m1OTpzxTf@ULefqwmp}4FcwbS)2hd6u($A|3Jf?ox~%4b@w=-thw&`# zBE7B}ne+fm+KpE>D=znuZcc-R0DKz`re#D$WvaHSe@efUae^=2ihn%{JY&vq=NU^{ z#3u>ZcEmr%SiQFqb3Y8<$wUx7UYS3%1qR4})FB07Ft_%39`tr)Gmv-sll_lK;M!-v ziKhKzbnS%zk!Vh7977l5)5P(?*ZafG_w-k+&tR2BqxE_rAcg%8P6lRgMeKjwU}|jdLeB_V=9`#`7sB25RrICJ(Q~{;%ISj0*8I zxvMnZK<+7f{jPkq6rc0|uVTV~1Z*7G=fD!bL<~46EUHLkLp+Qn{BNqy8e(QaO)K8LiA9iCy4ETOw1J)KI z9%4MQ+9O8-h@Dz?@H2)dyn3B;r!$)!cap?lRY%3FP*DXwC#yQh*0vbR$P`o%x?liZ zJ$Nurl<=GJkf5;FO6~bz0&~_CjZ*ARVIv~ChJ!_fLRY^lckx0u)cDOp~r0~)@ zv6zL@O)y;~TB64e3N3IWL?yPjJzr+RcRwB6Kgt0D2e<%7asBoW`RQ?S&UdL(hWh@@sm`i4~0?=qnU?Iycl&muo!tc>NA`++Slh| zWzr^&QV;!%<{P{sKxQ330K<{gTQ)#*UXh`{d8T8lc9gFcornCB+OnN1c?ou4-P93hAEr;5brvsc|V(gqnPtTyvy zT2-1Kvzym=rfHU(pgMt0!A==veE5g1sI+X2yLw-LL*Wz9WWnaCQM|~^eAWM&(?*|! zw*K}8H%CD{{XUp#66ucW%X#BVc9%DEq(qd)qd}4oOW^p3hF6rp83q3!D!H3hWjOVa zW1`#EU8&l(2#ACf(xcCgbleU)gi~68EHj{?1hdu>=RTXrtvYl7xG|W+GjRG$PX*x% z(5_to96SpZs)`5ZUKCP3-hwHV@hJ>yGFjx%PxPGq6KgiXG;x^SPI3{wE1)Ol4mIY| z(_+WBea6g^*|$NFh>k%3u#8b6LE>2eo7b@safT-G)`O!C|K$+PO6AVJ2 zxwWJoppsAcyxa$3LJ~*W>*^F!McGoiH|5Z`jN+5L;o@9Y@72MC4Hy@uR-}WvoMzGt zY%kAbNQBd9pRjw=_Z8$Hy-RW};T%(8)EZkxFoKuZIi0&FU*Ue84FoRK#x~x#_K&+AK?y{$Izw^esBub7U?9~z)Z^^6D|4vTlx~6&gY~v%P!7MI^B{u66qR5 zMvibA5VJbk?;CE8Sy+2&+}JIwG(A6RUEEr!ofyc$Tvic-RB*rRnph4$;G(wp2S;KB zXLIqzz4J|4YKbfgR*Q!h*4IUAep^I0{XA%c%if58ih)}Qqd6#Z_A;R z`|b6Mgz-D=vbKlqA@*DUEn3d^^*6D6Z85!mYrb(Wjh^6p80mMuS+#ihFb5QDqq8v9rONV~s)ISi-w2^*%G+E7Hq} z0PHQQZ7~s9whnD@kCx|n_9Hfhz*2jtx3ldL>Z})5@&Rg85t2KV-)?5n^`QQ`!_i6a zB^aDeqoyLFDlv7~AI*b9A9{>`AvO+p> z{b^xd(a1-cSp#)cx->bEjKHbd&<6PlX^5MMnU#IoU!vpf#`*~1W^)!tDz5k)vpNaZgVW+a6 zc4AN2yBdp8Uyq1%=$w$((+Cd}!yw?Ti<~5olynd=Fw0I2sqb$twn?7Q;4deBGulVS z+Z3POOuM8jVe^xrPcXs$qv0XChF|U>JJJoYz{FEQtZMm^kE_Qmn1^^a39o0kGzI)j zgDit*1DS>KLlc|c$v)F%;8@918IcrI8v@J|D3HY&U!r;3C=!-ez?JJdN1z5P5z`K> zqt$b8zMra~Hy&D%k31ODG&o%9=s7@O9-80yc}{2=BayBfl-yEkv>W_vAkcj@`3-bv z3N*)MQ^n{mz;FbOw^IP3C$)}J0UJ;(jj==fhZZccuPemkR-|ZBmSrAZgbzA*pyZ<-O zP)uT;;}sE6>2nVS}l<_Zp7`6DKBB(Rv@>CKdbL1#1-v3zgf`eLOuhzbP?ZtcbL^6*k;k**Bpqft(tmGHB4i4gfGYHZifNDdZN16zy^q#K%rBWz{azEw#`Ft zBjt29GSYFf*g6_fmXrqsr@`Jdpk1;>H|;yvM?tH){vodah?a&c|baRw;Bljcvy-}E?aLA|yg^`$Ty+(81}sC>=Y zDWIVrdpWwBZh}cAz?(6H&Gy;Pl`%O!v5J$SmLf??o?0)9fLmqmbUI(Zfh#0ew?ty{ zau7A_X6GM9*)URFejj@=eIL=&Y4U(Opc)v|kr`!Y^MXeIb$$aHx{RyRdQQ53#$tIq z6WbcYq?^Xdw}V2in6KMyLCc~4b$(%-TeZ$*Mn5abNO?LdRg#>QLqoN`R77*0!b!tp2;hcq(-l{xw6w4s(F%cz$K7F~1<*w- zDmks5*!7fi+E?A!a!MEFma(=MjqD;rX@i7H-!~4}qiEyKCQTl(`@F+V5B%)@s}bbL zQIN{~h&2S<=caRi`Q_F-VvDuPlqv$V+XlJnv+C^Rg#q=SXPH-PJvSHqWG253P;?5PNA#WLEUfB2+4Tbs zY7wonjU{e`Q&TMnG=ip(31NgXnaNTGbDac0CBw z;Uv_LzyPE)MUG6mnm~&h&mri1W=P;aefErRAQiBA;F((Z(#IhJP&QXb7SSaSb41~z zlauXx(i7p;v4c!q_E;6BF~S&L7rx8}b&7@G3PcvZ%i_kq{QmA*eiFy*BWZQ*S` zCyH?!JaMw(_6VG}a>pbe{ZvPt zu8N+Vaj=j1%DMqQ32|A`n2<7|AdAeg1248_RDgsf<7aO*Im|k z^IX&ncy3otC|$ii)?^gPnBA@)NAS&Q$xT9VZyDSE`)JpE8JZ8(%Um=h|2o*aNR4{; zhnD`Ewpt1BO9n1RG1gH0#KF}FH#0GSi)~uqd?mYZ#T16ci98L`1rzJCqLT9uVn9Qd-IY>5^8ukzwct z=^jwJySwY%1LyqC`N#WQ&-M7hOFpPGJMLI(-D|HL&_L}`<$J*_8Z83=y`Bxc`gBu| z*b={fo>yb{=8^}pT1fWv@mBd)jFsp2;vXo1D27|YHF$gHb#1i#Xq&Df>}|7Q*;nc} z59rlQ57+T5C;Ivn2a&3b_$Pps12eCqc@C_5osK|8-!uWOv&Ens3`Yb8 zj#c4eYo45KCh|nCs!;kER{S6A%&UjHwoOF_7Hfa<*Ef?|<+j zp8U33Y$ihV(|~BdIvM_|4`{HN=}I_83q^lVE%OyvijwpP^A*fXUnh_{NJ;Vw?oF0a zXWhl}U3A44X@3>`&zv0J0U>L%r;c4?h|s2r6gv`?%r}podOMia7{D}4&3OA7K{Jt6 zROigBcpAogLt7?v6+r8of+>|hHMIw$9&+O5@#+L<-|2mfW$vviOnM8c{KdzEfPp+> zBo1BwIL4sb7HDj!tW3dmhuCd1B#TSg#A0vG@VYd@j7N3dgkG&E*ESqgDQv%QBmjZ$ zAtl`UpHd1D#6SG}X0)(=9UKx&W2SiCQyJ@T2HlqG7oS)yShZauS!xshk8Qq!1QJrg z7tq3E-@0dr@^8G0dn4hNmv&KF+JRBWgG|U&jhjXsW9Q7(oAiq<3U@_F0FZp?(aDb>(8US0UuBq(4jD57c4}B>YR2lRtuy_(_@6xKkq7y+^36 zSGCYEuX}%5oe9& z{1w~9bzS=WWN9Td^b*iRpzj8AJDy{uCt#H7;fj9l8^*#Mz*bv)tpS!& zu$PQt!xl0)h70QHBpGL(*`p$G7wP#m{fkpo{}5&q9-Du3K=~s9EQI@8Q!Y&(udD~a zdd&UU1u77!0n%0gAA=#*;hM7n&|4?+mi(}p!eM|=ZI6f`noRX{&}0fh34C8BkyYW_ z)J-6!ygV)rN+m*q!KecP&GdcJ8ihDHLP`P4y9`UJj(`gYDmns)$-L^}$_-#5ok+$s zM10Lo&@|gpKE+Ep~h_!yDE?WO*;3_x&S7D;BnQrntVu= z(p(Eiv7rWGP%Q(F`98LF;lZ%#oD@l?*$19?y3w?n)>^(B0h{S3ists+f+jzonVD5= zmsJ}(=TzoR6?Edku@cPNfXfL^yaAAvq_8XjA?WgYA{}R^`|Phu*Ml68Ac0Xy^y@T@ zm-LJOh>$u!_HsS4-kO_}TS=E8ntQ>7YdA(N;OU;ClAQv|;a;`ONHC5J>^wfNI>~lD zjUwIg4pEEcvT^87@$~k-bxxP?Y`Z)0tRYL$rpSoyp~rqJxs)`5!$J2zG3$E`nvdG= zG@09-aEpJC5w{a<$+}|%E#s@gspU^z@q`Z109s_DfjtR_lzE&PHK*IST@>H1fkWBv zyj$qN0rQ$%*6Rz(jZLjXdBne>#Uu{EeA%F}n`@;quZ1%9-u4Z-E`|x_roM*&DUxI- zu=;2L(@rH@!OA}udJ<)_wfPQY(4+nX(87=8{ng=}3^&I!2f8bq(-y``6pLiV4(KKiSvc#0o+3?hqH4(aSxS zZXRmlb@cHcNOSMunlx>~-}<*2E9)dJu4@*34!~|o&0r`AH|CwtEpv2oe(vYvd_rEw zfP@F8RNDhdut2kc$#kS5iy>;uSHflzjiIc@vRmLXY)#e80w5?ejpS`SJ_<0u!l(7& zcd-lTME3!Mi%naKuu3=?n}4lLro5bXX`aLw=$xCbh~>C7SED!My&c?#wP(uidF*JH z;ULB=0Ih;cPL>(Uh~*9o1k$C?ht_B}8AoOP(b+_c=-#EtP4j@5X`y^3dji13c@n2k ze+i(IYns>K9R6j(+0`^S1DM`4e;#{rPD>2|FsI9?o~IEP=d@8ZH*a~eR(KcO$}Hjx zL=xvPRfy`PwF@RhTw{iL!=C72M1!z;(WgkYH(;Yu>nkA^ z$hJUH4Cqw+%V6~WMOckLe<7P|d_Limw#QpeXDly4onnUXyIu7IE{oYo!{w$g#!~Z1;1!8zF)kVqY7ChSLCB=l&}6vLVOo zs%Py_x3rvGMs!jmSDi%vsAF^A^!H;TZ~~<) zzsC9@AW8w5;as~)@mgM&{&vW`a|&-XDw=!}+g-zfR0Bi=bt?E>jv{YRFNv-ChP>z&bx&{Z`xzdL{8Con~{J={CO zsVEw+3U*h3Nb>#M&cl@%z+UF*@T8mn-i7I;OIH9)8JA?Z`Ok!ul@#_5rQYzVNA|&{ zL|QC$fA0toaVCd_f${S)vjGy<$B%ds6g{|a8g+8b{BTB#ose}?+E4eaq{p<|_IOjv z?poaPsRo)LTtLGjA+eC%P?3W#p8hEQRR7T^JAZ#?CyCYIVfs&f&5>yJQi=$xavt_m zyZ?4)SQjHNoun;hs%6Vb1pq2iuW|!pL*%oEw#(2_B;5 zf*xIkbCiMnIP3i_&HX1t|7oR*&HJi~D5@b~ek5(=vu@2OyR}Y4o+O%IrRKhYnE1z{ z5I>2K3ui~rfa#NWO5)o5gK;b%(8CvJZ5d!s+OK>M{z5e_eWRx04wKRss&j%%67mEN zl>&goy26gi^TbFf<{g<5usFEv387mIv(^msI;0qnHnYIb3v^Of9*v;2bWGSB_Et zQAQ%1PyiLHaZl%ekw%Jjr)jqo%LS8Nq$p=*FiglPT^Tw5sv&u?*!@_JH8{>T3ax^r z_W14dD%lSbH?lsDP|V-y=`z&FXfZqc4uuLo2ElbxC*~yTg9|H^TQ6`Wj#? z+-BkDRf`hD^O8%Je5#+lrC+{wtO{MdM4lN&`FN^PWQ+#dlQzMa`u?0~3P z5WRTKD3RI|`}Nj_5~{E!?VYx;-V;|7)Md9Q znwj1y`&dVu^pakFZtEvWCLNItTQx%wjIFKA>316SdZd1s0SF4NYWPk^QOsLjsPqqB z?F*%O685Y$P*tY6Sc++Ud@Yp74Vbx^%o{0L76K2z6*1FL%SIfUG;FR<;(9Y0JXwfJ z=yW6J;#to_`;JQ|D7fnkxh%er68kOPr_EjcsctetaG#%#pIccVf!T_TB(~`nJ@ac` zoWoo&3*X-_4d)U^`s|6rXd<(=my$ElaMq!&2kiPOhrf#h!KkWoNHw77bXp)$*=4Vy z^y0d4Ziqr7bM+TF{y;xNhAYEb$7u8}LH)OP1ZfbNn*|q}D9mZvWv*WtGws{dFw`(` zY@>@9m2-=fx$QZX}OFUn|(dh|wqL+zJKEW=`vMNKd20`5kN z_0abA&O~Jijn-gq?TWcRm+a^tq>tfLU4kalN~T|R)C)H|V%bdA{$Rf%5T9Ee5e*^B zAAezN0c7KaHDmdI&pPDhe;bL0a*yV&*0&prr^e!?Slv!4<2B|iWf)n$u7-XTb6=fI z0I>hMIECdo=w`B;*#5ica5~z2J(9Wq($7EW2S2!tQ#{^~>^SD+m~Cm*m8_b&I`VwU zk>yvXJ&C>yV0gL&u*C=a4$htB)@25*8P;A1Bp0epxak2#YQ=+G1JegM&4||jAfHdt z?&WE24YZqo!N2^3h!gN}WMnT&Q)c+MnFPK{3;p-uhNKLiVMjCFp{ zDGfFZF=onJW0>0u+QZ|Wt!+0jbzt1}P&`)XWS$ZL@j&vRfjRJPeSG?m>5=xz~+l4yBG_-=)&6Ml` z>H&MZ&|$QqZcrAEiTQZ1hcD4@1e%+r6q0>~(P-BKM)dnrCJ{8&W7wP*s=JZ9gHWPWR8c3CRBtAeD^*05*El8R_knMwZwIwO0f#*#~k`b#EN@8<`++MX$}6 zEp0Vdvdn?Li{XYC+4soyJ5TWTJ=Fb=23d&pog4@#fQ9KSV2_!gq&{&R4jbH6Rx;yr zzC_brl*tVPohB*hPu$PppsukeuA2iA9LM$H{Xk}8DAtI!3fGs`NKbHOm>~f>M@OkP zM8w1`AuD67CiSIPptIXo{^%bx6Pfr%j~GZkC0dicEN%)CBvUY)jTrg^MaGa2A4XNo z4~a!W^bNXhPGDiPZjR6qK43cU0H}yYWqg`uq+DbV@#oP;_17}A`S#IP^F1$RIcY7u z4B2mWd5g0o($zKXWE~$SA<~hvs zA3ixvz6Hwdci|MCoF@1F62x^``|#a)CBYm?YCvGMeKo>|`;#X4G9+Trf`Rq$5eMrd z?G%@*(r1sfu>v^E8H$<-<=D-2-MGFm($N*YG8i0I3=Mwr`TG-^fHz{6!@>dnPo*K3 zLL=pxCP&e}bI~|eD@!~E_`uUb*mP|GrtCQKJx4rqo&r@ zKM)fEKH`t2h_WquXPuXJGrphf4;W8QK0e)Fp?Mb2igg^x=Ulz~a%XJ6^J%S@4!2j8 z(}fDZalO>ybEV;^buD-ib(^FWC*=l1NvZ9WNwpSnk(YRwNV0_|3N_JayKBp2g}p=w z`Bbvkm-u+ns0UhDz?^stYUJ(E3l+67Q@oqR3|qn^t$9cIEgEJU{QlKOel0ZlXVNXJ zwK!Wfr>+kLd-STV@p;X%dInUhLIjI;Qc`!H1_mrW$KUE3a#oIbelR~N^0Kf0q*n}-SJ-2OJ$nX_bwioIOZ_epwa<+S!+XkpDZbylHL_^ui9^>Vnu!{+253_io zC(x}nsan!Y$<;kojQf`gRtK@$5)7_^;Z!n%x$3|zs!2z;)%oJI#D9q*pe9Etq}>y< zauJxQHF%mueMFu*vh61MsCxVy*yto(+bq_`>-O;hD=lq}B z7kGk_c|s%3GzX(-tUpS5Sv=9LWcYEwdgq1Qnow(2^?DUWr#agYXSH9bggWK9mhEh~ zLw8?Rf0fS{?6Bs;vejKK1J0)Y?+~6Q62AAgL!4HEUq27O_CBchCUDSPUM`o`l2zNb z4a1aYf<+vBtr>KEQn*{8oQad#`QCg8&RHV3va5S#l+mZHrQ)-Mxp5*YVUvK8LA8-U zd39l6I6@_`QrO7zl+U<+fe|(aAWx-qX{`muwbmuAn(>j2LSmT;42vfwCdtISgC9HC zEj64+VKbt7^E-26S};?clwXh4Tr8g0yKsGpNX~y{@r2FIcrp>@xc2l?{JjXuBZTDF z?spEs+F&*l{cG;qkw*D47BV^4(&Gs(n3h9Nl`7=a@l!NdoHbV!Gz7;PItb>u)(F=E@ypx$S427+Ka2ZiFm}s zKR~dM-n+_CQ-!oD{4s#rh?FL|_m0vRRx8!GQqADV?eIMHq=d9eEDzD^UFHLDf#3b1 z0?bjP&hyXuNb0YxEUo>{-;_u>Q<5~%gtudk#L6s=ii-ElFQ=|9%VtcHIbuqXe@Sw* z#>GMosz1-kG$x2q1q~mB^kE-tpvLHq&!u8h8UnxTwM<|*N_a`7S950F{oz9$H>pq{ z^vkUAxBW8I+4N5QI5IZdpmB(mSlw2F$@%Qj8vFx+<4{{+D(S=WAWGvH@lxFOKJ)2y!uPq7w(!iHRl~l@P=!SBjExygZ3kD>ladMYT0~kTL4& zS}=!+hGJzi0=>&o{fNu+wPadlKjzB)kzrVRj-5+{i^rZ^8PrHdnb!*wOZCfCT~ykR z$sv5frp5AO>KpYJOMInwp1XBvPoJ?}q+4lL*=gA^)DS`545;RYLXEp&i`_!gW!bkK zuwN3v_7;O?=5w%di7KY&8+l>}_zpAD{S}^W)e|y4s;U?{*t$ZA;i7Nm+frH3qdK6Y z<{|wie``g8kSKcN!H4$^d;WXX6#b7)yv?LAmp)T1j}%8xN*so7E>=;f-IBlMEgJBi$~@~kblBht<}%gyVuHyQqQM^{*VKi1*m_1cu24@<9{tDWz)opZ1xKjp`cOCaHPJEU1rZfe9B zohJx*a*j!R4xF~Ll>FJA8lRs?kWg-ogbGUPcR;mSwSw1yNtOpoUDq>1~p=c zeIRD>N@>mP3mR@`Q_HPN3HW$L$%idMJ0=JG>|dV^y|eqhIIT~KF3*$@QQ`AzveYVG z8S@1#ZD`kPn~o_(NxAl!Cb!SdG>3FYyDLxDHD@R>{r%g~mPrp{-Rt4Vy+l2GsNx_r zJb%WRKxteU&m{m}pZLvOYYJJ`B+PfvNhORrJy^4ha=s7j2J`p59%f~!RBz#E=BWgF zRs`JYn|FPNWl5pZ<%Y8|7xEZBWmC7YFbfr5j$WX$e!OiTb8=!ucvVZUhZR?Jv-ZxDJlGS$kpiKSF zQj9Gyp-HzGdQD690-kODJK+9vgrTJWy%mPiI@Opu;$q@pA4n(D3T-L9m2v>=TLwwI zO?-IaU21hJ95POy>(fmyxt=KG#ZVD^cn%UzMKv9ye7dj3ttwxeXa^-tcR^Q>)K7rk z-SCI42oVpA{rYr!BTn~SaJtcfz4)mTd+!6Ah1NzSrQOHTfP_YXbZ*Q*Nn$?GsPb^7(l1faljP;MA;hlfH>qh{4 z`O+EKbF$fNVFTyE2ZwLkpra@lE~4!RYbG8i3)DKg$Xk6sQ1*7ef8QW?SBS}pjCF}? zOxSj@nc#&Pce7XG6si{z3Jn8=bfKoPS1ywmn=u;+N|k51e)(_#OpX@*HqOpcB~s=K zzRh^e8e>`>gb#AQo)gNH&xwZnSj5(DCZUVq*&!JZw8CuQC{v!a6c92@HcSw{Dq>*x zJEL7wSxxu%8a;EBi9-3WXO58mQp$-J4`daFgu#2r*_6Li^a|c0u~(4Yy`zopUdHen z*u?%-)j2;MBBWIU>Jj}n%I{%xR8*!Qrobg~f6<%TyL9ICg=8g98S5v5vJ3J(v^C~yAfG6! zD?F`1XL3w6Xa6vo5%U+W)XAx}IXsO__4v@L5Zo^|ip#%>h%L4kaH#|fivNVs%+4x0 z#;c*5b7+Za{zUNjGm093SH1iFbXj=JG=^O_l zC#6bU%{zSJuf=NCJB4^1vwV1s3qo~Rfl79`nhV<}C26O_*dH&gOsn*pDhD#KmwcyN zg6y;EZ<2X>b0GD0A*6C&0^>+6y38~0@6#H--fLs?hO2zAP+*zaN(OTq9%;}X3(6r% zqMDtSwS8^ydcX^c&eerY3bT@#nWsbvI;PZXHnw4D0n=i(h3)>}1tMa@Ks=M$k z)Ay$dgj`c+7%#VOm5^W0wD&Q74G$=vD1#CxSLvsi?0&?|^pG;!eecuO|NP5F+QiSc z_E+l}K>^w?Nk`u&GNI=E%<8O2ac@KXC>W6;6VS?0)U!jzLP*u4i(23dQ42QAJ!SuG zAAVY#L3dZdsot-K1Th-M;on*K4A1CyJSgZajy92*1NUv_qK@9=f-$FaS?EH0!~}HUY9({QmxR@462)Sk~0$JYrv>v z`y#>8%x7uFMN;z-k3<5~mO0E?a-~^dxp3W=yZZK>GVovz%&;9_jk%J-)Sx+l7WgXy zP8}=eNI?crNXybd4t~ThFtk&cqgC>hfL=KxGDvQ$yqr=;xA(SJgF%!tuJ?MbpXW)H zbIoH8S9Qr4Mh1^SkoKnB2lBx!j_eUKY^tVZ8xRF`c{&>-&HjgnU|inW@5x>SSTe3U zBn?04ivdDWC8g={id5RqQpF4sIbb@BG4zeRrrEE8g0QN1D-uN~sY11QiM2dLPiXMAtPJMeyCXafS=h-1EXE27iu6S~6)$EZDPCG0v);L0tj3g9tYu6$ z@Pt#{af)LY{|hXFRELvz*7%t$V|AS163K@4(Db`WpPm?*&5-<{uk5Jvpz3lI9*ca+ z*z($0c<9afZL#WICN}YmjHKz^=MOHIQ&08v-Bw<4JDRI^$Ep5`xT6s3veyEfb?;s3 z&Fo4I<^FPh?s?%zbg5d2Av4w3-CbbN8XZDTPGr|?LkH)!9Fa2BDAr<6=P8)lyJRr>%3ID^U6$De)pTY$${{Q z{+&~NUb2F5uP$io9&TL)xxCSGbwi^Z8I$($b(X|rJMw3-$v+oKBT#4m|{b$j9sp-9D$|HvS>&5ukggSpfu5$@P16s}D@KH}n-DbE=D%KUs!hBjPB=MOrO z82@?qF(#qA#E?*7?I~Tl!^SDCp2qUip#!=Z-OFK(sh&jb{^oE|{T1!L^yd&Nc+?Vb zDfX*%^Jn!9Ce^O27`b~z*ZJ=?5)DmK>IT*-9L>vi)R={4!iSyb)LaS{@4N@oGDv9QJuS2DYgtyXG?#ycS!jobC{HkZ_t zl##@2p&k`c%h5yLRt*)dv{l(AQ9cZO}e`QU%D!UU> z4eruDCBdI!Ox&6$ADY_zqj$X-#T)iI^sqtrr6t$69}ZUX%K8z{s9B}0qQv!Wya5_^ z!ic;=RK6>vmz7y+KB+C=J(w6wld3s>UpH1(170#?a)=u!IL_=b(rYG~K3kZZ4R%<8 z8-o;&SWiq{VCaw%)2Fu+A1?lNnKln1Tc!H#mfC+=M~$yamlQ8Ce;_`ff3!KU(ZNhh znc!L1Qh2a_IvFQ2yM&cNrj@k@Ub>p=AuWvK$lV@mXy5~)f{vBiBhm5SOzSxgD_ke9 zW@_(2n2G8-8uZg)7D*9RHL2gt2bUoxOTWiE!Cm{Pc>DxPpiIW5P<}@|hKj}b39~;N z+Z0u)k*`l9PP*&i`uzS1IfZ!3)W%0SJabkI~}ospJ)A zt4?`t8D3BK#}Ju_#5~a92V(m9ty_+jx@0R+DwFv$MFGH z3vciHR;Le^drI6Npa!Uwn>F`>JOyVPPU;^akYt zPTpSyVniWC+nP+y$trsjx|J~N?Qf9&fjwn5u5w<>-M+`x=82@qPE&g;+{4i9mP3~lHsh(<=bO$V1J5SUt_p4-OgihJd8?Y+hPD51}=w-|`E{xEX` zY;fD|Y<1LK6bBzV6pB^;>Bqqsodh8hz)GCf=Si7Myniq(IqS~) zRAqwPlz%tY2k$+Jbgznf*pBs;Mx#sUGv|t%iU=1pAU+W@h9i~lc{O%B4Gl zJe)PWK_s*S3Rs!Xx#%xum=x3t8|bKz#~^vh_)dNf=E3qHJEM+HC0 zC*$9~x+x`S`GGbx*SMSRbrN!G%V{+8RdnIj^PSUv0Q)eHsFtRK1&itY?)-zXBlJohBWfNm^c`4z9@e$J^pL;_lVSKVR`bwjy`JQ9|IvmH!ywD5Z64WbR3P8?Bn^`@p9T&`U&F2?$((ZDeR8ujGqz5`woHrJ;i5<$~3JFG$JyY|`5*IA^+KV7sRiw;J~Y!r7a% z^RI8e;NVWAhRUt!)v&i+%_K#CeWG}pbL@C)G3izRZ`LIzXYfi7I z@O`iJI|VacM>ph#SLH!A4+OM%qfh=M!U9udL`w)b!224ieA72XyeGr+IxS`;= zxw@n>{Q6s;<5m8cg?jzz&!{U=^I%L2W~7)gO_#O-D5vnbW$?BsL85VEs%jc|^FaBn zv~(XpbB{waEn+R7i+&kuB#a&=Od?Am?MdX*IyH?7=_U7n4+~%igLb`w7M_>qw*;N~ zaD-iEzAq^?I`YS>*#}g`p2S<|rc3&jD^^?Ro2-0KO^3 z^1w}miD+vmh$~x*`klK>O2HUdOR0&-=ieot`BkSViNp-odQQ}gcgm;}{lFS=QS-Dg zi4T|^#C8!cp+{?7jUM4vit;$HCQ+SN+f_YU|eUP z0gxckV@6;_Z<`}Q`PUWC^|8|}xE7%I4$WibJ8nryYsc#S{_Owmm?!Kv+q zSw7$@AXR3a{LY044r4X^jO|syG(ll@bvcz*LjiRoG*+Bet@E^6d4OD5iTYKY9v#Y# zfOGaRKZrer-E(NS)Ivve$s7tF*GZfhX{sR<%3*`}57}5MMPE9DM-g2YI+D{gKXzvE zaZzNG?0z*zG`epZ+Qn#6%4iz)z#m89S$v-!r1{&=Pp6YcMPKm^-9n(E53jhd zdJ+RqP6AyPAjV&1K~8!KBi4-y1Tl{I9;3=MJPW<*3qS09g9} z3l>g{*<^X%vb0gwd3s_cFMaC#2W3PcP~Bqwceb*O=c$2*VVaiI6uM8B?oGzfP!Yv! zSWk}w_AD;p#FA41WT9tUYgMnkKrsMwgOIGGSTn)P)aMN1s)$&`zE6v8fB`4 z=o%1N00SAt>T24za;Tuf$T$h4MauP=gCV`SRxCrk=9=Zi*YY?F+NJxA{&O_`TZu6f zKYW{{&9D|P7G32YQjRzBl zMC4n}XQk@E?a80@&Zw$kT7;!lmll{lLy~$WqEeu~gJM0o52)dqJt*J2$*tX^sc^u} zxa@MdBfeS4!+!gr0KaH;}-f;zpnItEmSbdSAYLSp@ADe|4S=pp(poe_Dg4N9Y1ZT++Gc5%rV3;t~V> zSVjZW6O2OvqlRcew-e-;94ax+6I-jx?{qGt`%q15SYgOBWvNaZDieW(uiUT~{Txs% zWQuMUV>sVtF7{F=>-zLY!B8?Q9K_RQ@C@J=u75XLJh7p`fY&oZ30mBXMQZ+X%&^C7 z;3Md2WMVEg3Ur8bt2si`3uhgUde%l~YCSqFh6=z#z0F`MMm>n5l`(`es#T8fievtGe|^EOze0DxTkva{v9YPi*Vp&rgW3<9 zPqmb%8OvwV^74O9zcn;;@(GQzRIi68F>;0car8*JM=CjJ>$TT?_1?8WMh5f8bMBI% z0~gin5Pb>%{D6Eb^NLhzRi$@5U8_yGlwNaxE@&zovQo$d8h?+9RgK%hzcZ%ieK6!X z9UJyg2>5Nx5G~JXFY7||VMZOs(&xjd$Oqico2HNBOW_Pf$MNLF&>m1naI^L=a|x|# zf^bOlS2$b_`>-E|xNNFfNh2~GRRL1+^768>U%`e32iIc2Fg*D7N&C6Prqo?sD?tJ7 zBxacptL`<;T)}krx@@p=vKsS-XARZ3@#PYwr6E^Tjd7UoTgSdg2MT|egB*GSbeu`W zOnJuz_5LXW`i#LmO{2+b)&x_MaJZFKrdpxy7twDK5sX)(fOJeHRm)Wi)7>2nL|KT9 zeGOoJ#>5kq!{BF*H%EnbII2t2N=#_7U_Yib-D%;O9uo<@wm=|3f{sFNeR~EIsGBl; zmKfzg80dNl9xN*DsIscFUs4+?tdhZe5C{Wb9Paa1j1j;WQxzzV`PWy!tt zj~s2|SUgs{ngX@1PRXddq-4#LjLS6iooCkp7~nX#%D)fy$y2#`=lAqlO3WD#{33C2&Ph#$0z90b2xjyN>bWcs z?99pUI~5dI_tX%AX&ligW5X|1U0ygd|??fI-vN&O7fmb-efV$?aH-q%z_E z(I$9~)vs#$r~n@(^L4}@is@M#0S~6II<&dx;YBDqStt=xT>~qFeY;1BLk8P`r(-97 z3&T5Yd0eQxK6h2~zJI5%j_`1E!h80Ome%KERUO^+d(w8ytq&+dYfcuuOq2hL-}eOw z$p6s<+GFP>QC-8d31PV=ca^#e>IeJxzlqdvFk?sbY)6wn2P1t$$IHUh)diu{;F)gc z#6fzz zF)0H4kvReP$RHrp235AJ(-CYsu?&lg2-P8f-SMqN2}EEX5YZaWq6-f}5_uGP69ZEu zd|tCxyBaeiI@JK9v{jI({#xFjlv9ouh!4*h|y--%ovjSm77zhmiq2RXcNMdt=tt zPKJs<3V*mAIcb+Ngx0=N`{-PbhJ5}zRf5mc?XOTw7#-y#cpKSF`9B?J?bjK^e+**2 zs{g;ftFT>pdFslkz7cTaEi#L=tfoZ3S7N;M{rF4{mzXl;eFq;CC$OXeeEbTq72q8U zCXc8~R)5aJ4Q<^jC%}}@G5y8lY!(@4`(u8*jO)h~6SGUZvyi0er4dZfUx-}tda zq~>_Uh>jV)8b zbOGI$d=I{D9x4j;5`8wvUJ-=+$%Sc%KqL(U5r4|zAFYFfqk>|h<4ajDGi`OQS8t|E z)$-%uM*JlwCrJ*Yz^GFi@F0ubZh``$3Vnb>jR)pB(ErXHJs_q9qL!E;xi<&5E01Gp z=@=R3g|28Dh%)Xs0E)!xirJKp-GQqv=f}Er`T^c4-m(0BItGV0NlZT8f*j>c*AjCA zTE%5s6Jzx(y}D8dCzKIg+zoeRba=*1OjPI$zeG;;SNM9p4y@1elUzVXxUGz4fQq74 z=b5c>GU+*xR#D7$n)Zr6BkoGRuwAwX}fWPobP`vcq zZ??xEP@MoUt(E&V(V|2K0??O{z%=R)r9`#lnmoHc4{rdEg9fhS8}+s`~0{f z9iUHFa+2yjsTBfs#&x0A)04~RXx{!zX--c=p}*NE=yzv=kkc`sGNsv zeFr%wd#&={Sn9jGH>dRA$^KXE~l#~dzv>x5R_*)tp-!^|F%b57veXlrt-Lt&RA`{l9o9Dfuk+kTNC>OVH5Du16%C z!+!|^3)bJ8XeHtF(MPl z&yx$zZ)lXiokH_iUpw3`olsJsU%Rtzjv8<?A=Ra zi0Z|Ic-#w)abiEeh=&Kdfx0-FaN6QCR#>)ziN3Dl{ZoF3%;sOK5B!j@0d?rULA8Fl~>2FW!HbkyONDd zvnYd-ZjJ|{_+|4KfB0GcbNzNBsFFAOQ%UP;JTLM9lKMrjQN{_|P*>|1{a%_}bM|n$ z5l@ic*(c0D^1k~q7yV8Aqmh2g|xcY$K=5&^s|A|5S@e(>Xs_5{@K@zr~k>ZUX zXb%rui@qrIcc9k|Y0{dRP>)oql~vRn*%mAe6DWy@|Dtwv z`u%69SDV;;`ttJfS2QX8`)cJXMYT{@8+l_w3+|>55V;ruy|0sJUcQ%;wTaz*_;0C; z7wMIz4HbS_j@9N)g&f+HOmSG_#HXY4+rWplOWsBZD;lKP16#9ixobGbu!r(`Zxceg zL{aV`i>%6Yv)*Af9+w;*a5^r~R~}J$gB-AZbeh!3TITHfF<3WYhsM8~&7$h|ZyHgs zX)m=6P-kXlRPLCVnAmOLAYtI}d^&&0^pqL&w%fJR!CwU@FQ|J@FE)A5s@J)F!H4~p zKXzCXj#WX$;*=l$ehQJH!3bML3=roDJf zeAF|;Blc`V2AwmO(DVkjIO30P7njg01g1dgS=3=1#=={qj~+=!+1lIlAqh87EZwZ|uV1f< zs%G6^yLfO97hW7o=&S!)LF~L0r`4EV?SQv`sbwXnf~{TH9qKyOYxGBJ8Elv;O#Gee=k9P$FSbU@mKed&7_+- zjNcRl`CZf%6cr96%AttYZ%U;w5AQ;sNjrQ*=J4uZZ>YjJ9=rEg#OP`H;39kJF(keSl~MsBzNA< z5B9FfoH*`0FvD`wYzraQ(X64{%o0ErQ78&*R4n>R{LO;0!D<_;>__o1I3`#pHP6F) z^p339ItnM8+r#=TlaTGfnq%MDz~~~g3L*}bxPSkCdtQHkzxpj2?s<}3+=|cDkx5BC zybK}hFq4>=%MG28)BSQIxP|eBH>CT++<@hT5E;HBPk1+t_5M3M#am$6?WtxP!@SuN z%|{a^=2{kOkp8vq%RJ!+^JaNVUw+=DAD`No(=9uSC083i!fE%6ZisffC1i{waxaZG zTL`iE$U~xK;y_Z4p z_gU3XVU`$aA&cjwbvkHg%&nVxKf}AB8dg);yWhMu!(Hc+EF2$KZtJssF#f#9x3S|n zH7#P_&v6T>59c8p5+U}*vrkvBmTY&EuOu1_u~OMd2WJzbbKS;BNC9zQKebb%cI}wI z$jbT?b!+sN0cx{kN0jyuCpYq8tS2}LlieR*$rig^N{WoKl_pI73xDf|>hEnPO>NQd zog^`fZ~Yu=TlAUzc>8ud^1eZ9$J7z$sri(H_G?42cJkH0)v$62-SLmqiA( z&iYtohE={}zaV>-NU~GxHZfV0L_N%pghZnT3Y7Z2FyCTjHG}#3w^F=b6BSTLxc{0Z zDpEcA_@vu#dcZ-tUYVWdh$R_|CLo$$^ll23myE3qmerNl3=GuB7xwiBu5?Mie*Y_) z{s9P54pP&9VQ`NOmKN)rjuOiYEzbl<#W!_|y}MCIKOjCdM&qU;TXKALuOF#)S&>UL z8p_j~4-Ep^Pw=6=y_W7C>4X$#3*Q+Zb!-E{X!|O^+jTdx`wr5FSyTg5r1LxCI1I7c zRWKW ziENEi45JB)1M58yozzjRt*y~uO$7pHpJa=fhxEP9!p?>++81v#irn&+yNzPB=X4f5 zweHorSdY)g+1dDA_|?p3AAJ9eU%wg)#Y~C}pQn?#=cZENCf_m$b)C}{j`{NGif_F? zR+1AJ2?=(q1q2=`GuFYdc?R~G{6ph<^+xF3rfiiq*3^|UB^p8JiI5`tg zRbKL&&)yOp9`m!|V3VHpkzCJ8Z;ERP7tRgnZx&BOAn63aAUsjP8#i}*Wk4fd0lF~bj9l9F{;T^lelPxRo0Bu>`1em5QRFWCIjn??(Gv~X+>wYzka z*5{Wp>>~(RTU%>yZ;y|U2U+!Zhxpif_mUPH=cnDB^N!0+-tf|Cf!}}6tyAO5HMjXY zPr9NuZTg^n<1;*VAT^PkY{s8&sfF_R@2I5F)EwPnu#%91g93iU)hD6zPS~BqY^gx6 z_#HgB;y=%TJ%p9l9T$$9twf~ius|TfK7E5V^?Mc|)K}RP>z;aUgDY-xdJ%))(000Z zBvi<13c?o_m;H9ieIo&S^py2?7$N_p+4*e_qFpw)Q?_^_L`0#%`!=fi-3va}lekb3 z8dDNT?XtD?&mcc;mU025ozb!wvu)ke2@;FHCwT@=(jBl#ju2z^NWdA$m^cpSWe~*g z?5}EV8aqyD2)BT=SEAs*Ta|WtPaPgayG4X*Roxu#NiH)+rj&(UCVN&oFQw4t8zt@ zKH;uxxI=d^FZ+C!P6J+`BJOaX8qq7k!e86CACPWtntoC63g!uM!RN6o?7DS3u7iiX z~gN4tbXB|l<~X9qf*E{`{w2Ty-)N1#fPHh6@WWK`s*clA;X zpYkot?etC|js%ArAC8-qn5U#V z)lNm7Dcf7OQuz@yRw9i1Dug5$$XmY8c``B)Y8#qW4y`3+rX+u8@mV6HV-jNV@vV+G zo9<>J9O!44MQ2O!a81K6(fh_XKuTxJzmIiNqP(uXH0pW6VJxG-4v$$`Hzgjau zNkR}H0Y;HRr>19Ft0G$C9N>QMrWTQ<5DPsU7RU||>}X(ecz9+%>{YtiPh%Jsw9CAL zVq7_AKvd2wQ--=FZM$=-Wx+JB>n~z16{#no1V@&foai4IH8dN^o1LS9Q}VrO3X3l} zXmk*rh{-jTi%d$g+{@RxJq8a}ZFU&bXJyI;5rBd}>vi*5{2(!vKce?_N;WDKqOy;5L_?IIbm3PCBk&M zNK5?tB47Gg38HhI-0i9G-wM#pTn z^u`3pL@c5~wQj)4j+$#g6z1K%QNww zitXD)IJ-sI-|-!YQYWEGVlZ%T0+0fX#Q-=T?a7(u`{p?Qn@W;|=XOa0urtl?J5e48 zsPK7)D*VG-QZ%VV?udXT9#D+MWQDLxpQWv<&Tjw=Ys_3S-5gq7{S`UsX(;-=68uH# z#<=Z~PYm8PkG500Gu*8kU$_)p=W^<<)n8trk$8>o^9}+z{cBuI>Pi;{8UbjmFP3Hv z6hmEJf}@2Q9!LCqhQEs04if6v`V2f2C@W7AYqNO5zg=a5-R5W+FgsAOEf@I1gmP`r zC^25Bth7Jq?vEqhPs)OZII}tEu7#vzNHuGatxJFtLTS3v+r4OCnwS35=|z%b#v}a@ zdZRRl{rA5%4&*HeK0FB(AWoTNJGA8{@jd(HodPM zM0ZmXYNh`CkVs-G{6@spr+z+YGkH->P^wmcW^tyiie`X|AsG(L&vrp>FPPWXdjJ;K z=eEwRxZTfcxq3G#IhjsPE53=7inwhV0$~9F0fHZge<=V03%CbMnZd{&J@Gs`1$ zw%4~tT)_Kf@xXJ9MDIfb%KnA!slc%gyoT=`hahlCCTZE%S@U81yygkOI~eKju=)hm zUKn6t^m}qNjgp+-$V;|y(cy}YbPyicxqzwcTcUuhjo9x+$#iLJ!$Y(?fwTo-4di#G z1kS2fKq6;yq0igmW>4AEqk}AFN()Kna3msGKVM$Lx;ND45d}YQrJbSSyJGdEY6hQ* z`bBC7FAsOm1OUtcS9d$c_Zz?>H-CinzK*(o$E$mD2*|(iAy4}TOxXrN!+_Qn=cQA3 z_jK1+e+{wG-!&m5s!k?iBZNTu5rI#qlSB+^ax!U$OW^DxBeUgF@fnnPRsPszI5hb1 z)2&pUbJerb?CO)~`U(($qN*z(fh);C-uF*dq$0|sZ<5l;ue5b(Hf zrL}pONpq9as(SKt;{ZKL?W8Q7Zf^bKC{Qd=oxcZ?UNW7VQ-?izTo`xeKr$fu2#Y&` zaGN3D`?JPISL5o&cdRa#b+Pv8FxqNOz9}0lMAo(4@o5cUNK69^ zRK)BPIIybtEa}B}M`In`v2_ub$k3qoFPTL;K5Jd^r28peCt|cA@ z(jg=5+*uJ84y^vhjgMghOF_n%7?5q1Dw<`5eUPgJN}`WnZhw6ItSN=Sj}`#{SriRW zm~LRCI7r-$jw?MGJ#6Vm7wWG6l*O1Ha*=d=xe@k5a~V^0i8G$}Mi`U|4>c%*fy``t zp8LS%1md*>BBI`@XHc8IKCroDd#dmO2%K->74Tlm!n1V%kgS=RLDYs6L!hWuX{po( zq>p2BzA=!K%@27)XQwJ8J2SBX-l$z&>Vg_~5+D@nzf`nTONkZOeg`G$!GD%X?YvH{ zed|#MQf9dR%x(D#0&ugP`y2)+vR=vk`G8N@g8W-Nbe45G34YCU8)KDZOQ}wIYbrY- zLSc$WyR@B@cXi$rF$oC?8VE%Ah*u{MxI;r=A@l@Lo9EPR@Q$#@KYTDx`@KtCnwC>G zEkMY_<bIc^3QHUax*B~GHSa0bG0h9$w+I3nC`b*NKG9E7gPK9Wg zmw>&YsFrr~FtuxSl`UQa5aDKgJ^1aQh(oUHw3O1DqpmihzVgdQ-IWfl2XREiHljJ& zw)M5Snf>+8O=%vvq|arNp}$0lmNFUe0zGRtJeMg5Filp#>O|5R-aYFY9D(5(_Lvw| zNk#@e6(Gr%OZAR(8#X@fFU_XNL}*FRnzB)wZ@E0%VUGa-@+&M-Qe%M#yzBKUAcG)V z$OjwuF98h>01Du!yklRRTdY$6mZdqV0`0jB&@?XOMGIgH_n6~SRHfePJ<}m4#6Ut? zcms$@D+|U7R1`avAh%HoBO@42N4pQlY4e#Iv48$|r8=Oee^UPOdEZiYam-uWv z6rp8v+Emu{55;$j-KZ!!d*~IJ2`CT7;aX%~Ik_C_u%TlU`-c+ngoCBd4IhruYXDrS zo+t)UcW~Sefja69!Wc#8ezil{D}dY@4vAYgVA8w)LHkIrwQ75YmQ$_Qagz`vz33`k z-a`?Zp!*!BrEems4wmxDu@wY@0mZeF{s0UqPjWlfFUF~!UM9m<6V1KPcs6p-S*KJ5 zr6dCo$X9<6!y-pk0^60{X#(_^X&zZ@?63VVsmNKFs8>L`=yJI`)UJ^Zc!7pUT=x3L zB4Uj2aw;R8qxz6|Wz;we9I<--Id=FHxTonfTQ}Zm(}yEPYR8^&JyzwbmsR_2Ky*kd z=e8QdJ_blnup15t*Dm)ytWP+!1X4~?(kMN0~_>2to6V-XjeRCd=cK@IN zg9L#?-NZiPoTp_2#;2z$FG~ z{BDrVr+?}R(`}E*SNFIS?z1>8R(VI(2`arFIxQQwe7TlKtlfYjJ)}@MP8>RzRN;|) zc?wTPh~e2|W!O|?f=U>?j5tHtV&+1Mv}#Hlxq4h<0&eD}f;8g%2@If1&?C)csn_6e z+2<)-4}y2j`5U5fp4}J=13>}c1OYv$Ylmy@9WN+@+zKq8{yp9+4fn;l9ed+7Mv}wJ z?8Thsg;6r)19!_4GV_&D`iQ}gB)e=K4dy^cuLik;(9;_jPT4CUs^-Zx)lP2viJX_GufY3JYt?6Vjdh=Sd#C!>C`F&L>S^32aWq1&1KaAo0|{I>eF06UkS)P!mv69 z!KuAW@DYSlC`q{pv_iKn(7|HTBPKy-#$cek)!CwO`K=`AW>~AZzoVI}+#Lxw`N$D( zdkn9J{WTOsQrKHbhl1&pMn;q!Pci`041|*xjUp~@;n7nArq|vf$EB>QZ%fc4XGz`- zvkay1Sb~pu%bXw($ZIH~I(@~xKRv#9=~90=4xrYY9gnz~NafSF%wl+j+{%^GTplS< z^N%=d?*io0+2d?rHPD;YO~BwJX6ggg;LxlsFyQd)Sr>LvV~g>fi-k6$s>3oNFG{iS zP&5*bNgzo5thnIZR>6OU%>;TE`9ai91G;6l@#Iz$?-Wlu%yU@s`a~36g%)He2YPWG z0&qMNi6HdaAjHrk+N@ra^+-R6%!EVH!&sslU{j{gv?a~=k1z5U(RU+Yv}vK*S54{p zy1s{A@}~r}7Ba*x@B zl#9>-_;l)j=s~|XAntr`gs(i9FfYqY!feXeBBvB15h^r+oSmE!8p{d9A8qKl%GQ^+ z`#`Se0(=+><1Q7XS}6-r_E>o1R-tc6DOQKI`PlJsQARjdv+dX0$JX^VkgOKRY5+XPO8J?z(Y|xZ1|;{> zgF|R(Hu^x{5;wf==GGms6(FY;fByavXfwd`80hatA47sb;&yT4xB{y8FgN!|=M4RmwsBV+f8oer!_R)g}X$2@QONz@O0Ms$bqC(z2A6g-W zLr>fV(z)Z~TQ+ojm@ejh3v(NOPSYPCxbYPT%ZE^Gx1NLR0`ONqMD;bmVE*8rOH`Qu z)$zccV`D%=Vh|5XgKsvP;u1(zjcK8SJ>7Sk9^rMx+GW7mzB$^|-AV|-KvY-crf`5* z1thhYd-6yh0g;)`xW)wKEI!Q8URg1=amnGa zco?@yJluzE_3ggV)$iH!VTJ&&r2h;85$*Rpoo)Z~es=>?^!$1|?MlA62hj^8mqpi)(i+FpY)ebqO>~A%W^Tq*%ROf|!RRC>t#l(go+n zN)FiaT>bWsC%2N9CYKsOnBqor2i92X2mS^b6)(B#uN0Gk1KVf48$GX5DFnztPOt-i z6XYOgR^mOCoCffRHaE>OBJ`FT9-W2X(te0fZfF?NvJ>} zB?ls#YW-QJ(e{A?bzu8Unu#HP5#lr!9{6kuCr@ zGM3Zz1rzc$%~#J5DyiPj%dhuY)OtD;nx;S@%@2lYnbEw~xVS^aJ>CI8X%$Z+EjF}( z1rJZt301$#0MBBb7uso9ZEtI9`X?QxiPvI*$2e!9+RCR=CY9%ULd`;7pBH^{zRn@{ zOj*+@+kC#Z>EVX1%gXiIU?3697yz4AFZ6rAO;=f@IrhKg<8wb+YKf&&E|kyiJz8!f z<-6MyU}6jk3(HOct>~3PASDP^U$F5 ztr!~{6N{l7FVv`0udzOxQL75Rt{TbWygPn-BW0+db@UE=L}g%@_I**F@FnjuW|Ema zH9JfD+|CASVYEkJ!*&-T#EZYNvYP^!8wssM7H zaY-v60#Z1#~dcWRaGu>m6wPP%Hl`x5ea>9NG_P(N+~V02f&yLtQ)&YI}NDIonac zR>k>RyP;&xn8ZXbFiD_Pzb~Aa`(n8*K)FaW`v^=RhOyEy(!Sd(8-hoDf$hN9X)+Rh zQxu2QIs>}q#|zY|zvDD390-*RpbQ)&SEfA8zvS5a0XrqYYg2 zAnw3GMOhgkhvmzr`TWmi;3<$lx5l@G5wicRAtWXq$knR0^m+&j3)9!M23@-15fP7u zC0^tr;n=$Up2?P=ChN5181cvp*m)TYHQ!qU?F`v?)dpwQCaJjnqWY8G7%G`7j{p<` zX0Rv0BcxFPF%(S5!s=qGDyZAm%9Uwqc#bbl$i(#6|NVPR%qj3kFpoxa3YHoJsIWo2 zS?~18pcmVklZY*2-U($r3-`HLup7lrjOm?Ir?D=yYFZkHvc59%VCeW?8smuq*d*hd zY3Tu0ppqQakccScV*u9X7p}2$zN|ehmJMVNpbqJmK_D})R|Q9c9?G_|a4&~W%AOy` zAoGWKeAH36hHq|-0SP^D$beQ>>>IrGURi{rdD9G~l&NOniSZn3nKuQ9tEyD?DP)~4vGc~ao7bleyYttitOA9{E+CmELw}F4J62fD3 zGp?*@b@kP=mHtk^LptnkeS^(`jTN1%=_lO#eGIlX+itO;bge2-6ua^`9 zn}ZOc*tS^cNwe&F7gN`?d2sa>{ zmq@w*;Ih?v)rlLIg{+!PDgDY@j%&R%FYz@m@BIM#qU&x!)nJN?<}!^!&L1${we5Ni zR9ZpiTi+VaRHWzNsJ7pqxeh15Nb`7biXh?D)ziB^N2#^jrM!&>Cc6h_H%N<$R$HwK z|5h40Y#VUsUrM#{oDA^kakOe2B2|Y7AU{1%ak8m%MbE+i3ntQ;&Inj!5ku2lPkPb? zeX?{4WYYLj602rZ^5*j%3-}0Zy&tkCkzC;6$o4?P;RIGjWk4RvR9~BwZG+fzEdk>F zt9u|4-d%uZF%2m7_>vSGO^FT6QJV*-bdW!BKmq!vMTB_D#CR@BmW^=j_#N9Y;6Y4D zG}nxNy;eZe;^%V+lR|*RKf%K_pMF#&+^%H=*a00#_%3PaF$_YJZBI)yTPQ8r3&RnG zX}%Tm=>DRqwcQ4vc;he>wWg+~j;Y|taFtuH_W~pQPA!)KW}_+ONDdqJFFoAf`oN?9 zQp}SFBcTG&h-pKgzGbX&I0WMt=D~*IS*-Su!E zEl~V7{q^+!yQ%JRV*JCono%&s8VT@xwk&4siRhRZ8eR$teK0xsa3b$^W7on}wzPGS z;*mZ9g46=kI7Y_%B&mUcY$b#W-k)%-2JvW^EECs2Q>D7kj!pO(yAEWD)iSv;0nm4M z2AH%J1Gv6Ss1zm8((V4;YE{Ot2pu7&(88W=yD~4z@j0;z$TA;L5!!G2BwJ`U=JHWr z|FuG3ct8&@U^#KLy$A--5NI`~{*L48$jVYK!l|PWYlrJKPyGK|2zRV3u2?8f{l&dTzFl>=qaFFrKfuoTHzB* zsvL zCw_(s&|u9-9Omd=>PP;xe1gE5P3Jk#c@p^p8HXWD>cC$e0+9hS@pk@4T{4eZr}8#O z+M~m^r){{23vEw>yFb1qMkj@QK5z*r79)G^Ll$m-m&#*f5>e$n3b2H9_|@mhFEl*g zB=kX-lKs@|EH@WdPFB{(k00Ne&79pHHW^B+MJ3#=0Ttf-@GR5{{Yz;ygL1*D02K=bLy2!o(CbOlV^OZcCm6sBb0O z9`Al5x`B#&5a`L;G%!o|v9W9LDI_7qO1vV3G{-paGo(zO#SJ(L0uoR+_+Vb);yiZS zJ4Q+=>mQ_z6hZ{?2W3-RyD~l=w`-Njo`b`Snwoiy`U`T%%vz&EAke8yecxI3@ty4kTx_H@ats3sXW&(aO^h8}ixcF;;%@F&t2(ycB8Nwy`iP5^)RO4i8%Q2+ z-Si4Wv<}OmSiNg?-s3q{w3#=;pk3ZX7)ob8ePsXS_o#tL@>ehWfr7_kE(_#n zfFgj)Y>CwodYE6p$I(u7)jfWcQe&Hy?{Q7G2LAvw$AG`{Ja;w04I=5CKbGr&enaY5 zHs4}R48Xp_uPKV+$uUqS!U|6rkap?(?k))Azm0h<%8$jan^Z6#mBbT88j3*29R(5k zrhr4&baHg2pN2~g8ZTrTi3W1D%>*FtBtUJ2y{a~aq^iGe8UqNtq}R6n z(_+7Y1jJ$*y$`f~XqBW1(Bok4=f8eev9r*OH<%x)$dnQD;*hB{?xsIsxV;vSMbLa~ z&(p=bVc);F|5G9X`ZKid){FALy{mi&q4W(uAJSJ6M-V_b^Vyws&H|kcKnmISsHkv+ zCwY0awHMn)ik^vTto)}({}(wO5grgGX%?3RNZ-DCNpD=hTfxM$aOeVB{h<9u?|~bI z!a_lq@TTCAlQA~erzP`yX$yJ(wHDd6~ zhcJyyVV_{)l2@g!2!#n2%w^m#I=8nj3ju}~2PxcTeW^AF3EVb^x8LyY-lupu6`$c1 zflnqmjrA?vuQD1sR1X=(sNLh);o30>t0Y(^hLx%E5j=6{-BZ};plO1C z!A8kX@MZ4I2qje(GunO^=3Mfph~PcaffH-N>dM%sF17GTZp_8H0GT{Od;R6_@g)4D zmV1IJzq=_vJny=>t1;5Dmyuk6Cc|%FoD=A*@UHdr=wB!vDqQWc=)5C-A@td+*k8A_ zNO-!MA|M5~@y9^D#~n}MVe%1@#^ZtqSFah$#Q76}H(waFTpxB&o93yrw^ydNYg$%o+^vfdvgn1a7*4DIEB z#6~AP92aR|b|s=B(;d2xyO=Oo)Hl>P50z}RUCcW4t}}mD{n*>{afdx%s=DLs>hl!| zM1V7E-u+0qc^G*$PUPJSY|{l=m+O_Z?{m}7A9haCT7PNzI^HdL@E4&~-rZc>VCZ~G z@ocP}_j@s{wM@7~`mo?Y+x`o+4yhB{bb{=s=;`V}!2G;BA{G|Ryg;$7S34O31mhdr z+%%E}iq)Vi3UUt3I-bssPRAS9%L^_Avz_M&=ky2Y%d?Lg zU+>)`$cGwgVqClP94>S}KeArxD-C+L(NJMkypJGTT@7$XP;*aleJOm$kY#VQt6t)X z!08(hpvO3LyI+2r75RM8S9!}hXR~~_5k^LjfmSuZlRRy3Z8)lWx9@)SW`I|HH=yCW z*5bUosJh6kP$S(`Jq}Mi+57@VZGZ!gWInG@l88f!ZwqYtzWV2Czos>AGlibVCe*WN z_0B&{_96@F#AjW}Vb3zZx7(&UmkU1L>(@O^sz7;Xe4^YeXXSQ39^}iL^QOF<(aOXP z@f;V8<08mzLOOfm{G0h<=lh4b^25{XxPxO8?WuauSL700LMFHqX$DGZx*i;M)0##AK6GGd292N-HFYR7vXOZ zbg932{QXT;Xhsn5akM!cestGtD6+i;-VoE4sh^MloC>%_=84C6Ob>&!hFy1FRr|dO zz0eQM97%f^??%Z8nLXj)jGioh7oqT#h-pG;yAu?e1-5$KDwc-&QbQuHQ~nzCH*N%$ zl(G+ShEL9XlbYaDiI0%Yz~?=!Y)mz{oT&Q8`9kZoGQuFIB6;jM*b`R|v-77U1bdH?4;ml0_J*cM3-E39DT z_42I1qX3HE31hn~1R{$JMJ`_%hK97}EfzW3Yxi?6Pm~!&(YV1Cx!lmX!qOlqV(8L{ z|Cw9Y(b2(vxw^VaBh2S^qj+Tk+xvmi<+@4D!+gfUy*-26?)HGmgkYKZsI_|i(w<1X z!CqPAGbgZ!YrN!Ve@HXtI@_K5)0qEM=KkPQ_YYW44Kw&%U9S_9{rPrRhJJ5PN_%uzY{zER72SLY{@x{f z-7A>|5!dp2Xb) z!mw6yEv*FQDv}+eP)#|%rA*jD-S5kV{cWsjc54So-KG7yX%C~>(SY6$Cg%^k-3-U! zfAB)Gsb_QF%+=b_>C=F_2UY-vQ`|q2l2Rj%q~%hQ2EKCP-{+%g?=)+2%iXfbRo5s# zw_4+rs@}*LhyI%n(0}tb0!A?2CFRFBlVTzDSNW}Pi22y|G*`h6zKtsXdH}^QrANW@ znw0Yx-}}h#opz3K+w^!1zPMlUghVl9QxlM4p`#|%)OousCC-2QPL185)^gwfwWuFu zZc*_qFpni7QgOLP4#_7>1QrXtVH9oqc{JI;L|E&Q`4x!Z;%zsA7x`mda2AIp27Xgcl=K{PUePh z?tQa^d+s7hc9~WkLzcIP%9Ptj60p}tyW0O)2=AG*k{zvl(vc>^9XDbnD_wo7{y>NE zN{EJ$b3Bb`A9OAQR zZ-olU24)Em#P2qXzlwiyOoc*-?fb8X{?Y#M_H<*1w^iQgOKFILGO_i}{f2buU>3EA z|4@J9k;AHt4qJvO`vc02bNe)t=1NX_Jra$$yJ&;;CWrudoo^z(zWW;SxsTk=J(RR` z37iZMuh7uFA7f%dyL>pI+2U*BlH?hJ*%`iUOYrpV|3rf?+dVx!d3n zXk<5NisfJCSkjv#_5S|X5reXt92;`Kp1zDRSjMS~3I|ODE4xuyW%rw@gdB{^xfF4m z=4A7#Wt#^Runtwkl0Bcz4}@0E*&RqVlWUFB%mQY2FLnfitycvuMhCpalzpAL_v?6t z!)U(wl$q!)*NG`#DB5~pFEg5B^u|PHtOc=OlJHKstgL*~lBp!9s8ZR5{p1Whzxsgi z=-rKOXOctf%#6>3#^E2bCb`1oeLrNa(!|!e8gh|{gEtJ5DlG|H=&GAc=}+*=F4JrJ z+FDz?M?lo+nM&guuTHpB^f6a?3MYaTrG=qFL!=;!%Z|7%_Ag6TXCCEmthtRmBRl3I z#Hp^^Uz#sKFfW*H>qL3(u4-+*R1f}nDW+fM`E3c4Ke!Z^;L1NY*c2>G)k+pZ3OP!J zpMc}}3k%OO1X;(k)}fE>i@iady{k&)kI)Un`2KwZY!#7~;3hBpt~@;(cT>9SnMj#M zJ>u$kLdLmwMry;BYM%y;We?0L8Ff;PrP`-$Z6(``n#d+5Z&d9YK3uzJ+VB5rY2h>F zrZHl#sI=SVxj2d7zfe($Z*a5{ua8q%^9T(^S#08`bKm7(UmgZ^D1sI1Fr4I|2hd^} zl@R|NC;qK@XA2j}D|_Otr|XOvVo11E991%M|Ch z{4xhw<2V*Muf?y^r4L}Bt^TYJyj?|U>CtIYuVy&@@jTf5(s0jDyTfj{*}HNw_fx5W z)^N}iC(a}v>LcSWp(2MAGAx2Umo>H3v zkCqW;&wqh4`7CwKMrXwX1p*d0<>~j`%t_$Iy#NJ9mRTSU3ZL)9($n{Y5mTwr*2&_! zdQ~Nac|RkW6C4gpMc~XA(SQyJN5L6O8w>WD9-Qy~$Vb!B)xA4jbvhQT5EYeUUZ{6@ z;da~^tWm<>&vW&uNIOIcP#)35>JxYEFEa%QtutJ~_MBKaSEvq`-|3Vjb5KuEC?r%} zoG-xKYwQNs;}vYqfZt&D6w+KrXINR|b*Ei3#KFd96wFA8tU5mWDzcu&M?tUpuF%y< zP3d~QZ*-+sv1``Fw8px!vXafqOClJTRZJ=jH!Z0XY4D?mY<5?7zi24wI*#e0-Jt(PR5k#*=!MT7*`<5Kgfb~!M zP1+I&E-fk)Sy~X)S&7R0KJOAKVn@nly0TMIE?2AWWJNr4De9xSVsH&+GP2asT*aIh5Mc~J-4$H$Vat&s94j|UQLAbNLCM<2gvUx(%WC~|nLn%Pmg{=&LI66shK7mK zFGVHGm#A?hTv!c4`XuBmQ#-}I0epJl;fzKxErG4nCXn@&^ z<=5c~uY@!Jt|o)wonH-;9?ws_`)!5y4bGsh`+=e1EG%@+`>Ke)Z8rLq#5JCB%V)F}KA)MM-dk*n zew;X3PAh`l@jQDa6s7O#oM5|p;s5899FMeM(IUbqB=h_xg|sA4{Acn4&Oy4z*S|pp zpSSjMt>=DpbQM^SRJiVF&h(daVAG0)>K98bpH^;?>!5Mx?)veN=mmQr4(`U~mfUO3 zwA)McvQ}UnB>`zyu?q6xNl8fy)g=)PuhB;fW+%NfzgC~MBtZOoc{*#->MtfpothuL z9DM~E?@0G7-jP|UUyKWj=6N@q$|VR<%V6W45~%#w%0UhQ%ep`dfadPx(B49Wov^TX zo>A1}y$nYlCUPD&?i>34>c*SB>9#t1Gm1V9QcXg*Bv9M@heeoYz|!=Z#~64`nm@ye zn01KrC4KE+tgU^d_TK(Un}ICxJD0-ZjS4kEp+s=MXAk$E$;sQUu2RbH59X(}+^>5U z8nMlQ5ToGZ@9+1F3(1V#NIt2z$}CB%sSzuinw~~CCWeT+@`n^5p7LZOGH$5*Et~Xr zmX@fwUH_S%JlWJ>+Q)Q>UO=%TY*de?My;Engd;F=#5gY(Nj0Lp`OUdzCw321R}zo) z(OX*`w+4~A8OOfF`1si7q{Ob0$%=w3VIxv|x@_L9l!g}7XqJqL< zKFt_xZ9F7FK~kLotDFn1v=)0zTglwlJw1g`3At?SI>T;tHu`_eNfgMY0)AnvxXMH# z^mMP}@WsQe2ft1;-Z(nVVR!}Vw>MMVq~j{S@=qq#7kO{YR>+jix)5UzV*A6yiQn0 zaous7S5;xTXytRsyY(ANyJTl#GB|aQ%*bRP?K?ZW0z1KisPKXVRg_CI+$8(ImzT4A zYyJjSksGM%J0GtoW(u<^7bZtXMah=`6tlMWy|Vm!yNNsokS=cr>)FZCGAl7Rn~jZ0 ze}O;Qq{du>%b$^vWJ1MiH|}~BCY#TLrUs^aUU@*rR$^{kusBX5=VjJO8yOA=Ol%xe0hQ|)%XR|AH2-Cx zTa;Xp8NTDYZyatE4JSKWpJvPcAj`?&E?QVpMt&9+_?4QK@fzeNb#>!zYbCilE4@Yb z#p=>`tNjTDpjjc)cMXK`5Ik6qn>@U1CJ;=GC-M(gySfhMxyPD3@IJJ)eyc@!F=n^e zh*PB1^_pVe-m;k6)e#kEq({Axh@LN*jaG&xSRPC(e)knD8^+bi)78{!x|}=+%z8!_ zUiE^&^!nV3mUr;%q_%O6fBj=?*BE>2jKK4KYs%gW!qVgp91vJEz$UJXXddANW{QG> zH$6DT&ub36U4=$-?5c&|zyGd4JQEnPXr!+%$oHCJ{R+gRlw{gQCoH<3u4h}S$jD{w z?VccdgY~)MhJ#9~6J+Z>36KI|I1+LS+PBs6j4j#%3|%Oqx4+J_aN7q?&hMPC_uV%K zVG6(W<41s%jv*!+n)y;_%&z9@Z{td<810r@8LVn@o`GBohx@}6nrr{UzrVO9`R9j0 zkA-lfku3KQ{;qTi81m%glQD2|j47=vOD*$T)m7$xJ=kZ<9U@~~|0laX=XV!g@?H17 z`!btNC*0Y&Cf#*gpiA*vrlXi%f1@(xE>R@+jaVXw#vFYv*d1I(4BAF$KhbhKSwD`A zeZ83Ija8skDhF){X5+sEP50P74?fM4N*rU5Z_lz?RRyaJ^FIAX!b#;QiHas-Da-iu zn=AkGYR5(PUHe#hU`0jtRiJ7v2thlSiL-Vgs*Q&@~GxVDE@zp$W02cd3MJ?Z6 z8g^J1B|>wrHfAsGG%{QlBiesq&`07ECOzMf*Hvb-fxHb=>{-3mH?!EdzZGc?ce!h9 zx1T3h1m7NUy_^CCwSQsIQj6EN2Q;E`Ip%j^6t4+aR%%*D)_WDi;$F2~v7(RN9PnGb z_RWgT#m<&a;nLL997tlXDlg9mT~ALv;NvXH)?(VLrYhWNOML|g^9~2OPaGQ%&SXh{rbboq?&_cx^ea#BEzvgbG z4w{ButxUsC!};>^)Y)cUJ{mPfc^{P3=KS~mFf~W@9`C4+{~Gq!Me=9|-acz{Gh9g@ zb3HvAtTI2dA~p6*=W}sfT!R!YRv9r)hQ1oPn+;Wt%dJ9 zXFKZ`C+kKNIadZdQ&VPpzMlsi4*AfZ?afqFySq_INSvC_H@e@PtwAyLi~nHgnt-LW zPH#9p6jbEL`%AeAZTS&%Zf?Q@E9z{d|LZxW^02$WdT%cFUo%Wn{2#X<>yzYBsWJp2 z$z6M<+v3BTL?0K|39{N{ue)x#`na)r&+y`1#Ka>S7Vf5klepZ@Se`Ym^IAairc7Dg zC%t)?8LD?g^~SKksD>f&bS}v6w@zx}qQkFQ_j_KT#wKf|fKm9HI&IFDjE@huKfSzQ z>XsU{TefB@ep6EHyPwn6dOR|a3%iQ=>2BFNL(zj%y;d-a}@!w^n`kg3$!pKyCo5V@Z3)|&QH zQB~~4~A03ih^&bv6#}#n$0P@Wz4hLiQx~+4>m{{m~HPU%(3`_vxE*~z{zrQ{eDQgvp zAbay>;Bb+@U(Z?PXEEdX1^GbA7rL#eZ_a6FJK)3^6ZxBHrw8wtlT8%uh^!)dNcUg{H8O zH8aBK0>~G2kj+zNQkWMk+W^7J}0_{IAgbqz+wPD133@+8{LOYo0 z>WiCJJ_69H%xIMI0B;JkXnrm;Na1r!{N0I(iz|%tv%>j&Cm|`RtQE9%mIyv+A|Y2d zB_aw7u3)8WTHl3<+r0lyM556ot+9QM;(7AtA7w7ul2V{c)~ieQ!Uq0uF^!d(8Qc<` zGPB3S)E-y7LVr2Y-*NnqC9{Fb*+BL{4N)v%1lXJ z5u}7KUL2@i&Q=g3MCV+EUH=kd&D2fHCG2&IUYcJuAZf9WI(hsVNVclXi$EJxwmtc9A3OGI`Uz@^7jh`O~dmoGh9)>uvI zf%q`kFqsm}uOfJ~k#ZB~U-i5^h@5j-`y|HDywqGmg z4Vg1mIzm$T8m|8bnJOC?tTejOC9)N?eG31J1f#x{bN?F(N|;R)rSXPfYW@EqSR*4t zUEN9`6$*)1NK1u*jmOJTgOV2P{{H@@oglp>Cntx7hN`fpi%7-ch+BI+>yb;x8kz0 zlH#|!)2DO-O>O`AC+16d5*x$s2W!9B7Dk?TJ2K@16cmt+T#89Z+B(2_^11 zIYRjbZ*Yj;yS~T*s!*lTDjBt6j%ZQi7 zxaI%L{uzaOlnlt$uYnzjRG*>IO{Vg_1f@FKp25dYS91-iqVXB@YFJ;!ovUemJquf;!* zXDK~+=g><-0va;DX69t$vzEIkPlkQ?(%~n3v9uh>@F*8DNPOy5xvBUMqq$Td;dJ!T z(5ZpU`>Pmn9NFtrg|`%F6#A!>%04`R4JTi4MHB2%WL1Ysc*tgnT4MHiWJ!OU(8J8v zQ15s;c&HPk=SD_|j>cvIs;Um4q6})`q@?_h$Dc0B-wVuoLCd!4hkr=_&D{%l!U$yV zfllabjc^u#z6p=EH&bOnb*$ElyO$DSO#fuW?B8kWrI6Q2(GX4V83jzZh67>sh`nXS z0fGj?0{Fc0uDe5o@N7|UX2r6AbmeBS1~BKCQ89v|vPn94F8JhU-#nI`10K?uBdiXn ziW<&ENRB*SIz|ip_>Xoo_s&Y8HuwKg_SSJ#Zd= z2ugP-0s;ck($d|zNEMJykz9myBi-?F zGAbh{1Epx;@y4v&gx#rQ3sXCvT=(~Ei1?nJ)?s-#Xx4N0VATkL5n*Cy{_7A5!Ge5F zdr+UiK?%qz9;?`JI!2c=sj1*?R&3vC$;E?Eom`<;(25j{igfu(V33(Ew#A^ z`{Rz@ai3b4lOsue){?5;ELURpab0@;AO7{TFsI}D#c2LZq6vpMcOZl4J&RHXRA4=k zqh>h4rrZm3672v$QVjNtve*-zUG*LO(1WrXr8w=S_yM zC&K>PPS>2gH`OnfQZv11PXWRgZjSJF-1Smkc1gFD5m2iW7TtsfZ`3>ATzP^0FEv6% z^XzbxGHX)RH7K=nE3*(JGh9C7)R}{H)jeE?qA~`Fsf*p>nV)R=v z0hz<=YAb55`+NQRr)7FfRGEJ6=70a>+{V>Q=bemDe@OCoEdn`*IjvK!bm`d_&|}ct zBRKk5)ToMJ0S(1tAshV$_5r^CRz`4t@pqLK!D94{I|pAK3SWH&se~u+O`!XKtQVH~ zrpG!PlIcPr*z=o9P?iE!!v%c|=l@|$!M31#7{dSe-=PJb`7*lq`8tf73)B#QR^vP) zHi$GHo>7C<6}bSl1NTOE@SsmGgPP(my7LVodQ0txM0b{Z1nJbMBJyW_VQ@|P7Z^_d z-iY14gefiuHzU|E-45+*bVX;4I;DM?g%^lmK~nB?BtO0!Vz=7i+j^n^v?s!Bm%;`M zUb)Nfbbw8@pC-DW0j21CyNh@}3BGUh(}^74qwHn@4W*MBxpBhi>+i3WKp_#D4>zI> zgLkU8S!Y5qOX2y;>FHz8#`UFCB`1o@W&e_e%j4?%zGn;9mn99`uCha@DZNHK^N4jC zYJK?;a0%2vv2m$A38LlX;~D1wGW0*i`g}VvLH%@=G*Ru`7&9@kvrY)xWozGLC=?Zy z8)|#zr{DUk8g4F6&DfIiM5Nf_(vsds>-!3*@#VI+~BZk#pGp8h;G+u8WkK4K4b5rRC+lw>g*>mNX-oi%Uvq zNQ`uK`!W3vwW40kGKY@KhxAV+;OX32G}|xU-g9@uY)(h@@tYh9lhO( z=0Jfy$54RZur#^Q@qmv%X_J2()M)B2%bKrV)0NXW|Cilf4@$I;S2rn|8>XRAFnn}; z->sEp(P3Q7y_}4j`*L?y1Ua+w_R_QEAteHWb5P}h3^M@kudj6=Xk88tw>1Qgo8aal zLu=&QWE<0n2sW9G;i))|rl!ZYZ{Hpt<3y(Vw*q^<7e-Tpawbd{jCvr){`{FPPx~Ps zpUTbQJoyxUB37-1LEu1LIcv@ZP2--EjOKcWJ@|yn@YgTh*OYlg0p%y#hVz1tpijJ;>IOeXGCh#JLHX}AzsW9q7(-Zn(iWiK=X>?E z-{nC0l|F{#;ap@4g|3;I!{IK5>-o@Or$?&2*Z+2*kCPdQT%7Pn`5eCZpi3szrB<4^ z)o`d#ukd&P?>Ss*R&1R?Z>Es=74ODv)!4xzZ?Ik_&GOq})^lB<5>Rj}C@CQosIY^q z&RkPOuk91eN&ao2HDh5DLfGL-mpY#HW$R91H+}ZTUln2FvwgAMNae(9XTEl@YNdu= za5{XT3#|O}?|4)@MN}d<4e93R*S>ud%f46(>mOL@^rZA?X;A#3KE^MeOhRyP)IaY~ z3tR^9@%G^qyI0{I4@j28{1>!x)X}kxkRM;)bCf?1{1VY{ke|Dy)9MB2I{uq~@F8q? z;X11pRQrmtrRV#T?CMINEDL>%Qxa>%OQ9GQXnky8q_r$z3C01JY;r33af zpB-y*#OSF0(P65(ni>*eC7e3&S~kyT>;gH*g^SyAcMU)P2<0=R_UM$$LPaO6z%%nc z;BarST#vXD3g9chsQ7L?htc`4{5$6m-Bz7(1{3fv)pn#`6Spt?<+vYQf0$8|$#znD zGk$K`*W6T39|Hh4)ExNDk@&?&Q_ViXbUEB+QSI@;4D6OJ{$v4+jEyJzi?23jY!FXe zC4uBh)S6>6-54slq%8Q8ipg+scQ=PbGn@^e8uNZA{J)PAt8zuhP_6Th z?)Qio^(iOAhbcs3%u#}20=1e|_65K{pwuDL78b*d9Khg6yaaYbz8Ppqmjl~GGx{{& z5c(Y>@z$Y|?-_4izZQYw013<0_U)~0N>c*^IR+!VDTOrG)t(e|<}{X}R@3}l3hFKF z-@Ey~$&bu48sCJ&H=NOUKAbs+9DIVf_#pLZoA7ogS(BnpJ_dVjA(HdM&wqQXbnRXn zMy-msF`b`EGGa>CmIlsVpRfcHjvJ5_VRL8U?Lr z4dSEM&%?0>kNG=@u|<0ega3BWF-63xvmw6lTuQC$!U#3Zj_wP z_V^ka(U93gbK(2t5)km%s<>vzH@G<8loy9$hVuRQq?0sud9Fvic{)NNTycT|JkMoS zWI6@2HO&pyXdcr`zsOeUY=*;4Tj072ntOAb^P&U20g{kjuBQbWC8omtG_(w%j3>zY zM=T7dOY=5(bHvUJXPRHKtJExMxU8;$h&qP=g`)o;cb^3X!pA#r3DN(J`5Y1rg-(-?U*@82!jxqB~Extd!(MYeyQ(oBM5<6~@ z*rZ4Oed#}ULF3|@;P3x~%56z^_)$Ri&)j4VsI9hI8m?!k|M)U6@J?cB`AIpeG&SmYoEt!-S@DSkL-EWbv zOsQv;kYr8lN56RX4iiJCP9=L-fkDx;xNxpNw~69Q*XCG0ObUvnT_VtK+!$cK{R(K0 zl3Z=Py5DuMi*HbtQY|Q2-jHVqCWmZlWJe~TA~XS$*B)^ zL{>)yo*Nm}m5k31((jnIF~LMLolbPu`FT-Q!YATE(hh%v;$}BrP|7rz>oUuIHTgAe z9%|wX+X@AMqcMT%UF=EmEDxA@JU9k*s_&^XRM&Hpc>WjciqSB_2JysCD%uc*6P>lO zBaEv$yJOfSNOMsr8kP~E*7YN?8>wP!uNum@QN&E!!zlB2BG$u*Z7|PDjzO}qvQS}>eox;h(R?3JbzzM61QZ1x z7-yDCYd6&DL5MooUPkXqT~A(mNliChUhTr@I+SPpXQr-S?+e62E zc0*N7ZOYZ*+o2A2|Eu^U9-UBjO#&34SibWn??o1(qIUZJju$yb>(*7m>zH^8CT3>h z4g{6rZh-lq2Ktlf!^8I!gGCQ~Iz9G*rTQ?fiI=BV#;Vv|Z>0;hKJ7%<$qru{~3(yynE#;#Igg5Ts30eK$P454uG%zWhe#GIVU(F^LL# ztMa27$?vd+Q>(*Sw@_F9wM7mpP&|0_(!4kQCS9{)#}yg`eH%&aN93mH;22t%V$QAe^zO<#-G;IK&(4I!AkX`4pex%Y@H9KZ5Oj7zvYvkRR+7UgwDtU>FTJ*p32zkM=-)Y2N6SUnIy0Ln;+FX3oqL^mCrWX{n zIR6f6ft|Tz&pkW4-?I5;eAYTO_kZAL`A{eb2}5;j({B88E|mSobE7%dJnn<^rKDtf zZIXO9K+F7Tk8gf@a%ac(tzVDR`2P{jlNtVmiYIbaNyKVStqu~gm923-UZrN_x3m_- zhkMm#S(7;aUy_GhJ65|kVNI*m(P?vY|3TK@DL`n!;~PxKsj7s8nozWSvzrg;W5^k| z$e$+S`mf(zOW=I)2bhA?E{LW}#%1>xCFnl*Pj>ZXW;<@Vp181PQFBoZ)=Ft?cc#2T zbco3E+#6^dsiqrt-CjzzZxenIZ5gdp{r@~Ug^M$$efIujKPuHrun9ZL7iT6u2?tc0 z_A9@5)KSoiC#im!IBauJE%t1nb<01({{vt7=6(-1jql~>I0#4j>bEjg^5Xj7d<`|} zo4>aD@z6OT)pp)eYJjc9;PxrkVYt*^b+6jVTRHpV(#mL0cL7D^a8py$hf2K;flIe? z#baG967Lt5mOk?=ZkJIk=fJ{J>$nyxzJfI?-*SxcIP~QCx_jSj&t`&at0IAiJYHBO+lzQ3Ia z{boD9U(3M~JKY1`X{^7%1Y{v=ep^Lqo429`!;ZtZ=2M>UE7~@oTudm}d-5F*mRX<4 zKZ%H2_Pzg3M9?$N($N&-92uBtR}z110Z{=-HdEV=Dav;M-weOKr$J_ufow5NUoIh{ z|0%);+lhJzN{t$475~gcIwPKrE8ZWlzO7oE?gMr0+7m&hR>ZbeN#;3j{le=TK~9XC zL001`GpR^%siXc-zNl5JyHkGhUZ%ejYcEO@uqB`nX4* BsCPXZ}Sw7~mT8x9`y{ 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ΝWY=yr%QT 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 eeW2fq`&kI>TM;| El registro es un objeto bien conocido que otros objetos pueden utilizar para encontrar objetos y servicios comunes. + +**Ejemplo Programático** +A continuación se muestra una clase `Cliente + +```java +public class Customer { + + private final String id; + private final String name; + + public Customer(String id, String name) { + this.id = id; + this.name = name; + } + + public String getId() { + return id; + } + + public String getName() { + return name; + } + +} +``` + +Este registro de los objetos `Customer` es `CustomerRegistry`. + +```java +public final class CustomerRegistry { + + private static final CustomerRegistry instance = new CustomerRegistry(); + + public static CustomerRegistry getInstance() { + return instance; + } + + private final Map customerMap; + + private CustomerRegistry() { + customerMap = new ConcurrentHashMap<>(); + } + + public Customer addCustomer(Customer customer) { + return customerMap.put(customer.getId(), customer); + } + + public Customer getCustomer(String id) { + return customerMap.get(id); + } + +} +``` + +## Diagrama de Clases + +![Registry](./etc/registry.png "Registry pattern diagrama de clases") + +## Aplicabilidad + +Usar el patrón Registry cuando + +* El cliente quiere una referencia de algún objeto, por lo que el cliente puede buscar ese objeto en el registro del + objeto. + +## Consecuencias + +Un gran número de objetos voluminosos añadidos al registro daría lugar a un gran consumo de memoria, ya que los objetos +del registro no se recogen de la basura. + +## Créditos + +* https://www.martinfowler.com/eaaCatalog/registry.html +* https://wiki.c2.com/?RegistryPattern diff --git a/localization/es/registry/etc/registry.png b/localization/es/registry/etc/registry.png new file mode 100644 index 0000000000000000000000000000000000000000..6c1c5b986d72cb33d1806c8d43ebc4a31e4927c9 GIT binary patch literal 16875 zcmb8X1yq&a(=V=chti-lh;(;1NFKVoyBp~SX*hHpLb?QzE@`9@5CQ3uZn)3U@AvoK z_y69z*8RJd%XQ9qp4ofPp83q|na?&#Sy37tg$U)@vuEhCG7_rKo;`O4{&FJ00N>;? zNJjzx(78!!xtTgTdE1#=xIL3LcQAJ`b~864Gw~*~a&vRyV`g@;Gj?!ux3^<5b+pH3 z;Uxhi_*koHx&8b7v*&;quWWnOF{K_BoKEhwK(DpNemlYzg5~b~$Ty2AEL|Zd%AY=S zI2=x4qLJSpdyFcGBpLj;^KYN`c!P^4hwqJ;%5&307!-=nGBHo^(=_a7_?v1>WQqiNcRI?KMMt>C~zMtdld!%68ywJ$FnNM$_& zSt%KDnct4k#6YU5ty%RxByYi+NeGst`By*LU0Y)H@881lv5(#Fh`nW0oJMF&ve?SU zT|nGrJT`iH$Ne?i!*sAUsM^(N`5}E(RJ>>Ep|?OgK2t}EyfW%T3j0p0f6Z}gd(efP zYNRZ3`s?#**i}?N(zFU=+O}ETr1mDXsN|TSM2FeH04Nb z$k;sUdlrs$8WB4*ydu(j`QhB&>C2~Q&xEgJB}CP{3=Z`XwQw}?XUnv(R2U=}2U5JiA0st`*pWh%)B6AdqEr$v!uWiq4n0)6g{M_uhB zVy@zVcf$w<>cQxd;Ofn#uj}?$mdi2!*^h%Ci!c*Na4_Uo$|5#oSV(X$MZjWYSS~M% z>3}b}MgM*n=AdR|w8szn@ana200a7~;8~GO2$>!V7SbX)6O$qlAKXV#MGo`sV0h-$ zG^EfcBS%MJy9E~O9jrucw^c@Xgt_<7x+El|-$cl`3eV_@QA!C|REhiDe|U)%VKbTcISs=Ml-vm$2G5 zho4rf4Lh0sc@%86w&d7p9%He~Yq40aD#Mgw{A-=C2@s~&>LMyC`XRNrmywRk->ZO&Sxr>jx4(Y=oGb^?8si?RXff!2c1xs?tkA3xa$fJdyE<-AX9$)~ zcrEDi>#J&s94{Xq0vw!Po5x{}=MOrSLO48FSlBQRst*#KCo#eg=P!r*qj7!Dcd+s5 zm>DpLICiw>lpGDbH*p!lBO**scD@xc>NfYu;xg$GPsSHN=qXZg+AaZJMMg$m2b)A5_MCKu^vB>wm=7gUSN7~qmulw#(`t%Ggv*?uGZ(z8N{rXS5{E* z7$RNHw#F8@VHmK!on&Wc=aboeTU=}fl!D~h?Dezjxv{iKZBu=PvDZmW=c7qXt+S)U7)e;(IM;lr;} zt>4Cl;r@7kW0%^&ZX$JZg7#W~0MF6UQKNfxl{Cg_eY#XBGi)u6`$rdfm39LS1qDo^ z$TaDGP&s%CqCl)QoI>Zi-iK@8gPpBQy=VPV0NIk?GU4BUd8 zC+Ms3#cOMnu$jkoYZU*^8`-X^(#EV!t4fEHVLXdF;SgRQK2Nj8KypI*`S-yJ{ZHy@}yhK7b}?{D{ODlzW#32(WE z33`k)g5?LttKYv?2;wlR11#STJ0hBXV%X2TPQ_0^I-bN>YShZ;aWrs)~_8JObmPW(u{|7gCEd++*UrH&Z@g0Jk4O8gR`(ui78e0^88< zyfF~<{SMQvN@$klOJpVnUYqA}hs|sSjCRiRyq5I!aYHg&rh$qQ2n2(K2g~LC3BGNC z$lR;ks?99uN_5RYjQ&6OM|1c!t>j_>^D<@Ja()x|yBo3c6tJm99cSAf(c9ZwHq>xj zf;*#0=d&$^=I9y*F1h$jbQ__E^JxGr>QH)KNp=BNS`d<{fLh}u-_(kSE>Dm!(mzLi^j7pIRcSy(5X~FYFiURLVC+Vr5T$Gb*7a@qsxP}Oh_^A^(>a- zB#TW+l3Y2vD{b7vYinysP54ZDMtHuycYw8YtJWB_CsE7eeFYmXw>XEWn<@q0p6`a7 zZVVekg42NDT!z8~{PiDbGpG{F%imO?F=zz0RaKCyl;Ec@E|;YKR*;RWVrMA-54*%_gS>;iWw}=V=|oT zBuP4z2S-Lw@s>xOf8oAWGtw`6F9U-5zgbRGX{lv0z7hwzWB+i{BOUATobiN}vs86; zHIK|(@}evK8lnB>a4Kt&amSl{%LMrPlt$4I1o!^DmiH1Es+)bYkRsd=i@IBG5FDjzEV`>G^tfvA%cm|623;*=W8s^OUNLDTcvIR;X zBR983Ge#D(uUHlm`NA*VM_5e1r`e>QHhDOG!6aTzc*TE$ky?R!M~y5EBL+K zmri!Y%t*>8+b2ME?Fp6}&> z=x8hfYcNDu17-?G><0xUWp8(Pfow93?R<4ybhI4sM?oP~gF*`{#ahnJj)B7*0Ms@l zxT0?WycSBv#J}SA0CXD^6oi$2xb#V$9$PK8v5})3ZzqCHAqb2Eg60iS{>2_nALJ2m7QYKzBY z@*pDtwF)}gZA85l+;<$5N(czRgj}Ab+Mt-|l=91QP}WevB}2cN!YLHUgxI0$<));V z`LPiM0ZCa3?R3iI?rL9OA3+|P6q!~W#Eh!+X!!$=iC?kw#H8ku#UZ#g#e?Dq@zFOZy1&|mQi`8_24KHR4Wi0h^u zt___zL3cm&pgI^VB^B*Eo=NGUM3R<@77{9QsaSC zpx9fPMizv`8$xY6oR~l>)x3kB_<}JN)Bjymcx4|3iFh*ED{B<;(poKr)-V44zie|T zE{R#iuw4TQXhfxZ1Ah@WawP$JLO`8OiT%Zh?khQ(E+meu6!mEJy=+aVOwsjW8(PBfr{SwXPCAGbMjIZy!{-^Q0nxX_+MG3sO z=O~Vv#DC^yZZkaF_hIMrN=fjkyc>Pq91lTR)JIGGbcAYUJchJ4+G48g#qkrzS@XZg z*p3$JM!UO(-t6q3pNlKyy_S7<@BCB5umdc#l?4$9u$u}gxSzq1BT*NQo1kfWryxtn z&+Bkt7NzRPQxunT9QeQ<+@-}6YliKdrbye@c=@^@j&u0dGK1mZCdiY_< znD4cxo~t+N)dyOI60EePr$Ip*M&(*{Bp9%;BrLqVJGU45j-4ybYIIBW=7+*J#mp~Z z=Dx4@C)2ArmFZl}`rieBg#$^3Q{SqKWH$L-9X%TN`j~v2Dmg^JJi7eZEo$7mIa12U zuh}Of=kg&sBM;n@t*FKxH!)TFPGRxrLh;>i%oinAGs~#b>zzLF3p{;}UJ;&rvNqv0 zx^W9jJfu-)_MVE=p5O(-&KD7tj4 z*VS5Y$UAeF(ffI*Hfd8Wl64>u3I3*-1wty7=;7IqKV`&{i>N$u*Z70Q-ZpM!!9U%z zBd~QZnRCL!n3;mi`lEMuZt6K5SH8#0J>JsCGY<4IRBAV%d<+q9cc#SNGz>r%CFIm5 zq$JXxBP(%Q6T@eAFeg4*?X1w@q&4pSsOgE)Ho|&l2zuwn$C^;aku}4{N!@7GAfw2i zU7_BS7)pFLdzx5gl*N5*A$so05sVxI)rFDWK@X6jiz9)#9V2s@%e`;i8np`IU!gK; z*M|npg|Zc+M;JRACSf0@(}Cpb3!rS=~ClGk;BhhJ0TCPDZ-9z-V6!_!|2 zF%nlZ3c+WU1x2`h-@z=6_Zus@ ztytMNoJw(*FB15bSGrT*aYd&)C&c50areV=wIdG!$Idom-xOdE*XN1gzo*`h>N zg`@4p@8S-ZmoIH>q|0$}Bx+RA5e@|&BgtJmW%F!sEVl#LX8IJVi&_ex8izI&L7sw5 zCOC=B~f}XH^2J|1lE45~kW6WQTRLP?Rly7}K@s(2inS~pf zh?Mosr~-!keM;B$M#8jQdULOl+2g%)<+kawsm5}|Mu+knt+$v~Ps! zINR)mDIP9qiH|T*U5~u1@Ax`IZHuO4*x*|?-9TPWGoiIx(d>$!&~HK=hkMF^@iahP zMW**J_|U$)*(GxjonxQO6s}Gb(Vi-3lc!20(S4OH-HvU64deG5)gIX0U6}O?Ns}l^ zG#Ua2e>=#n7AK=$O6Ha;3bItyQX6@U(hoPH@1UbE{xjsxc{U5Bx9dahJv$C1yCUVD z2fGVox!$}8fTq_%0$*!X*;A#0scoZ~6SpiRn0 zQX`Uuka^}*r)a(uFI@gCD<-Bgu)E41d~HE3;OPLWGvR8oQAbD4?5$CUiVL$vp_FP~ zBI;-_37BXPFg*Ct!sejqbbhiB$3H(9_E>w-Aj=AbQ?8vbzWeaGcO{8tD5pKU17|x6 zLy1MSGAU5;)d_5!U%5wjr-csylu9>@-L5Q~yN7AN)`$v!TrNo0(aX-dKiTt(caLltE z&Uc2m>5b!vQZ;KH_kInP0Vg;84w9OYDU5?c!_M&@=GUc)uN=A@nBK<0ef)+~DE2mv z3S?wZDy?ou+|gScJIx~9o=Fnxds)e#Geg5@k2wsSVmfZN*jG>wKa7ojXv&I_qYUB* zd!qzh;^_YQWZ@V^%PPq)xqqeu^nhqlE&H#J;G>@GTvef_aN*wOe$p(%j zVd)yeAl=n5=^ORoxw+<+B2(>JH*5aJ?4%bAgb8-v&l$I*`5dw-7RDq?67y9RcsYfi zS&DH`E@pYfCO{_*4Kw2d=p$5e1#dPunnjsAw1f8NC*Fb}I2`L!C0+wtW5n^Vmh!9z zeUIH+J(+jEH-*j{dOoek7=OkG_biR|)29{CNu*9*1E#z+o03wOyfNs{^bI<-h{5ZV zF_eSJ0y-QCJ7kR9kmn;O8^-I$o-D#i4?m=9vtsZH=}PfN+lJeF<1_LEI0JJF|4R87 zMV_@>;wUje@}3~wnP_b<>t>dG-mZBjU7~uzfk`J4l0p9^5(c_`EDh5QY>FG{qv_FM z*l4KPZLOjc*$;T4c^*3r|6R{V=Oat=gEKoXTv@U;(Z!cZ@l>in@qvuxO8n=GQ2juY zzEY@v*f`yOV+~kZLXW)-dx-&LNk10q15XFTbBnbQQl((5QB-o}D2H&$x_22iI65A> z7Q_=(Z+-#^*V&wJTNUMonl+VHK18pzeq)R~?+H1+3l+aPh0%6GGi@_hkUop+!pZfc zL5+ceUwv_n?x)LfFekW%p^YCkA38XMUr_T}V53ngeMOidR$yTFE2_gSmyzkkc$qbN za3Sb5GF};7J%<5kY8ta(Ypr*}a3m$Id3!?GR0|bIv2Jd|pR~2x{`h7>b}oB;>~zbm z;7eLX*+{)sZ%vkSYCdu+`GwPK=Va3rUpsp%eZo>XN>O>R%Vg7Yr4De*8L2=E#KV4D zDo$@Ofz+rNvfPsR=8>N%sH20?(0eoW_QICiK`-IZWVz+4y?x*0caO(ltf3$4=*S3A zW1+pI@YSCq^_i_u$K`yuMq$4WxaqxpJY5a7Ot-`g>$e?8--?MljZ+@;m~_0jLxU}|e@RWRV5U03gmmrD#@?q>$~ zH##%ni*fTfwTd}5Dk?#rE2%sw6GYLW8}yzx=Y{mFERY)DRnsA2RFjEW@{*`t}j65f49-ifRU%fgk!u3pmV ztLb6VvOqBXs9|72Y2)KN|FDT)^y3n8Y^5#_AQrX4TIadS;gt~HhrgnqmlBIFe*A3I zeGLFpedi2sV1VlwSl#2;pj)F#kN4FJvSPO!9&BFAaf05DW}f6+OuAhCU)zH1K;8-< zn0MAxR_{RdO*;nHu@jr9NCYuX-EpXw8-u-}U{EPWM7z(0Tp6$Rlu=6E?0C+|g2sF` z_4)2}&`J}ZXF&1*%i)vRF z8wTC>X5Q7O+S&bw1ECtKR{z-XmK8-YopUcn)%ks<7?8JQf+>zZ9eiHx41Cs$ z#Z`%$O|A>l>+p8v{sI&#MFW_l%lajN{KgCgI0&rDcgv-|-O0MkpN`gy(yxK48*XD` zP#BZ+$65Q;XPLKOlN^U76u#k?+{e2}0n!=4Nomc9^AD$+qnUdPbq_Zp*obK@%gy%5 z<)Da$x_3Ue2L{`ICaPizAaLux&+6O%G5wRv&9yrQ=dM7|LZMHYa4q90~MYaF8F_; z+c1mKbxY3{h=!9% z5VG92Os-OE>($Bq@WPWfw6ZPLy>F@ew;ZySIX+dORv-5g~6j zxo>xK99Mrg0*$A=PgB27F)#JneOG(s+NMbAV&ErC7$PPHAI}1+_=`uuntG|1Ikt;{ zHR(*H+{Pfv4A9m7o;CB$VLg71H*D8zq6Lb562?bvI{jDVLsQoelhVL1yRHG*FrU`> zMBuY?=!2={)2{bECh`fMlG~0lZtGC}(GUDfYh#-@rIZVWs<=SR+KzNZ)1%%kd;$=X zYo2O}UDz7n>my*!@*fE9fwpOW{UUZseL6UON&&QFi(oVFU@ z%=J0?a(^FLU3T);50LQB69L%TSWIVhP)>GryvocwjhI)bXNSxIY=8cNd?_Z0R>%#n zP6o?br)49MahaOt2@i+|N=e9F(%%V4{$plcwbSV&j~#P8PmALRdnXUi43xX#U#)() zpD?)COZ7O^8E48*oUm$eubu^*7YKQ=X0O{3weH~WBWkXanxERSXw zH0dg*lbD7g!~ctO8XbZuhRFL0P+YA~G#OjRvr9g1S~C5?xtjwwDbs39*O!hH{98>i z%wMjP=L`eG| zeBtUB-o2->EW5OvMBdP|?F8Su!{*QFoYZ7S3_2fmKZOH18E|m1V|=TW!$)$tH%s3? z$ehDr%`!Y&!F#yeI@#@2yMSw74=-eDa#c+3x!BWjgL8Ob8PN z{_!?)rP$Hcqa2?(m%*2{^YPY{U}c3}n#6T0Hj#vD!q2JhIS{m>|0LulzZ}oped-Tl zN6GuzVGO$4#VYBXxc*5EGSmmWC8aEms2S{DBk(XhvS@{EpdWn8aO3nh{eC|x3EeEf zVQrbN^A>iKH#&a>W;w<(n+aO|yp>s|YHM{WcXz=Dn#C(vNXFs?T~c9)8x zc5QCbV*Vt5&r9W9kSvc*w_TAMF2WQO5YY`u>$1$a@tK+q`uk4uW11aT-GDI1Vt@r6 zPV?R~aRwzx`WO6l3v_(fV?Hg0vufBy`SLdrSW6Uc8a0p6_P$S#&zEnLlG!7c>pNP> zR7nde9TQqptJCKH*>ESHiyQww#U};_@BvSlu&DE5EuuL$e%sLRt;+g?{?JMi-WQ>n zD*JOkLJ)4)icUsR@ndY|@Gimt>jU7}tUb9reJAH#`*k^I5nu;}Bw}dAtgt3akdnh7 zKD`c-gi|1C@Lv5oP}d>2#iP%d=ZgK0^WzT5kBkT8it{koh^0FI*vzRuh6}4V#vFEF z@3t7K35)L@#gMlasp#e zy|zcR3sN_5%EtE#*?mJrQnU(`JAV075)UF=X4roQADHp~JN&_UzA61m$G)KpB%uR8 ze2*Vk_o9L={0Js+?p-6Wf*n^sWi zkNs9xg$6Lq?A(2h$2K#45BzDpUkStSAv>tR*%(OAl7zKAcp-9AvuK9Y|3uAJ#cqZB zx4GfWkk+rHxKc`hFTM;o3xAG1R}cQkRnVe6Tg+PHjiR2Kw)&XS|Mw6L(Xpu+D+oo}My z;;iL{DDjnlZG@AlQIg}8Ti_`IPyxuYVgKpkDPV2ZNs_bTR+N@N;{(buZsG5RnJh@2V*S5ld)+$Jyo{ z&2RXT`c=^fl7eJksjUB~yOjf;TjT)VQw*)v^TiCD7u=tzFMV?SXX^TCl^h0K#cCa$ zQj;t2e88{_3m+4{|6^KSNvO@pt1V=gqs}Td*euMUa zV4;tx4+pfSES1Y4T9$l^oA&!&MXhBVuCXFUz*ku6VpBN5s%46x zO1_**#j6jwMI};aQ#+%qFhQd3V2bdjlH{saLf-9`j^*m`EHr;!Yl3L$@-2c(M!0bT zT`%fMOXx>YDA@;*;1JYphpqSJX;DuOUb1b;m(NzRu>JdnG2h}AvTKnJTAI$-f1ZxU zg(T-(^HPsi&kh+T$ZKX`N?F8XBcWBy;q3PvDdy=RMWyQ?!^OSlkaXwyL}Bs7pIoc~ zBT7l8pz`YVgD-udTUO~6DU__G^UOM$C~+a+y#F^`d8)`Hj0|WdvO!pa`r<~e3|;D=><{+qII;KvxW7qpbkTsD!AZ1QE;JZ zv0)n_KzN&uNGPU9f^!eykZfO=^_b~Ly1k6ZXZ-*v!#_X76paBU!<-v&ad!?0F;)=wlBSIEd8FUo~{j*(U-jya?iuBz~VSq5;*PKOha^ z^=e1NE+&oW6fRuwun4%2@ZeDB@qTX%DxM7xj}VAxzcjrG0<@`2CumuN{MaIO$ z^Z^!NxV#qh(d+QbTm*qYOU?E%*wR3CqvPRHR}?6B*6kc0GdpC8QoJ-FL_tHVR4Z3K zS?|xu&W3@3aaj2r#y0oeV(sp@Q#$9PX3cup!NCE`eRo%c>@!;`28PkGF?8vvGL<5L z24cV5f<5>ikBH0e8XyGLt*o@VT2AJRVqjqKv^|GKSnkZb(SdEg0dv{{R0?xbQ%bAN zX~f-($6`Yz(-^qmihM$asJJ*mfUDI|`C|!SdXbWnS~#wJ=HxpA*nib}t?P$}j7UM1 zuf#%n78@-48QFKHQvl>Fsx=+NAYg60xtKS+8GeQ#yO0wRfjA%})+FSAyZptQT~P3q zNl>{)XTU>fKfti58}q%`n*~^pjhN1&pd#r6Jg#Ga6Lf(2`pfyz*J7c(JZ-6I(qN(j zLIrF}a`NX_-Z(5eq8qe|*+w4O&tAg#Um6D7z=ySYn%DbYSPz%Tr=#G$ZM6DEfu?k> zo_4^*!*e~WX^2~4?9+b$9NGFQ+!VAJ^jZMYQjHvjgec|9tn@rd*mRY zJK?AMke*i8?F@Z1fAA@T?R=F^Q;%X6m;JD!glgvMD~{kA8VAsquPNh?@J_)1)p6wO z*PqhjFjlwX%8WA~=}c<7d&1F)ST4i;Evusfas zG?L_&C)kAxpbQ02nC=+%vnZV%(+`-as3ZgwhcrMe`ftgII+0lN=_cwS!cZg$n+%6! z3;N>4)jC?Tq*^W3mrU}q2Jg&%oPW5x0+?3OLGPM9NTPCbUTv{?9+}Zx8+`F{o+_5r z{p27y-%nsX5KBn#sMq53T>M2dG6Ltx$qB&e?CCQ8@x>dUIdy3qkdFYING1|vfDswC z!f7>WbbmdnsY+Z<_vY^Q_VRG)Y9Nkyq8fp6gNbTulxMyhIL9>OsCV+)b|Vap>*YL|K|9C&Cvh%`k3RA z!0OV@!b!<@xL{r=B#CGg4tw%k-Xz6JC)Bmn42GV4nLzZNhek0t0#b=FEZ;@f5rWTiQCZoflU8H z;EUH;nad$aD2KU9n(P<945%^sBeF2NHZs!!Tpnv`TkgF@d*h3s561v}vQ+nxqBRXA zrNYFSe!SH~8oDnb2{JMOq!Ood9iuWX8yny7fW^LVzSV2 z3iAh&&HFu$P3P}9AKQ|mqP^@+*K1824Hi$>JEJo&{ru#&4hc0-XRT2L`d(vUMd_>o z*_kzoF6)2seW)t3fhiUo<|XfmLV&~*+4&@{V*cTn(e?&CDoyTRA`rZGw-tPHJ~UJ8{SE{v z6P!E&p?deYi09WljYYT#_~|vz6P2M{{M>Ef~$;^*T#gSK$u-GJz_a71t;1(>8ov4NT^ffZ-RflR|Xj&m?>)cS=QPXKpTGf5$pGekDro?pORTQHbt; z5QT=TmS+2~I<#3m545&^8j<3hyZhW0lqw}q(LC}vx>KA84fXwG*>&7DW}b+ zeEs$^K0arZn;ueHIx#pB)E`5uS@u)8Y479Rted_mTyIt*Pl!N5{xW={WpS<$r8{J-^#-M!!L6GhhMZ)2#<6K`wxML?x%v>VuoD zV&#(3H~w--O5JXRoBlV@6rHT`YO93g^Di#oXxEwW`PA5r0WH_Urq0J`(->A(RNJ}A zp1q&%9hYS!06Kw~vXp{`g(*532MRuu+sV2{^V;LX#|m}V7hGR_+)Hbj8NM&2GXPyg zDQY|E+h%h_*R>uzi`6eT{811yU%sUFkXL*h`ppck?;=31?*0n3S&4s5mUUq(E|OC9 z(5XTL*%HTLRC7eSP%MUP1E9zR#6wt&6Bhu&RBW970z|AAz*PJ0r#R7pAp7id;Y z0vu%mD}^`W-!rsW3Ln_a>gb4zUOt0Ojd=cks@@5OeXi*4a zZtfCZ)Ue^pg1kOJ2uxa*dHQD?n8vM)XRcJ?*COq?HS7le*ezB1Udg|OM#$C#=XIqG__^jwFLmLkn~^7$#e zD+2gEAp*wpJ=Wm#f7T693Ld?Oft~0foV_e-@Efey{(d5V9s!c>*i!YMJ-S#26LT{x z9bI6oR%Y;fF!Tyg{9oBleS(=6Qs)yu)3VmgjEY(3*VT91R5xuUYA2Q+oTC3?I)TFf zJJV@ASECr>kdR>bcJYIu-Tcu7b0!`ZKuBcE|yrD?0XZ1+0&WJ5@4 z=*X8;e@-S;;W>+X5SECX(f!Gwbqnprks#pFbHvV;4&P^BbwB`_keT^YyRT;bm~`A; zoIUF?kB=K{ak1sZT-nA?BVivmQmf=~9)%#ZIFcKOFcb`)@b67I_zVQh!2Horvoz~W zcn`!pbbn8kTwfk$ty}5qRrp`!kRsr(OVtbJeEsU^rO@5fQ({nO^107}De14H0Hg}+ z>W&u*QD1Mzmdcn1TR5B;bt>OTU2nckJO1rZip#GlUt#ZZoO^f-sto=14HY<_j4q{~ z9(R7iVKzv~v&oG47wWxTLvrtrt>TRDlWvv-duf4JHwuUK01>;l7OK8KtkZ- zs|LFJgNCagft~b@|ESWe7vNw>tL+zatkP~7dA*Bc(#Sn-u$&mSnayTtq60x@K9H}l zO0Mq{Otg7knHK)q(s)>IRk+u2P2>new3fSk_qgC_I`TNMO)dTKqM>~S%8|N;MB+*P z!L&v84cXHpCUKJ=J`)*NrG2lXV;zN^l;+9LA8~B|f_f2BP*;m7z^2IRK>z6;%6h6b zdPIshFt-y7rh20RloJ4GMDg;zyRAa^?f-lgNy_aFuqAdv$#%YO>31V1(gR1ZsE@0z zy1k#O?g^ut{>&>{%!0~L0S#c8{zEeQseBT}#*k@9tb6iFU{3arR0)%DS#VFtpA6%V zTVh4=(gJ}d)n>T-=J{{D#4?v$G&C}WM3EA(7?n+AF`Ws}AX8+_0M5D4-@w8N9Fj1= z)9OCCVlyx`lV>;>Krih7B6SLff_0lpVXZ(_p9+|7UNz!$K%fccfiBlzshuwdm+$}u=gJ>3lP9p{ThPk0wr_vBEXF50o@ya zTW+6{p_Z7)S`9SnPaYwp;x2fXpH<}-}sN9Ne=U)IfMScQA278aA`>p;M z-7xgQIA79Kps>H(ey0lr7H$7n4L*09aDD-1V)7oQ+Er?nGQZ0KNqD zfz~=}nE2c7K72g^ZCL(%X|8o`^D~Y(YJwXX(`p*RN>8aLCca(BVm_=)F5`E>La zpp!U)xcVG_EbF&8ksEuyk#WdEawvERcwmdbEqjmpg75}?80f{xrMwv^CZ{sP*vB<$ z^QdtIxM1`(`us0dnCv2XVTS+q`t&3cY-M_d&$lEg+X*F-#@^rrQ0A zKaJDzhw=h8C7^hq|ah2Q=xy`p=bJk_z*f0sXKfo21K+8vd#3Z!|_}DEAHd$MaV0Y<08MrCNd8 zG@mOG;lfbNe|Ql(iz6(COGe{ZR7GLFSQ#CFd<9zj4U$8w84t=0B{WPtUZ-YiC33i0 z+EAYc=9SYqfq%jdryxp**YO>iIWU`;?yd$V7}Z4*6EOn@pg*U4zw-?}$%1w1Q$vIK z=5%RM*f7!@rF1Y0*MO1lB$=V9SoZPTbv6!|f_s2&U_37d?>vIQA*mi=gEkx3-Tjx! zkv>BXcob0W)#1ACje80IXFwgD@2^9@ZjNNS?$(*!p|Xau%1cOWJtJr^=^X&*-5rmg zp~*`#)G9+mNnZ={#p*6cy-ch%vKf23+S-7bI9LIkU0*`>D?gzMl9*D@32mJnB-%8S zV*vLd;Vu@dI0YY+<>a)f+*1lJ{pEU1HZ;vLd<>)oiC!BYI5Tz&O$ShdIxtR*}*^v?Zp3tY)gTqAK z?)&$~eKG`v)8!y`yhZsmzxZ#=g@#smEAJKR0agO1&9BeqBUdaK1V2GVQs%u0Xp08t zVLW~74_9sVmetpNJcjk;JNrv)T$eZOI+c41C+Gl8i|1!1yY!x#M;Q!2Wn!s#3J$!O zmD!1}{VD_Q5tj!SjwGeh2%|OS&7$Ys!u88p-Fgm5NQSEA2olq?0ugI61A+x_lJBtY z_#<+FoypPZ>Rr7isG-~4jZi-Oz24ADjh5E<0Gu;!8A11ra&ibebt-vxCFY6Ke5oxl}tTPTQ`|R*dqLn1R z*rFLM9A%uuFo%14x32wkrmz!V9AV1xv1I+boz{(RlK?vO99yY`ht(i_Zc#H8hGesD zP?EP?Y(^oksH&_-wI(h0ErzTMo(_F5*~@Bvm(4RdK90v9_JW$~zAHBA4A+BkArrfo zdL^cu;v<9aqB-c8A^b1?NNwFkCJTl7k-~bL@J{2nQa40lsxB0nd47Qq7y)J*NhF1* zsJOZKUd*MVr@9{;{L&aVG$g(KfKTwh)}L@(;yncI!iOw<6=1!fZ5XnN?l6;)6mYY$ z2RONWM?5$62T@-QJaTep_+!Zb`0U@l%Mtk(Vfa5#lEXJ!SP0{;%}XTaG_n;X%QiWa zH%c@98fVEonH>G>M|<&DR_99$g7t;Mu+pPVTaz!4opU{p#s3IIAvn3SNq4*hI^xk2 zNP^5}Fjq(V+6@-CK&r)RdW!<J2juN5% zZwY`R==JJnUq;qUXWO5rz;z_xa*=IZp7631RYi($6}bX-J|9r91gaQ7x#GwZLr!-XY}7LjbBumY;WB?Wd0%1w};${3_V zv8KWI5kL(YK@2A-+DUTKpff<9Xm}1z-4^BiwKVM7pqC46P`(M71a=vcCfp%#yX>F0 zySP92@gTpPnFiVgL0FRc6nfZ=ySuwn%FQ%oI?!8PTR;!ze_U|?Z@1n54<8bh!1Vy< zNgocT8|D3YE-6$*C5m?$owc=f@cWy)JEcsv{sa*+Ej~PE1G{@v^Azi70{&g|H*mr3 zBHvKWU8?EM*>GUGb zXgC>x?A)zQOr0R!o7kE-7&w_2lN!2{nmak!@v^YkSsU0oIont>8-Z*vSa}E`AfW6l zR5YCa^F0J4@EW&_L{%O64Pk8W>@UxDzm!8Q#A1Iod4qS5%FJ<$y77MX{6KZya0-$! zvzt8dT}7@}`s$y~F^Ra0c7&7e7@ubXvc z0V6!M4V(bs-P?j~vCEn@CZ0R)$&-t%^2P#V6_H&IA@InL2&54>toKt9-Y|Govau+` zCb~z~6ePrrI(TEdA8p^^JmBEK)r_#y$0Ji=7TzPOFO=GQel9C47`>nh8%klyJWvI5 zY~hYGr=+m!kTP%$yF8JclGjUXfGe&HtoG*W1+7}N5D#}mygej*Z}Q*BlJgqqm<;%5 z3RK_lsGPpVZFJzk;E-skR`OSDHVN#sA~)tx$@QJV!m@zypb)5c?haYO*TFhj3iF+^nTd;_PsWR&IF z1d_Kgww`ZidHgbD?Cuq>B~tK4Cz#cUciYYIUbl7g`Q)JiOB0dX60U;cWJ#nI%WGfw z8}}E9HmQvBC3FW9&dR7S+iqM@6(auB&G~PUT-ETisv+Q%saaapH_`Yp%(NL&*(?S( zA1{$k+J8N5z>ybDA}#CT@m~j4KzOZMxo3*4x)#xMADKsZ&0QXz{k)29R~z6X|4?Y} zx0WDzzFhT+Q*e)2Q4WNm(C zSGWvU2#C)RQsN>iZn_7V@EX_y_XCO)2q9o}&trVgP)Va`uoXx3we3uCXgj4E;|IfV z{ML{UvAMLkDhOZwsc#89Swv=N(OYY-eNCKvM@A27T$h;!e%`xxpiLYd93(8!9d{fY zfp^ehME?1AF%X0*{Le4YVH6?na54V%6dTM16FGuE>3{zW5q7l1|Mjz8^dF5O|9HZm zG=%Ic2;*Oip^FKxlK=BH{-i;lJ0$+KmdGne@9_UF^z!s;sQ>>qq_D5$b$4O$&cAqT zES=klK=hx7VnnX*=sP*FBY;sH^Mi)p;rjB=18U&j-QucOd`i69<$zgVJ2>F?y0L3P zA^Yd%lLCD@ByK*E2%`sqI&S-CXE~{;0tG++>ow?rC?leyqtWVcU0tuSXyh{ZT#ta= zNJ&XKQT|gll;QD-Ug5K)ssZe;2;arDT1maGwv?2S7I=QV&d$u#xxYFL@b{O?cxV6g zaQi-*crx~%hlycCy~CYlcliBbuu`c&`T`P5zqfQZF#%)$W;0n2mr>)#$Or>1EiFC$ z9B>RXR*J;dlA1aDD`}3`_n3;#$^Y-?3G$LN7rw4a0 zCj5UWz4troa$`zdT#d)&-eSGg($W$h(N}UXcj4DddQbkB=T1@5!W@ZxQ*Xnmev9Sl9IfhqO zR#x%ZZ;00{wYq}96h6d z4sC@jJ-SAfemApDi*}nE#&@f^a;fhUq_TlGEzy1Zi}m|oMFOM~XcarW+%cJ{I5_GQ z^CV9weotg~I`7YUUL61)GN2N9;IcnwbFniC?AKp!c5LkM=x6J1b3;QzU@<}>A~L)i zw)MvP*c(Gb@ue0AnSBFc$lcZj2U4H1gMRJ+<*T=y@K|W_g zG{CFgIs8W83BSQ5I{{Z4ZI5SC2r|OM2fsBNC**YsIRGT9GAe;I|4Z@~mqs>C+@+wS zPpi>3HX$!B&j4@u)e;W9%ICwF75);AZt+b3x2Cp-HsHEHMnYh zb0ql!kyl4lRJ2lsS+^}EBg1Q>Hxv+oUWb?Fi*!WEu8)4+PY69HFzevE94GsnW$El#h*>9=z8F*r7D5xw!Z+d~= z3X43+$ibt}kkI;#hJ9gG-j8?A4rDF|V3DY~66N=wayXScTzC|Gz4&W&cr z-5$gL!~}A-AC0sv8Gw;9MJ81;gx%n768iscmdLxo9WsNL__oksv!p-Y*JlE*GH`Km zd44#TZ?InIk0MHEP-jNCzP=8Ar(UT&l=`+vb}!H6n_g#-juPJ4Ao0Gda+Ewy^hhWc z&GPc{U{CrNlaZv|6vq-BCCuSQT3rO#)m%5{@oXXaD5WZAnQMRg1li;}lmS5J8&;G5 za5hrhP`?g|$!O|pxw^(iZp8HtET(Pre6Mh$fvCWrfJ$R^Oro_yF{$)j0p~YvbU9q) z!d%_R!JakSiQqtuCWbKLnXija`n8yX!Q{BvzhAF#>5m>Stn zFOseV#g@LL$s2)@L$cBcd=*t%v&eQ2jCfyFNX0wSbAbEY(JMIpES1nTu6x*MxFq%-kT8*vO#^IkghW5F}JbQu`y5V2W0+aI%PO%Kx3D{ z#$yqB)o*T2e*s#JmC*kT9F=}Re!h_w0V<()Y^(yvN2sW%i45wxHO7cAHQV&}$Cy}H z_ZPdrc6Jcd4Z1!<_6{Izu4f^un*n;t_PHwoax;*T0RgrF@&u$5o43qMucxqC0|~^d zV8_#X^M9uKksiBMa>FdIs|7PIlH?UG_>SkNdqN(Ea@}@(y>Q8YaaOX#OLxQF!0~_27S!^?t<rIDB#*j5^iuS zDr);$uMiRaG5{NKCKS2Y9*m{<;r110GRpp+8la5VsJBd%?C7(5Sot?z)j;q4)#!PB z1ms#Fj|*Bly4~3_btg)R|HZy@2&Xp{y6tz%&5l5%YW98hQBuMrlEQew(YZvRENYrB z133z`V;9t?LMC6|KE{{<=6K^Jm^ z(&1>arQZth6TiO}d)arj!jBp89NHYZkYYc#2f)T~(9!LHz~s0+{8lenIRu)?tJIz1DLwt1u2sl6ji2~5Y<}eO#9QjL) zAkOz=O)Q54i;Whoa``n5j>(C7>dP-Fk^O-4QXv876?l1$lEDv-1gRi3L}d3ZNJ2p& zrd!YC#nxjOVbaoQ6KFYLF)oceKp4pzqB)}qrmch;{#S5%(#!Q?e9;jZ8(Mkk(N_D{ z=Vew_;2?B_;5;WU>|rJGSHncpc<%1*Zyr=l)5O*ha> z;}=9&pK=~M9>%^#-JfwHGi|%HY@gh(><2cQ?cC5NG!&BJJ8OO{pG>^%=!4M?Lk?sY zNjD9U z#d%XUN)0QEkf379=SYSS7x)7_Gb8y7V}r=FDwyxKKTUL}o6Wv{Brn8&XTtmtXoKK) z0$s4UvT*m-lYDr%pnxt!QfCg+$|*JcZ&8Swb`YkR!s!h!HJxC@Unf|%x)!vqW{WuZ z=b^(Jih6NjVAFpLf1TjD#S9-XrO(iv{}s`Xoc%l%84&Fk)51b7DCo=4s!+ecPY(jt zzw`9Ah7qISS~!Gey$4&>ix$Kc)EJm#ML70q!hT0EJDxI8YYd-6ikdj5-a6HT+<*^%l>cR1@K2nr0V=z)I=! zx+T%C zJo6mbXck_Kq%CsvLnj$Gj2F$RsjTCmMG;Gfgfw~j&ylFc7_0L-_>|hG#pHp9X+qqa zEQ6H=f~%!+%9TH*`6ta>GHN+U;@#mY(yHLcc7L}97SQi)a<$veinDq2DazK+t{ZFj zIfrvU+o~QhQD2`9dpkcWi?x2;ZikyOLR~CbSqb}eHxi7(9Y!sG^xT6M06uYYe)OX;?PLmPN`$%Y34C?2MIq1XbpJ7l?F`rD^9&qD!I%dDr zKP4DR(_Az-@Z*!UQ3$25a}TcU;yQ-m|48NU=DS>W@y|;hxvb0bYlPhe&wL zKWfeP!|@(*l$2R)krXtWl&p;tHwsg2Vc)8M!cPb?ID-^vSBgYpCF_bo2R>N4Muqc4 zp;K>11FiIO75Xt-*-Iv+ShG{9D5OLAG}@8xBl~~_qLn(^-M*GOaOICr0#K#Smju@Wtyg8BMCNYJmVw~Z z<40m76W-Wv(e%x(S6wp{a59*l46cP4K}+Oq2Sh~rFpf;RZj&z8Ka0F+n6nOImi)r5 zR@yb1&+jdQq>@zqpvDah_Iq_Ie+_A1dWW;<^*1&BP8agMm@c9@UPjcZG5$VRAyjiJ z;e5Q}&=a&^-9$S%)9NcUI`8V9%HG#;SBgTwq%)+dw{Y3u^H|RBPRMPOMnK~Gj%>X+ zdo|4dmj^?Bq3$v^yZOAsG>79KS1N&rNrVc39ED>g2E%T4k3twh%b>FIgRvC*m6B4L z6=+rZ`+U|%c2b5$<3#*;Jic1<4Oi3N;f~a8-}`rWb*7SuJTHMpX^O{rwpIaR&zcFs(<2dw@UT5W9LVqYLeGTMOIXwwsXUIf3qh95pE!sOw?>l9dP9!B>1L9z z=YnF#9&gWg+T1gnD&?C=;$>l+j#qMY+ZVAJQyR6KH$+6T43T=#UK6#qyV=hNz|SMd zn1nXXs$>^xh%~eJ&|U7U=T+vJvY$^1o83W@>G;J$6hggzb>(^S0)y|Jf-=|&ZhT`^iA`QXNPz)7aedep3N$Ju3B~a%Zp(iVme&YB~lM4Bj zI$9w#QE#S^he?l=OnK55L7ij!;M1OfRQ;c!&(iSWsO5Sh{e$_VH|4ZUMe4PC9y^>$ zG1_HS%&X+uXIMl*M^-C(n~UE((=P-LxWJ|ONJv!N8VUm3wJ)kyY7IUfznn4uQ3Iq~ zpGIw$j@^nQsBKXs>zZqM3sNHI9HwulnL#BQmGYg1(kc*1 zl-(vyK4SU(WY$T;+RoITE7wE}PGWgRm4hd+-<$E1&(7kv)349V^VVMW^eyn$)GSjg z*q;voEhG3vlK2veeGlD_OurwBPhZcar1ECvE!cQUSr%Vu53f-FwiiRD(?#Cq!sNEm zi>5|>3Qf#&W>sw%NKVcbFWgYGY`K?MIMX z-l`$#zC{Uf?RZHA4k)dLasVTO3qC^X69a(p?qK1keg&t^C(qp}L_pD)K;H}_n<7Oj z5E(BdY_Y$7;KOh(&f{7)27ItK8VNC$((13F?A6=R)aQ12QqGa)5}2@j3*L6MM$y6I#%>?^HKbLEj3 zvp^m8j`l0Tij>f?Fep1Dnt?j6Mzgl1))a-$*%H3j_wkMck&wUX{P)l! ztVHe9yerSb)wLdE672$YCAaMnppNcEtnx03E}3dfg7y*Ar5PQIZ4{qa`f2f)DU2FvJ|6=+ zQkYFpBg=6+igJlTU2b>&TYE~fd4TtmJJXp|wpj375|frpO!Xh_$zoogq(Bj@tbCME zj{jhpG*Y0})?{T}o}4^ySd|SFu5f@Wb&f$V$;7a+!xlnlD*j7p5*>XvRXUI+i`7=0 zg?X#jcL`3dt~-zIBuFMG|5Y20wk~#Ppq7MNV$zxmKH;<~R4-PTn&YCWKI{@azt&SMQ=?)#tv2$k z7A#>CDdlw$G;I%}hh$-(a*&p>k#L6PJ634J{-K`2N{WmT-S_dsqwk?Jci~}R{R|+s{2(P^ zQ^;=)CGti_mn^BdRIrB)#ann<+39|+vPYOWX^<@SBbJ#G9B6%U^mgDfj86=!4-aXg zj{Is46L#u({dBgS?Mu33H9wB7=bN-u?{Ue&-FV%9^;IO(Yz&`z5Nt$gG8u-eBr9U5 zR&RBEn=A3F&yK7@lR5d*YR6$R%d_pp&Nr6>4OZv9F6VtyR6?-DLX8xq2|@p$F>(w} z!RCb}wGLXl(E{~~%diOY|7!ANTcELcfN%1B+XITX zZLC$WRL`%CwlG}hoE4J}w@D$8Zc$3gA&YLCuR^8MZf*?YWn211vqXuP*D{%Rvp7sB zC^o&mD<$!_XSmt;LEL@vx4gW^NCGlSbQzAs2_^?enpG`qy}H;x9;E2je=-=WSEfQ& zYq$Q6Ev7!Fd3J_D)@0Sti9@h41+|bE-I%KOYg;x_9+V6Q>xWlw=@lH<&l}P#P-bPm zlojVi{L6FTa4jlMmJM5u#XEg%tGj}Ig+@aEPdj^?S~4Hrr7dA#=>N{z^D7Q?$}_oXq!cj>twyczJ3o8rDSGU;cu?4*$9DOj0;wG0aqjQ0bwv!`8+Q6 z*qt6|&dipH04{m_WBt*!q&XA;bCsOiN@S|y>2{k{lP2xK3J*!4*onz_SKxNV> zS9kLgIvErmxHc~LFB&n9SJBE8awu=3>*{K9oBmQi`Ri_=vZtB1Ull|HS|i~AB<1mw zf(U}-gDU2r?;@1~qG&_Ai8d~e8AhtR)>wIvCF*z88O46g-K~S+d|)ognlx$9v*+z> z)Q>%9Q9RXn^W+(>%2zuiO~oy5FN-fSi7+$Lh~VI8wcO$?cKQ>wQb4jmhQnkS0x#L? zcaCUD@iCKwGBh8Lt1Ue1s6N4~TCdx)t_tqvoGtv+Whi4F3!e5gvH7doi-UiMY``eG zm}$SQ6hj11{`7;|W^6a!vf-@7x7?T5otEQNYowSH4Tgu*PFK^0+#% z6)EIZQJxfb2!Ne+e2c6c{TgxL`k-tskO)Q}X(;LO@mg8D>AAw+aoU>@F_2xxX3^^k z2&7=U>7oBBEJh>`Y7~=8v&3$E>f;LnD$6m=wZm~vm@LrbZj3-h-ZD3z9sdjctW9K7 zOXVH1{G204`IOR0Na#S(A_TrfsvN=w(HeM zGRs5=#!tO=-U7m`&^Rlcxecvl^?X^l&YZ3NJE0L>k#bPAMEG4JD0rpSwb*jDW}~QE zn+kbqgz1y~#e@4r8s{|dj?*g}#$v-hrCKvId6@`st83~_7DcZg42|rb=V`9ceGWW5 zhR7LXoc5fyIw?0@F3{otth5Cvvw;zEmz(U9;`y1$t7V6n%Qs+{^$U8{VVTUkCyR4v zcr`xW#gFrHs>)Wj>zm{sM<9e+foe;fw2xN1NmylutNHB1w*>9OkYcmlg_%knWEYq5 z$0MDC$9n@i8nwD&S@$71f-X>0Pb?i3%GTzJh_O6V(lpGigC+@KxD_`w2GkAD_RdH>aq(SYWCeWjpP zrw2jH6@#WN4u?^{!ftS5FYN9nZbfqGzj3{Ciy*Yd)vDL8t&KP|TjC(J6r(+sA;bgwM!DL#+cf)jmd1@2tK#r zy4yVb$f-9O!NvMLLeZ||FLM}@pRCJVztN{-WYpf)hTFqgs@I9HUBBv+K3_78=P%<7 zQwV|ox8QTSLoi4htn?PH;L1_q%+}xMDfHuLj`O+N2IF(mce(XRvX=Z2F*~W<=9rd( zF3Ugc|1`M$E0x3==*>+}cVaqoe^#EB40S9Z{@NFmBSSV;NEyCc^&{PX zq``BIC)$C9o?*q?RH2$HX&wt`of$+0mBf7NgDqhEJ0`*D=Ec)+1Jzt?u-X1>8NK&; zKx<8bwj1>eYzzm*?)z2dwImi_2qW{al3#mbRmS}hvtF&KM<5cFjg4d6Gc^%k10;U@ z&Df_O;OcfT3tAk3VpAq*t2McQZzF9o=RQ)xN2EHp(?+0==Y78QY9WwAifpO=-U|pT zlrgfbr1~b8dz*baH}->==+?{*^;@{Q%r!9$uk7%|1!LIE6}B~NgAmU)V|D4`=(PCA zcMFm~R)AKoMv{HGJucMwTo_Y$o!0=9T{n#=-|MPC)q+5w{Hs6k1L)K887w{}L0@>R zL2dkk#-l}!PmPA-t$>43Ti(XKWT&4IYNTDuC=kuB@QBWC^gfH`yOUp-woTBx)D?`< zgGt`S|7mtrfB7VZXFFB#UW^?GLQyqq^m`jcpn7a><@OGGTbn6s>6(00X0}}KlkAOS$Z_)E<&=J`+8ib?rB59*PNS;ZAq^!#P8=+LAYp5)&53Y^u0os zilE?8Oo#T1qzA`7tu+JIjD&i{sMV0tROuhnQbqT>!}pnm$I*xUNiRe;<~{+28?X73 zBQgt~<_E2yFJJPS9Tr4SGcp~Y9~-ktm5Ip?6ETe~-{)_=iP7`ToCR#y4jF#?yZki( zY!%)cYC4oru)_ZMPh7W=j7Vs-r{P0IvEfwM49+E`?j1mr$YGQr$%17#+pJU*b4AVE zsx_?8jQm^V$4q-BD#gz$xt|@AkcP&zhmt|7U`#K|lW4Nd7I<76Uk~v2d$QPL-L_n< zxX_{UpftKEeVj`tiPTJ8-Eam~`Y}nYKIijYhCJi24hh&HXUCRKlh+^js(QbofEI+- zlSwq?$qQ~w-bQoogz5=ONEK*yPN%+~e_KDl19a4Ywq}7cncdOyJ$>sie>N@Nf1>{H z%A2=_bLI{_X60EFaB`p618u12)gLfkoiRD!RYXT#`sXw2AbpUFa{3DuuXaQ->2>rj zH&b9?QG7KBCBgc_7x@B@+q-Mc6xF}M)mv+3d*LRezl0fwTHM#?ADBykE>k!*-3Q(P z73IQLcJ@Q>i48~%vA(pZ0R5Hw<5l0EbR15R0bK;lR*Ptea@_>^g4O47(%9pNk?W#xgQ9 zla;Ah`@X84_#lN8DN2+uB-G{g@YzMT(`zp8_p8S)oJXBSAGAoeap9Mu+Rx6j^251z z$5Y>!bCD`+RAN=E6tn7QnrGA|P?>E>YmL+rT(f*TLk02lPc(0qhzN=PiY4ZxOPy7C zE3v$i;}a{(*-lX?&7?MkAZh=9Dk|CClI;G@%gAOfHr&w33!0<2g@4WB!$;PnqQzmZ zn82~`%6q=!QFw)axLA)+&c5rx_<{z0x;}nUK`xcc9OkzDvfS28!nHL{bz0WOIR`*xG7DZy4UaHXnk`QL zufH>)d8YTyMTN9nEYAqr`N5&=$us~Y1W{c_iVd}3rq3mP9#~iJIFW4x?xv)_75VOP z^QJ)ANWM}$HE2bhJ$j>*cVB&M7ID%SXG^%4(zKUucp=ZSEgkRVseC38VLUvwv(?%-I@Z%&5JzZPV8h(p)pn z*Olcm7!OzWFpmN7XB7^mv^J=T#-Yji(`m}J`B>Zi zQLXJG$FGC0)j6tsB&D;^D4(zy{?0xn?UFW2Txq<{Upb7AS4>!|;_+m0nF-;s-UA`A zC&=0JmOV&326;k!s2<7clqs%W4_a-~s#COf5WtYG{^DRfj;l&1w1>L%D-z$K7G6)6 zM!RW&}hf4!^WGUqV-kcbIC zJ^E6J%^u^Zv@!ig^)(<6UGapsGZxmY1WyWEQc>zOx!dnv<>^ISOsw9`#AI*u$RQpp zOAZ~8dtZ3>V5a5h1r*7?L8Drn8mUXf!O z)TBo-`zw$gM~{LN+(_Hl(G2u(nFr`xldKk1CpX!>N3?=GHMFgZ)R~{XEABrE1aV+oaZ+f?uo|Yc_8?(5c73|=ovKr zZ2~l)j3M)$8Wq8TVZG2w#k?7_l5c8{*Y9pK+}H^Iu4-zj zI{blq9=U9~Uz0qXHH01U(Fh(S$e|a%D-<5VfDWv2 zC?P}<$DGg;;xmvC?q;EAk@F_J#PbHj7$1Fx*n)hG=JU${E*@cyP}B*PLRl zduLF5NAOR$UwAf(YE*v?M*i(twxz}cq|xqY_t9lxdTEBFa>@ZvUb*&N6xcycmeWsjXTxK6-A+66~zA(i<(aY&Vr@aGS5&pPifV2 zP9&A&6#XXAn+kG3`(H`tQ}c4wBm}yW($N7=8{pEvZ2ARwJOTfr!VIIUa1PGq_KNEcWiQ%zi#pjvG+hWNS0w%drwTb^!OvV3@S(OA^sYK6IPkY4i_rVEL<-Dne4jyvEE`goJ}jd1J0( zPMSBWjeRXfevM;!zjH0L3w>uKiJ}T^lBqhQsad-{{$LVjI}ZE8@kywb5#dbP)ehCA zkaWna#<>UR6WH>9jA-_R_AEMp^Ip;^>tSyl>n&0k<5$}sN_y(PtPNO zRwoBu!NS8}$J#HIet5`9fkVuCh?tys`uI#}RM;9(rvyuZU)unh^AMTq9g? z{qtvXb`LF_W;{FoV(}upYm!O$i*6)>($sIc%rqBFX|*!*V|3+JJ-G@FQ{}6>Rr@AH zK-#-t%2g=l_|tYT!$XT6fW@`&b*^CX7WVyX9Xd(qb)Df<#g717cs}dyykL9mhJ=(b z4r`!4yO!@Hdb0i?nblbTJt*u?c^>cLNT&uiQ2eX@24B`h0lwLMgKJO6j6E!4oV(fe z)ar9AoT%$N_DLR)MBXT`qTeM)s{hWTj-;M9R!Y^Bhwu6|4PD_q8rcJ(HF`(nLDiU1UPy1Fq39B+UioKFJ#acSI zY8()%{Y#|FQ3Ql)_J=|gD4LoGehJcWCwr6AKP>h1H0lxszoJR9-L$xZnoUN$YHY|^ zhykt)?pOFi4%!Jh4g0#?kc4^A4)opU7d{nMy{gV$=KvIv52Eib^d9T*XrjcQ)&y0& zoRm_;lmRlf9rf{ik7OoqqOu_K&D!3lHDHnt1~)qzYz`L?5jt?%YQN?8qR{Xz`AArh z0}TCsm%oqx4%E7GDL;aT{nO9(=ZnlHh;>_>CbgTb0iHfBvmWYcL1_Ho-{}e9CZ&PZ z446A4{*beHxWJ^=?Q$=H1DVSNytC9O z@VW)4D1qU(E3FtnXCM|pqB%Wv%%%1Iw?f#+jC#0{0@;&f1OoX(Td~)st~$$H0l6x? zW-~0EG3=8B&d+=sYy)&jVMFoItl1GpGnaC_@2Sy<3CUuw4>XZn2wpn^&Kekuj*rFe~NjPv$ZkM$xKB8t+Z6U3N-|Q1O}==ghWq(EtkKS}t_I)LPXyfm5fA|nlXaspA6Mq8ZbZCpUu*FY;nHf;v40T^bCq|fi} zOzHszB+yk&+t*6KdgY2mb0sAm_Rh)N=H;3PX4KR9gaJ^t++ROK`Arw0S%9l}#ecye zk$k+ov3HBa$Jy9u({1N<-kXUs>_Zap#HBJNW1=6j2f!mx5R#DzCDX1C<01x5spCh$ zT?bI0svI)4eat~C7BdhQ)=cCuFY6*v=6`-L;3O)AvMvS)I|Z`b^K>rYm=RqQ{tiKp zpWL^q96;5n&;DveRl&@Ju=jq7;+@dMJaI)|^n{XCpNyjxAdyyS>EAepozeB05B#`m=6bj}a zV?F?y!l`Thspe_T)zT$V&qrU`;I*d^`tg#U3(DKpX>+`|akFZr~T!3;)>B z>WUTy$ONE9i+4AMOfcnMB$__T6@f1mOsSgH0E$00QljKvUGqVrY>M~kk-1{3Us(;S zvc$Q*gj_O70#2b)askZWfLY{1<3yfn8Jy_eb8zH_mXo6u;p?VhfQYa!`TNC0aDchD z`?-h8@G@}ZzIRbkS2xX)fQHA+Pu5OK#Om*-Un~?|L5<30kse*C@;<&cdFRIkDGJVf zhj_w^afd_4E+>5*9zLDC)XRW+A3q_ZZ zuwhUxe2u-k-eYv2Setm4RvK+#^VghN1W2tvxA&5~Hc`Dv1^#0X)g663!Sm{6YRqKo zJBLd-fJ2d^@}0>!x!v^V=Z7F--R;bpS_^hy5#csOdC>6k@HlLZ=FIR-PQ6&d*J~Wc z6xUz^AE)L|IS{GNk zi%s^j_SZM3vH-Ily;fg2=;yai+xrEx>@2}{tn&A?J)a?o?3wTqx~Hr?X6al65;R{X z#Xv!@%K5_Gl@C!5o-S{FSH-paL}Mfiy*+ta5$C1hgb3g2LI4 z9*oOpW;}g+Q~HNLC48qE$NWo>_J#vZdY?MtQDxBrF#;|rYskdQL8m`k!9dRnm@$aK zr?Q)T-lp3XGT-mR%J{81d~8Wk%Ih2Utr2BciUuKabu3i38Ifav3oYP zO2;~SUBcKz*XiR8jEdF^KH`lfjx?B#g)KF*p#S=aWtMFh8_y|kmR3J&)d`n@4=}*e zh)J@vdh1yfi(h@PHBox$`30u-tsOJPbpiA6h5V>JJCeQKTY(f`)+c}?;s8)UH$oFY zlVcU9z=)<#Cq)`SFfI=_)XfQjGwMZVqpy*+7+%M7TB?A7c^+nPnsyY?5-D}K=#W(H zt}5V;Dq);obUPwad7WQ!jeeH*oyDzyXHr;j*Q<0sSL216zBPruu!67ilr--PJwvSW zW4j1>YLZ#>pbjK0Ag6G&OwW_G%UG>e$yyJ{BnUdDlkRukWf7Mul8&`iNX#}p#eFhvKvxTOO9sn)B!2>fDC)szhJ@K z&TL{Gzz#bKIL2PWF)L4r|HTD3Te3$8$Nz@_K5Ow=;93t?O*Vo&Q!I@P8=kLMj}?NR z9{G$3>tuqGQ&0CSV8!*qT(yDyZ3h0tLk;8&51>dad2q_bE;B9@gp zeK-Lw+RMz;6RkntVS)pZ|6^u49ZXBBJfm9qk8;gplIHEL!3roRf?}5C^{(CCXt2%Jrk3QLHoD9Pz!!FQVnJ5IN@lFVKM;m>sQ6$ftp=kDN*k?5~>G5bvO=ssLQ;K`bRPN3@U0xyBibJAZ`u1f#6r4cOk_6MA zgnW!hR4)@$AZ(W-4g?`Yz`|Z3npnBJ$&{#;VOrCs7$611P$P4(>UHpM(4gikajoQ& zm50JE)|%1n53IqZEpA}`)(V8Z!v)ZCRtDi4%rnPO%t~}j?B9s$o4eETQ#S{W;ri}9 zXaW{WdNm`3=O^oIO(!p5Aott zf6e^*-5=jgb_x>!=>te!oHfYnfNCir1&gZXOH0&X` zeZk-JfNCCSmi1K*q}f@AbTwgXXzfP}T^Wxgp^WmpQz?*s!v*V*v`i+_|AFFGv<9Fo z5)mB&SGV7J=4Q+^i45XHypMjOzcjLg=B#Rhxm7a&@X0BI(bW}j!!aA6c#*u?0HW{h zO;dQ*I{-_^!B47d8VU`rssKTQcx8Y$!;PS$VE;P!`_l?qXc60zX9P zsmm|3!8$cN4imnSa6?_Rc;?|j%?@wEq;_pCLCe%u#$wLSdtDq{tXy;!iq%Pn-6QFs z2$PDBI7*fDvBG%hyX(=H@A5F*l>pbF&6_WQpSq_4HobN7FE;Tnpd)bm+gb*QdEbF{ zK~4n2TM`tfu)kaj>X#P3>v*f1y?P2^D11z>!M3d5n{|<2{g>3JoK@S}+Gn97P7cZ| z?Vh3jAVn5O(F7oaE!NMv(s>G6{40zO099}3-vHR^do>x9kqF&AZl4%XW{22Asi8aL zI){vjzM`BYJ#F_)R(zjW(2ugQ-`eK5ZAz(d@h@etDQJ(a0R~D;tjz0tmkTh%e^;)> z%R8X28XEsjl1`M?YsZIawWGpTlQ;o5T*OpJ2pS7*?gADex`v>SV3`tO+o)yw!Q09F zQlR*v92C%rxxsBtMUvr;`M3=**9&E>;z1uUG6maf?SG}gqjmVkDKc}?3N4j1Y1&y0 zGri?5BpvctYRCpkbHt?|a=pr6Lj((!Fj8d-zvfaok84q{ho|&S+-RiXsdep~9>Bc4@!rw4k1jkZLz8muf2I7%$*ec?}4_BSUUtiD*7Q7aupi}_Ma zu&dCT~{BNFE>LgAv7D7VCfExpTTKFG$7_Bpb zqIhTLaQVeaV$(~yoS~@aH(NV;7=6nQ8>_^)S`0uU$>t(`Q`&%+X@yvsZ@t6>%Fo zhLg|gM|sTJ^ZZi1K(V80^OdkYKQd{eDP)qD-QzPpM4kWy z$ zd@D(T;`WBl*W{)lx~ds)7zFOeIRK4j?Q|gXWiV)BMWJB087TscvKI;nOkB}3&2(0s4S;i&yGBok#R2}yhw#4e&H{4U5a}2z!`S(31Bc*GUCXkP z>b76uaFa=e@Y7pCu{Z>>3KvY3I($9Um!~u25=dca7>vM8kjgh-XsEM*E5`!8Fag%X z36Mw~65x044*!p?w+^dn>%PZTP(l!p?hxrlL8PR+OIo@c2`K^TmTqb3kWT6DZt3nk z#NoHl`+i>U`+R>q&%J+mV4uDBnrp7P#u#%fJJ8G3+)@Imj(Pg3nnKFd^QBQ_?Toim zAXSZ(17dI%LzljI1q@rKg-i1d8u<$VLZ%~CL3pqDTF>zzt5zKrm)Qi9CDP@sBP3DS|=*A1s=vsEy#bK%QQknW(-3)ZsyO)YLWxJs6zsu8|r& z{M-4XOcF74syGQY04b@oxDIGbqiECXWb^NS-W`uM!If+>p-e1tYcTgQeOfueQh>gl zj{!d3dsKqt8d_RfkNh#9QtN1 zbG3)@HCx+mHMReiot?}@4l3BA+#Sv>=NSwc$x+cx8iX0loN^{FYXp#qO9sb*W~;uZ zTTc=cZ8Mkwe4Mb|5fZ*T{iDiqUiPZ^n2x?TKjL?uL;8BWZt+=S77(JNa3cabZ66Lg zr%=hZxStf!F?JPH6_xNae60O;*8^bSK`$4~eR*TV#`Xa8>vw&ipMu{6WOhVi#+U30 z=hyw|Q>meek6h5YYpitvayA&x>h(odX+>GwKpv4kvJNLH7oagD^%B!6)tblAoTm>l zsgU5Q+@iB`Snn|z&QDtgVe@~AJBJiqfiLBa?f89VD~PSHIUVD=z1AODeM2X|&vckD z0pAh)kLd%4`2`j|IHJhY4>o(0H8dW6PW1oT_gFt+MVf)!2as9(LhewAAAqe%Si!WtvYZHZl8u2@IPQ#ILl%gH-hB95Ha)a2h#!y?z!@B?nL zKniUC2pzbEz!3FNoN=^)(oCZcs{r-8=c<}e%mux;krZqx(NyCHx<6|?NtJ^ykr_|m zGbPU!|K^3TQc}SY7o;N|Sd|z`Be{Iu()&1ldR0t^a#3UrHtUE|%~kLQFJ`ST@Nufe zFP*4s;%N$6&025l=P;&%L9bc?n|IbzK%hzg^p z`p-rW?Mv0cxyt6zuT9)Pi08R`Ff!@a1wDVy(CRW*Q&^6sXd9K7yLJ4kW^c~x;~0LJ zwf-H!M>>f+>R<5b0j-=!UDuOHb)K`5{ZmWOc7H4v26V>K6g?DC3Q?zy7Nahg+}E|v zj={>{6Bjo=v)cC)9Dy541CzHv9IssI*H)^EcdvaGn9oD9)6Rj&XgG`MAJCpA{D4U& z!F|#muYwen`1$?fGEfLhB~DN*`eZJb#M_FfR4y-Xr_Tw(uEUXz5;)pMWLs}Y8-otD zE(f4XJ${v{AvNu~mTd*hL^!z-0>S3KS0=Lq$N}q)Wk{ph<~4HeNhq^OfPVUEGVX{L zDFHtQAO5UAb1?W2P*=&u>=A(Y_)p9rUf?V<6wwW8lE%8!e*0wLTrE}W&g}#cB(Ndb z7;v_W<%g-MUiA(pu?Cws`TMF04^f~2ojx`ftSGxOol>3+{>wE0Nj9FZCB67)WtpW& zku}6p6Vx292H^2n?uIZnLcmiA{|6g?H~0Rc$*}M~*ZuQuoEn9mz8^{=+=T6Bq8g~z z{Wb?H2*FxeL1~qO-9#06O$m31D&^?ls{_6jbbCQ0H1ZI6>507vewomR=X z&z*S>bu;MFHvlVxjueYN?k?b6G<`nkpa$T60uuYy-!t zM2WIIZGq>CHEXoGU+nd$jlu`UbSDOkC(D!+!r^%VU4;kP6x2R3)LnE>jO4k)nF%*7 zO{l~?7U8Kb*F01XM&J~^DPRM;##pfr*GFTRl1}{jw=0@@Nl&Yzry~B{_W;y~%ZAj-w(oCg=J+z(?3GIWYKcmMt+3kN5Rv?J} zVGwz7Bm?ePPYk#@7?Y>6PM_ zdfS6Jehl9P#ytU586J~C+w&maUi_~3fsEDFXC9n(;7kF!hP06e?4PXdbOr#q!o4nF3+5BBiU{noXT>Ik^dtkd zKx43nB(W^qfQBK%o`_1+Lzej{!L&d8))W)nVEVuzcI7m@Afn})A<$9VR1PyEJDAKrHV`uw>J zC;ofka{%9S1F=wVKGI$1`zQD`^BZVwrr{2-_bfCbA=_%1%F&v3$Q--Hz!C)9am{}F zGs1*GC7`n;XY}3}*du8~BEqaF1n6^*QL{E^foKoJOn7Y;7k=IV{Vz&*gwE`8PG_(v z%&1y+2&fU=D@>ZGo2I+jUc(;ux_61oX=Pvj03m)XwEs(~16J%D)6_-Jj_EH--CG3B z0~Tw?de{xl?I(%#yLV{u>4kwe%0`m)#1P-He`>YAl)QY~>6Sp3BRNou?oE}N^v0ZFGeX$_X1^x%7l<0(#3vg%1w{C0glzUHK1N z@K@&4h^}`z+MXj1`}RDUs52=i3>P*OhbqdDWgnCoZWk9V^w%2m%P7L5|5ZLjneE&P z^nCQVeG>tA_9zH^GW<^t#9dfUtJ%%4p+g?qP7U5lUu&|hg^FEJeU3<*Yq!d z4p1s_-C=8_9`sQSriw@mK9^6n*OeqKJdr-dnVFsCOK5ED1uA!8en8g6p3qks%cas; zWXe;}6Vc?~YbyRr3;mZxHT}HM0Q5bZJU_H~#j?Y25pkKVA2VZ!!*tWbh&W1Ma&fp& z7cBflw?t1_l=>EC@Zg>?M+s)P69XF$s*?A9cSVaCK!q@%0Z2`QHfk|kpZKhfgogq* z*`R_1UMOsMoA*cwds6X%E$Ddq4t7egumw>mFPVaDXbV0zIv%hTodEWz7BqJ3at@p7 zr{9MWQJmqYwe+Dsbe&FjqmXGAYdR7RdPaI>G_?X!;3+^b&%aNLyGf0AzVfKBnBBZ_ z){f%@%6dcv68z?}-$+yJP>D`!2tNBr+FQc80HO0s(oFNJU^;|;pJ1GOA041STXll` zS{xO?h6QR5y&$y4z;`-t(aD~6_W*@qgCRpS5O6-D8KyqE`FQmi`m4`}A6KGdZ(Rd$ zbw7hRHDm1YK{)=IQ>0%)p3untga8dWAE3x=ZCCr^1-dzh(a;hpB{%JsyzYXqnSpf# zXqgcbv5E!H?^uR7zT}&<+y6Qjh3EhiPq1+^iB$gc{(or9|Z@S1_siE z$L(6HFFu7{R<`>owjLg>nH*y56vkV3SB1_{sqS;eCdou*Ju3Xp`&Z`gc5ZQOCx(*k z?63meN_z^l9S{)8)Wuq(e!TLaf~Qxn97?0PJUoRfBJt&q*Rt*X88L9V59tNEkhaEd zXwK4_x5uE=@!{a)_MnN`0y%di5epXXD^l2`A9O-n0~((mB6C{KmBA>v@HP?35VOK3 z)yRGimT(qlA?slcT3no^xtp7`;S>2S8vt%p9h{sSl@SGN%bUiGMQg`EJs>l9K+2@T zFpG#OUZnOqn!8uH;^Y~d!-1B3nf_9X&(pp{b{f#UW_#Keu-Jy6d$w%?`1}Y8(KgLq zq2C!Qn6rT=yyrql1!*mY`$`IP$)kDjbC@ELt|aVIUjP)O;!`@SSwf zpUk}+G?eY`?VTUotpRyEz=UqEDvb03O^3d{jS5G`Hkg~m|35Z~&F9IpT|gW8c^thY zCs4X$$hLAckGU>i8)*Ku*rNt1AH$@>xgbK z4nMsJxi5*XH$+mP&S$43K2V5yYU1h<3zXUI4gC|)S^?0x3gT)C*a6iTQlH8^#yiah zm+$+Z7hR-XA}@*E`eZTiXb^qmsb4tQ8I)Q2N&ViM8DF1EwV@uvPRv%7g05q?Q>w_+ zpSnSQEFSmE(bmU?LL+uXXpPnW<7Crf!Zyv+~=3*@dQarBAVt=KZZ1=d-?b87N}(Xa{H&ChjS)V{)eGZjpXz! z{{NF2iZU8Zug;CQi{mq0_UNltg|AOQWHDIpAXfzzqo07E!yUutcsdXZWuZ7#IBZ{o z$W&frQ!F0aFR^chlP|RWC{U%$lctIbt-5R3=k7Vr4~_ z-tFxYMwFi}H>@I0FOW^{EP#dCRjLY*@M0@_$l`KtFk95I-z`4{_H%)lv_!yTvkjQl z(E)E$Z*PG}3aRDgWs*$bcB;$ji$Rhp;Pp4Iw#;Cv~Grf^+cOBU9}n? z?qc1FPS$NOT3I4<%-G-SNwKl4+|D+sF+GE}T!Ty{;lbn+u(gP`WDd-%cXrVko&X9w zmC4<#FasnX-$4E}#U8484P@2QR$wcFXb2}Fa{Xto*(cnk5$}8?i}(jdU#J~5L!{dm z=MiC|`*pqC+w|3raiT!==wh)7SX_>Ec4{JhSqBz>U%)i{*`G1S*!Cn{HA~pGu%*Q< z=)P%BIur>3QX`0Oof|%VL`3>jGS;sC2(|5DtJ_FsBmZ_R z3qSzvE)TET+Tg2$NZiYTQApZ&rMW7xC4EaPdrQ$P$E~ez_bs3sSZgc>4W4uM{`>-y z_IoqS{fVsBPhoF8>E<5;;%TjQ<4f*X8>1WfOCiZro-eLj-ieQ^vgcUr^a52EYd=0f z6y~|u*@6IHjbzL~(grHq*U#f5`lOKeCw^;eo??fZjeYL`)&M?ZGT5y+&4rJnIqNd< zG!}pUR9Y^2?N3Pe3|iK{SV0fFFo#EWKIh1&HGjsfT==eZ_?c4rr@>%e9L*nw{a;^7 zw1iy))7;0PMyF8}Mg0Q08aMjlSy}F%G$10SH&Tdo>zeA)0j#5vXka zaGkno(qOp@Lko zSc$c*b#iJ#`op<16kgdZ6~T?} zj!!6RfnJ3Gs8ghwx3r|Y7gnbKDFam|GOFxxv&62A*yj$RyaiFZdJX=n6=2D)rp0J& zc1U6UtRV9*(OWkC#OyoNoo1%MWOC9ggQD=WV zYr3&qEWncl{1esnNY5TNNGCUv7|HFZC-WZEnT*Z>mzY+!M>TaHWU%k;L?l%~&phGK z)+i_7bV+LY;6Q3N=)H-GdQ**GWAow*tb8s6QuwP#w!^Twkh-dGE^eeCjkYDAL@q~q z4V}_mfyy^zH65PiJ|O5~)qrRNxIFo!QgONJfp#I_c=IwW*4B(~ZQvOdz1kS1JMB({ zeaTd#`$`IyK!XMTLH7g`P+4!53|h8pFIFD_q!zFuzEwmj`R45(Q<}mXksP74$^|5| zGAUf1#K39Fh23(_+TQ*K_^P%s$o#s(LP$wTX>hrqm^DxE*hSW~P zVeG5>{uJM0u6kj0u^iCMwl>|47yEqApH)Uy(?|fo4&9Ly-`_A=9Bdk%UeE{5F6ZcH zc>EbbN7=9KgB;R@cA2s6yvo=y=`?ADjbY|qh zAnAXZG#821elK+e%lI1R$6^zpap=C2e~Lk+sM-lp9f@>L2u}>VdmdB#+*GJ@ zun-Xu`FaUVN~Bw+U+FpQCz>g|6gl4=>tvKpx|E_z^w+vGE@M8zRy+Ipgtpgiht@q% zozW&zJ~uc?qWitr(y?`VW_IfUG_rx$1h&qFFhSTp+4h?_2tro5HVNxV!DR z;dkD5uihmXUF=pl^U`H*ZLRVmlVawf^^%tAY3In;3bXHYy(YCDC__5xp9_lBy&61Y zJbZcf8l@#Mr&~q&U|ze_=)HHdqg&XpUkI4*W{9|K09vzjxRQ2#bC^DY*_62Byprcj zH?Knt^YxUDEkOto4prfweFr92Qv^@dn~g61^P2WpM!n+=N9l&gH$S}|>vfaj2jBw* z5i@`^V1^6iUjUKHc%u-G-BYZ-I-3=Ot^6S%JAhl^`L76#i2dkRyBZyJ@h-%Fic5z- z6?FWOu9cL01O^!C8C7<_r@m$OqZQ=UY;xzTDU+l4qvHQJXSYYlx!@5Vt^U-rn-EcQIZ~nE5T;1K zYWCHs9pw1Vu-Lwzg#?@WA?XbzGE?u|F>Px_Xd);p*;uABHQ?)Z&*D{BwAraM?$| z{2zlaiUOWy&+9Z@10R^F+CqLlr6Lr{RLP>Ic}_wOyj|Xseujk+Wd2U2!TbMJO zqKols?GJ-eZf|efdP+-!fSZ`#vFjfCT)v8)NT_QAzt0Hd7{YbjMPVIZQR3a`;ppbzI?|miJ|FNXz0ndf+JCZj z&5N8qh{?L); zZi8o+z1jpLR-zn8m6$*7M(wN1+zb#`bUD z0+w^LZmCl4qG@BJd$k;Sp!GH@8Yf2SXCawN17F5}ko}m%>etbd62>zPB6HYon45Xr(&)tYQ5 z(M+8qrIpn|hRCEToFNaA-&X9hY;uIa8LjfU!*bh`;WXE1%qpDHr0^0so=mQ%tqbkM zSu?$d1*!tR&)k&mjHUfkDJ8?t+SKnB0yU6ZdMnj6b9)bVbdgrr+f7?KLh${b5z=4* z?_08c9uVm@PDkr~iQt3)r;TJs;2x}+3(TYkqiH9>Sp)5FfmtzdA^uTJA1GiteOO8% zMRW_f3k zuA#FH_FGq{aeuVpfRu|}1h!&B^q!LnnH8;1xgl>#k~v`*v~GlV!6I5&7MH)<)6Ha+ zxX#r#r-bLVwRCE8?SXg9j>i6Q&$6Uat{7jXxLYnac6t7tI%@+ohwn7kbus-W)fX9s zXIJu1Jh~;|GhL7Vg5!L=mPh>cB0!V7vumR-RpjnX*@yA-q62!yIdi+ws%IW}DWRk9 za=OkmCeL)W^IFd4v+^ptLSn5c3ZMzEL)l}ek=~=_qrgtYPv#Ga5Vkd~Zwuq`b9n8p z_+YE?LY<@{E?>SB^7|r5BcB<5nIXxODMNDhqIX3n`pN7V)+j0n%}kCBdlr@=54+F^ zzNJc=*rbsm^^YWnr8N!vx8DVB2elNQH2`14{uFM-YdJ1tBByVC6NRaqmTS^r-;1qM z;0lrVt6L*QN-?v9HJ!SmX`-#MUa|;m7+tm_kWpuFQf#V$7fP?Y%)m0#7OKa;I;%t>w zv0BA8_r=_cr*Ob6nnATJ6GXyF7%$IitsH69D?x*T4=}Z+$$33> zBU^Zvuh_s3^@7+fDqJ+`O6+iF-8_}@g}j`mr5&WZTMimL-JNbuOYlG6oi1+gv3(uU z5P+e~(2K3ux@xTEWwx;82}A4ZdQ8AsDLtEu)gxiF-)yt9w?MYjA3G>wPIjVMtnTyN z=0kDgjNF&^OdC4uk+x;Dd-hQxI0Rh7H%%`jQF6jyQYGtDW$JU%sxe`ejjIW8vmO{M28}7pYSv8BAiMW-@1p!xndW!&;~b67X2p)wx}k+BC_S8cP_kg+J7DR@ z%{bf6D0x-P7tVaa=D2TtwDI-*R1NDpd)g7w(whnOL150_qI2Z(>ITtre^PUW zVcKD{21hIV4ztqKK3tgtO?eQ}G)R>*lt2|2&(5a{dDE&m#1r=iM%)fi_4+Iumb$m@ ze~w;kY7O~>%d+O17{?qkJG z+4N1zmoFi}xaoPow1o$S zFE5SPwP2pV%i){AYC6pu&0lFkx*H`)p$CayzEl@CVl8Mx(&_Tm$#j;)VM4Un^0|w7 z(5vXR19h8|S+2%CR_I~Ql2}t)uTf}DHMD2V@nS;`_6RSne)R2r;~DP$iE^UTmey{8 zLry)uS)D@TA;%9+%la>oX`-?UcYgV-=1+Dr>|C~+PNnFAuue=x!ivr=E+VZu6FE*a zA@sFsIPyG+GwHUl@h7F+E?(^OrAb9m zc2v9-5|x}IV~eUOsCr{y!s%q4mGlad5e6MC(V^$)?)FBB;kBn~*}gEo z#C$XN=6>}}30lgcc|n7JANHzz77--=buHV5X(7}2Dn%)`mW#yr4iuaOwQ0K)Y>r5j zcl?oQ1@xx4?_&~G-S_8~&bG&8r3K9*QB1Ty6!gbYjJ{cu20pbP6x3g7yfr{sS{fB> zF zP|e)K{+#BZJhaZr&G))~98B&(_oBJvW6Od)X-LaP-+uMcb7|k@m(*t-)o)u3e`4Xy zYVoQTzQ>|pA1A1y(O8BsViCC%Y)@)?km5&Er%GAKad?ersJ}9*=~)?`2oBTEAe6U1 zjXh4>jq=MR6bsam_C~G{x(%VKP)!O}oPURO@fLS|p4x-+>UH#__+k?T^5LV%YmF~N z+%t^t51T{q>xf-T>fJ{kw-U1`H$>BJcnQn&K02$P0{aPDyPJme zsmy|AY#)xZm(%1}d~|R8D3E#3cg$EnRI5__tS7)&2!mQ)lr7M}z(OvOKq}j&C%I=( zkeIh|VThq_BxWs3;T#ozX{) zb(Eu;pOA&z!bTw*GkHkQJoQ1xv)P&S$hwvLLX*0YJPSMV;dNIMkuTWFf_X)T#c)$1 z5o@SRpp<9dWL_!`S%sH3H0wdrALs;@gLJ&;d)3#pP~_BriHX>N@bM#KGhnJJ9qd*^ z2aSrf@=+j?$K%g#)?G?*vE4BXy81X0-p(QK3{#p%Z`y0?*s~bwF11!+yLrXVOI)!3 z-8Tpozph#?Lu8^jbv{=?!L4oy1vh^Iw16;yEDMPq0^Jx1tVVIJlbPcO!zGS>_??<% zdqXGYtKT6Lgwm2VmS+WBHXt_cLZ}WX*wPl+=3iLYt=<}Nt3<_aO@wQu%{NB>aHDRG z7qe10t1AgR-Ih{)F7I1u_-Rk=X`;5x6QA+^7A9Nn_Vv)ERc&LI5m|Lb>DlcY*BxBu zANAEQZm)LoB3@`;ob}^lW9z?0vp8D52p|mTNE6T=-w;^u9@fV*su zDktp&Nw{m((OZ8OpTAawt(RCo^IT9K2}ljPnRr#$pD-*kFP&KIEvPzs)D5{L;u;1y zuqIOGMHXxH=%yY^?^It;7*!9dTP%Nc9Qpp=xwv{i7YDvL#~BSteEqY|wzVhUKk@R5dh2t-I;-Me-}k78uTm zEMj{Ww6eEE7E%TcecR#kNCtSj)gP;d8c)FzFfp&F+<|U zqn|<`{|d}}GCtZsKs`?#|b`>v>rimqpKzAmz=>S8#< zY%T0Q0=%N86Kr7v&H(nPm8V$B<-DIOm+`gWan}%K_*H~~^p}EA5%tkLt!yrGH!4bL zx$I`Lj*uNnTD-Epv_*1c)ueG`L1)oW&aHC8ll4IYtU3j#gM7X6l}qjt7CI*t>Qs+JB`sezIPF3gI=UgktutV_FtxCs6fpK_YY* zXe`QI;tjo@d+;}1F0=X|VxppSTfJm5S0B;UqCX*5UhkIdhg)ZIBO+H)(BM$Kz+P*1 zGKdhfioONs+K5hvkylnEaP`h5Ip~r4dU7TCDr-D1+}lOCw}IK2_Ib!;;(B=?*#j+ z4_R)b<4nBq86$M7E#h2Ee;NwvUk}=D|EM;1hN*FNHY(O4Y}0OD_nSkv#CPnbM&>s9 z`nEXAa9?@-!xc>>2kxkmYEM6Md;mx3Dt3+6eZqqX%6Y=)I*nA^ZRH~<8Lg(&0PfI%G?qbFFoY_M

S1J5Ru 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 D7|iGh literal 0 HcmV?d00001 diff --git a/localization/es/step-builder/README.md b/localization/es/step-builder/README.md new file mode 100644 index 000000000..73dcf4674 --- /dev/null +++ b/localization/es/step-builder/README.md @@ -0,0 +1,123 @@ +--- +title: Step Builder +category: Creational +language: es +tag: + - Instantiation +--- + +# Step Builder Pattern + +## Explicación + +El patrón Step Builder es un patrón de diseño de creación utilizado para construir un objeto complejo paso a paso. +Proporciona una interfaz fluida para crear un objeto con un gran número de configuraciones posibles, haciendo el código +más legible y reduciendo la necesidad de múltiples constructores o métodos setter. + +## Propósito + +Una extensión del patrón Builder que guía completamente al usuario a través de la creación del objeto sin posibilidades +de confusión. +La experiencia del usuario será mucho más mejorada por el hecho de que solo verá los métodos del siguiente paso +disponibles, NINGÚN método constructor hasta que sea el momento adecuado para construir el objeto. + +## Ejemplo del mundo real + +Imagine que está construyendo un objeto de configuración para una conexión a una base de datos. La conexión tiene varios +parámetros opcionales como host, puerto, nombre de usuario, contraseña y otros. Usando el patrón Step Builder, puedes +establecer estos parámetros de una forma limpia y legible: + +```java +DatabaseConnection connection = new DatabaseConnection.Builder() + .setHost("localhost") + .setPort(3306) + .setUsername("user") + .setPassword("password") + .setSSL(true) + .build(); +``` + +## En pocas palabras + +El patrón Step Builder permite construir objetos complejos dividiendo el proceso de construcción en una serie de pasos. +Cada paso corresponde a la configuración de un atributo particular u opción de configuración del objeto. Esto resulta en +un código más legible y mantenible, especialmente cuando se trata de objetos que tienen numerosas opciones de +configuración. + +## Wikipedia dice + +Según Wikipedia, el patrón Step Builder es un patrón de diseño de creación en el que un objeto se construye paso a paso. +Implica una clase 'director' dedicada, que orquesta el proceso de construcción a través de una serie de clases ' +constructoras', cada una responsable de un aspecto específico de la configuración del objeto. Este patrón es +particularmente útil cuando se trata de objetos que tienen un gran número de parámetros opcionales. + +## Ejemplo programático + +Suponiendo que tienes una clase `Producto` con varios atributos configurables, un Step Builder para ella podría tener +este aspecto: + +```java +public class Product { + private String name; + private double price; + private int quantity; + + // private constructor to force the use of the builder + private Product(String name, double price, int quantity) { + + this.name = name; + this.price = price; + this.quantity = quantity; + + } + + public static class Builder { + private String name; + private double price; + private int quantity; + + public Builder setName(String name) { + this.name = name; + return this; + } + + public Builder setPrice(double price) { + this.price = price; + return this; + } + + public Builder setQuantity(int quantity) { + this.quantity = quantity; + return this; + } + + public Product build() { + return new Product(name, price, quantity); + } + } +} + +// Usage +Product product = new Product.Builder() + .setName("Example Product") + .setPrice(29.99) + .setQuantity(100) + .build(); +``` + +Este ejemplo muestra cómo utilizar el patrón Constructor por pasos para crear un objeto `Producto` con un conjunto de +atributos personalizables. Cada método del constructor corresponde a un paso del proceso de construcción. + +## Aplicabilidad + +Utilice el patrón Step Builder cuando el algoritmo para crear un objeto complejo debe ser independiente de las partes +que componen el objeto y de cómo se ensamblan el proceso de construcción debe permitir diferentes representaciones para +el objeto que se construye cuando en el proceso de construcción el orden es importante. + +## Otro ejemplo con diagrama de clases + +![alt text](./etc/step-builder.png "Step Builder pattern") + +## Créditos + +* [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) diff --git a/localization/es/step-builder/etc/step-builder.png b/localization/es/step-builder/etc/step-builder.png new file mode 100644 index 0000000000000000000000000000000000000000..b7b623657c589b4cf18160ec268733a3a16f69c2 GIT binary patch literal 76038 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 Existe una clase para las estadísticas de héroes en un juego de rol. Las estadísticas contienen atributos como fuerza, +> inteligencia y suerte. Las estadísticas de diferentes héroes deben ser iguales cuando todos los atributos son iguales. + +En palabras simples + +> Los objetos de valor son iguales cuando sus atributos tienen el mismo valor. + +Wikipedia dice + +> En informática, un objeto de valor es un objeto pequeño que representa una entidad simple cuya igualdad no se basa en +> la identidad: es decir, dos objetos de valor son iguales cuando tienen el mismo valor, no necesariamente siendo el mismo +> objeto. + +**Ejemplo Programático** + +Aquí está la clase `HeroStat` que es el objeto valor. Fíjate en el uso de la +anotación [Lombok's `@Value`](https://projectlombok.org/features/Value). + +```java +@Value(staticConstructor = "valueOf") +class HeroStat { + + int strength; + int intelligence; + int luck; +} +``` + +El ejemplo crea tres `HeroStat` diferentes y compara su igualdad. + +```java +var statA = HeroStat.valueOf(10, 5, 0); +var statB = HeroStat.valueOf(10, 5, 0); +var statC = HeroStat.valueOf(5, 1, 8); + +LOGGER.info(statA.toString()); +LOGGER.info(statB.toString()); +LOGGER.info(statC.toString()); + +LOGGER.info("Is statA and statB equal : {}", statA.equals(statB)); +LOGGER.info("Is statA and statC equal : {}", statA.equals(statC)); +``` + +Aquí está la salida de la consola. + +``` +20:11:12.199 [main] INFO com.iluwatar.value.object.App - HeroStat(strength=10, intelligence=5, luck=0) +20:11:12.202 [main] INFO com.iluwatar.value.object.App - HeroStat(strength=10, intelligence=5, luck=0) +20:11:12.202 [main] INFO com.iluwatar.value.object.App - HeroStat(strength=5, intelligence=1, luck=8) +20:11:12.202 [main] INFO com.iluwatar.value.object.App - Is statA and statB equal : true +20:11:12.203 [main] INFO com.iluwatar.value.object.App - Is statA and statC equal : false +``` + +## Diagrama de Clases + +![alt text](./etc/value-object.png "Value Object") + +## Aplicabilidad + +Utilice el objeto Valor cuando + +* La igualdad del objeto debe basarse en su valor. + +## Usos conocidos + +* [java.util.Optional](https://docs.oracle.com/javase/8/docs/api/java/util/Optional.html) +* [java.time.LocalDate](https://docs.oracle.com/javase/8/docs/api/java/time/LocalDate.html) +* [joda-time, money, beans](http://www.joda.org/) + +## Créditos + +* [Patterns of Enterprise Application Architecture](http://www.martinfowler.com/books/eaa.html) +* [ValueObject](https://martinfowler.com/bliki/ValueObject.html) +* [VALJOs - Value Java Objects : Stephen Colebourne's blog](http://blog.joda.org/2014/03/valjos-value-java-objects.html) +* [Value Object : Wikipedia](https://en.wikipedia.org/wiki/Value_object) +* [J2EE Design Patterns](https://www.amazon.com/gp/product/0596004273/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596004273&linkCode=as2&tag=javadesignpat-20&linkId=f27d2644fbe5026ea448791a8ad09c94) diff --git a/localization/es/value-object/etc/value-object.png b/localization/es/value-object/etc/value-object.png new file mode 100644 index 0000000000000000000000000000000000000000..69a244c80691b8ac63ed5b732b8b0828c592a1f8 GIT binary patch literal 5025 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 literal 0 HcmV?d00001

4nMzkVrZ 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%0A7q{J_-UOqLOp3(!|U1qV;lIx<) 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 PE-^e^{an^LB{Ts5#7Ir7 literal 0 HcmV?d00001 diff --git a/localization/es/lazy-loading/README.md b/localization/es/lazy-loading/README.md index 44442449a..611868f33 100644 --- a/localization/es/lazy-loading/README.md +++ b/localization/es/lazy-loading/README.md @@ -12,16 +12,16 @@ la inicialización de un objeto hasta el punto en que se necesita. Puede contribuir a la eficiencia en la operación del programa si se usa de manera adecuada. ## Diagrama de clases -![alt text](../../../lazy-loading/etc/lazy-loading.png "Lazy Loading") +![alt text](./etc/lazy-loading.png "Lazy Loading") ## Aplicabilidad Utilice el modelo de Carga Diferida cuando: -* la carga anticipada es costosa o el objeto a cargar podría no ser necesario en absoluto +* La carga anticipada es costosa o el objeto a cargar podría no ser necesario en absoluto ## Ejemplos del mundo real -* Anotaciones JPA @OneToOne, @OneToMany, @ManyToOne, @ManyToMany y fetch = FetchType.LAZY +* Anotaciones JPA `@OneToOne`, `@OneToMany`, `@ManyToOne`, `@ManyToMany` y `fetch = FetchType.LAZY` ## Créditos diff --git a/localization/es/lazy-loading/etc/lazy-loading.png b/localization/es/lazy-loading/etc/lazy-loading.png new file mode 100644 index 0000000000000000000000000000000000000000..bec0a7afbefe08d3741e4f2b5c4043c62977790e GIT binary patch literal 11671 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 HHVODIUz$3B literal 0 HcmV?d00001 diff --git a/localization/es/monostate/README.md b/localization/es/monostate/README.md new file mode 100644 index 000000000..5ac695e88 --- /dev/null +++ b/localization/es/monostate/README.md @@ -0,0 +1,33 @@ +--- +title: MonoState +category: Creational +language: es +tag: + - Instantiation +--- + +## También conocido como +Borg + +## Propósito +Impone un comportamiento como compartir el mismo estado entre todas las instancias. + +## Diagrama de Clases +![alt text](./etc/monostate.png "MonoState") + +## Applicability +Utilice el patrón Monostate cuando + +* El mismo estado debe ser compartido por todas las instancias de una clase. +* Típicamente, este patrón puede ser usado en cualquier lugar donde un Singleton pueda ser usado. Sin embargo, el uso de Singleton no es transparente, el uso de Monostate sí lo es. +* Monostate tiene una gran ventaja sobre Singleton. Las subclases pueden decorar el estado compartido como deseen y, por lo tanto, pueden proporcionar dinámicamente un comportamiento diferente de la clase base. + +## Casos de uso típicos + +* La clase de registro +* Gestión de una conexión a una base de datos +* Gestor de archivos + +## Ejemplos del mundo real + +Aún no lo he visto. diff --git a/localization/es/monostate/etc/monostate.png b/localization/es/monostate/etc/monostate.png new file mode 100644 index 0000000000000000000000000000000000000000..273fa95459d4d0853c58bfa25cb6e1117fd48032 GIT binary patch literal 16526 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 literal 0 HcmV?d00001 diff --git a/localization/es/acyclic-visitor/README.md b/localization/es/acyclic-visitor/README.md index c78469bd9..8b835f43a 100644 --- a/localization/es/acyclic-visitor/README.md +++ b/localization/es/acyclic-visitor/README.md @@ -1,9 +1,6 @@ --- -layout: pattern title: Acyclic Visitor -folder: acyclic-visitor -permalink: /patterns/acyclic-visitor/ -categories: Behavioral +category: Behavioral language: es tag: - Extensibility @@ -25,7 +22,7 @@ En otras palabras [WikiWikiWeb](https://wiki.c2.com/?AcyclicVisitor) dice -> El patrón Acyclic Visitor permite que nuevas funciones sean añadidas a jerarquías de clases existentes sin afectar a las mismas, y sin crear los círculos de dependencias que son inherentes al patrón Visitor Pattern de GangOfFour. +> El patrón Acyclic Visitor permite que nuevas funciones sean añadidas a jerarquías de clases existentes sin afectar a las mismas, y sin crear los círculos de dependencias que son inherentes al patrón de visitante (Visitor Pattern) de GangOfFour. **Ejemplo Programático** @@ -99,7 +96,7 @@ public class ConfigureForUnixVisitor implements ZoomVisitor { } ``` -Finalmente aquí están los "visitors" en acción. +Finalmente, aquí están los "visitors" en acción. ```java var conUnix = new ConfigureForUnixVisitor(); @@ -123,14 +120,14 @@ Output del programa: ## Diagrama de clases -![alt text](../../../acyclic-visitor/etc/acyclic-visitor.png "Acyclic Visitor") +![alt text](./etc/acyclic-visitor.png "Acyclic Visitor") ## Aplicación Este patrón puede ser usado: * Cuando necesitas añadir una nueva función a una jerarquía de clases sin que esta se vea afectada o alterada. -* Cuando hay funciones que operan sobre la jerarquía pero no pertenecen a la jerarquía como tal. Las clases ConfigureForDOS / ConfigureForUnix / ConfigureForX por ejemplo. +* Cuando hay funciones que operan sobre la jerarquía, pero no pertenecen a la jerarquía como tal. Las clases ConfigureForDOS / ConfigureForUnix / ConfigureForX por ejemplo. * Cuando necesitas ejecutar operaciones muy diferentes en un objeto dependiendo de su tipo. * Cuando la jerarquía visitada va a ser frecuentemente extendida con derivados de la clase elemento. * Cuando el proceso de volver a compilar, enlazar, probar o distribuir los derivados de la clase elemento es muy pesado. diff --git a/localization/es/acyclic-visitor/etc/acyclic-visitor.png b/localization/es/acyclic-visitor/etc/acyclic-visitor.png new file mode 100644 index 0000000000000000000000000000000000000000..7b4df13d80f8c0d1be8ca32cbc39594bbd9ec7d4 GIT binary patch literal 49064 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 J8O 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 Imagina que tienes unas imágenes en una tarjeta de memoria y quieres transferirlas a tu ordenador. Para transferirlas necesitas algún tipo de adaptador compatible con los puertos de tu ordenador que te permita introducir tu tarjeta. En este caso el lector de tarjetas es un adaptador (adapter). > Otro ejemplo podría ser el famoso adaptador de corriente; un enchufe con tres patas no se puede conectar a una toma de corriente con dos agujeros, necesita un adaptador para hacerlo compatible con la toma de corriente. -> Otro ejemplo mas seria un traductor traduciendo palabras de una persona para otra. +> Otro ejemplo más sería un traductor traduciendo palabras de una persona para otra. En otras palabras -> El patrón Adapter permite envolver un objeto en un adaptador para hacerlo compatible con una clase con la que seria incompatible de otra manera. +> El patrón Adapter permite envolver un objeto en un adaptador para hacerlo compatible con una clase con la que sería incompatible de otra manera. Según Wikipedia @@ -64,7 +64,7 @@ public class Captain { } ``` -Ahora supongamos que viene un grupo de piratas y nuestro capitán tiene que escapar pero solo hay un bote de pesca. Necesitamos crear un adaptador que permita al capitán usar el bote de pesca con sus habilidades para usar botes de remo. +Ahora supongamos que viene un grupo de piratas y nuestro capitán tiene que escapar, pero solo hay un bote de pesca. Necesitamos crear un adaptador que permita al capitán usar el bote de pesca con sus habilidades para usar botes de remo. ```java @Slf4j @@ -91,14 +91,14 @@ captain.row(); ``` ## Diagrama de clases -![alt text](../../../adapter/etc/adapter.urm.png "Adapter class diagram") +![alt text](./etc/adapter.urm.png "Adapter class diagram") ## Aplicación Usa el patrón Adapter cuando * Quieres usar una clase existente y su interfaz no coincide con la que necesitas. * Quieres crear una clase reutilizable que coopere con clases que no están relacionadas o con las que su cooperación no estaba planeada, esto es, clases que no necesariamente tienen interfaces compatibles. -* Necesitas usar varias subclases existentes pero es impráctico adaptar su interfaz creando subclases para todas. Un adaptador puede adaptar la interfaz de la clase padre. +* Necesitas usar varias subclases existentes, pero no es práctico adaptar su interfaz creando subclases para todas. Un adaptador puede adaptar la interfaz de la clase padre. * Muchas aplicaciones que usan librerías de terceros usan adaptadores como capas intermedias entre la aplicación y la librería para desacoplar la aplicación de la librería. Si es necesario usar otra librería solo hace falta crear un adaptador para la nueva librería sin necesidad de modificar el código de la aplicación. ## Tutoriales @@ -117,7 +117,7 @@ Los adaptadores de clases y objetos tienen distintas cualidades. Un adaptador de Un adaptador de objetos * Permite a un solo adaptador trabajar con varias clases, esto es, con la clase adaptada y todas sus subclases (si tiene alguna). El adaptador también puede añadir funcionalidad a todas las clases adaptadas a la vez. -* Hace mas complicado modificar el comportamiento de la clase adaptada. Sería necesario hacer una subclase de la clase a adaptar y hacer que el adaptador referencie la subclase en lugar de la clase a adaptar. +* Hace más complicado modificar el comportamiento de la clase adaptada. Sería necesario hacer una subclase de la clase a adaptar y hacer que el adaptador referencie la subclase en lugar de la clase a adaptar. ## Ejemplos del mundo real diff --git a/localization/es/adapter/etc/adapter.urm.png b/localization/es/adapter/etc/adapter.urm.png new file mode 100644 index 0000000000000000000000000000000000000000..341ad67699d9d965433e169c91793e9fd164beb5 GIT binary patch literal 25425 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 A%m4rY literal 0 HcmV?d00001 diff --git a/localization/es/aggregator-microservices/README.md b/localization/es/aggregator-microservices/README.md index 2c1c6aab8..835863efb 100644 --- a/localization/es/aggregator-microservices/README.md +++ b/localization/es/aggregator-microservices/README.md @@ -8,13 +8,13 @@ tag: - Microservices --- -## Intención +## Propósito El usuario realiza una sola llamada al servicio del agregador y, a continuación, el agregador llama a cada microservicio relevante. ## Explicación -ejemplo del mundo real +Ejemplo del mundo real > Nuestro mercado web necesita información sobre los productos y su inventario actual. Hace una llamada a un agregador > servicio que a su vez llama al microservicio de información del producto y al microservicio de inventario del producto que devuelve la @@ -41,7 +41,7 @@ public class Product { } ``` -A continuación, podemos presentar nuestro microservicio `Aggregator` (Agregador de microservicios). Contiene el `ProductInformationClient` (Información del producto del cliente) y el +A continuación, podemos presentar nuestro microservicio `Aggregator` (Agregador de microservicios). Contiene él `ProductInformationClient` (Información del producto del cliente) y él `ProductInventoryClient` (Inventario del producto del cliente) de los clientes para llamar a los respectivos microservicios. ```java diff --git a/localization/es/aggregator-microservices/aggregator-service/etc/aggregator-service.png b/localization/es/aggregator-microservices/aggregator-service/etc/aggregator-service.png new file mode 100644 index 0000000000000000000000000000000000000000..75ee82328bbe925e11e7175224294b925f22683e GIT binary patch literal 41498 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