![\"\"](\"https:\/\/www.julianmejio.com\/blog\/wp-content\/uploads\/2021\/07\/translator_service-01.png\"){kind=spacer}
La clase facade<\/em> Translator es est\u00e1tica, lo que permite el uso f\u00e1cil sobre todo el alcance de la agregaci\u00f3n. Los puntos principales que tuve en cuenta fueron:<\/p>\n\n\n\n Cada diccionario representa un idioma y es independiente a los dem\u00e1s, sin embargo esto podr\u00eda dar lugar a inconsistencias como que no todas las claves est\u00e9n presentes en alg\u00fan diccionario. Aunque por la forma de construcci\u00f3n de la clase Translator esto no supone un problema l\u00f3gico, no pasa lo mismo con un error humano, que facilmente puede olvidar alguna clave. Para solucionar este problema hago uso de una interfaz ITranslationDictionary<\/em>, la cual sirve de enumerador de todas las claves de traducci\u00f3n a usar, y cada diccionario debe implementarla.<\/p>\n\n\n\n La implementaci\u00f3n m\u00ednima consta de tres artefactos: una clase facade, una interfaz ITranslationDictionary y al menos una clase que implemente dicha interfaz. Vale la pena resaltar que aqu\u00ed hago uso de algunas instrucciones espec\u00edficas de Typescript, sin embargo puede convertirse facilmente a Javascript puro.<\/p>\n\n\n\n Para determinar la configuraci\u00f3n regional por defecto hago uso de variables de entorno y un valor incrustado a manera de fallback. En caso de tener una aplicaci\u00f3n que defina de manera din\u00e1mica su configuraci\u00f3n regional, por ejemplo, en alg\u00fan par\u00e1metro de URL, se puede cambiar facilmente por otro m\u00e9todo que se ajuste a las medidas.<\/p>\n\n\n\n La raz\u00f3n por la que la lista de diccionarios en la variable dictionaries<\/em> es construida de manera est\u00e1tica, es que de ese modo garantizamos que el c\u00f3digo no sea mutable o que haya un riesgo mayor de inyecci\u00f3n de c\u00f3digo. Al principio us\u00e9 importaciones din\u00e1micas basadas en la configuraci\u00f3n regional \u2014cargar los diccionarios bajo demanda\u2014. A primera vista ofrece una carga m\u00e1s r\u00e1pida debido a que los diccionarios se cargan bajo demanda y puede ser cacheables, pero a costa de una configuraci\u00f3n de compilaci\u00f3n m\u00e1s compleja y ampliaci\u00f3n de la superficie de ataque por medio de XSS. Adem\u00e1s, hay m\u00e1s consumo de recursos en esa petici\u00f3n HTTP adicional que si el diccionario estuviera ya incrustado. Por lo que al final me decid\u00ed por simplificar la clase y a\u00f1adir una lista est\u00e1tica.<\/p>\n\n\n\n Otra ventaja de los diccionarios incrustados, es que la clase no es as\u00edncrona. Cuando prob\u00e9 la carga din\u00e1mica, la clase tuvo que adaptarse al modelo as\u00edncrono async<\/em>\/await<\/em>. Esto quiere decir que si hay un problema de red o demora en el hilo de traducci\u00f3n, el usuario final no podr\u00e1 ver los mensajes inmediatamente, y podr\u00eda incluso resultar en un problema de usabilidad. Por lo tanto, esta soluci\u00f3n de carga din\u00e1mica no la recomiendo para este tipo de servicios cr\u00edticos.<\/p>\n\n\n\nGarantizar la consistencia de los diccionarios<\/h3>\n\n\n\n
Implementaci\u00f3n<\/h2>\n\n\n\n
Clase facade<\/em> Translator<\/h3>\n\n\n\n
import { TranslationDictionaryInterface } from '.\/TranslationDictionaryInterface'\nimport EsDictionary from '.\/dictionary\/EsDictionary'\n\nconst defaultLocale: string = process.env.APP_LOCALE || 'es'\n\nexport default class Translator {\n private static dictionaries: Record<string, TranslationDictionaryInterface> = {\n es: new EsDictionary()\n };\n\n private static getDictionary (locale?: string): TranslationDictionaryInterface | null {\n return Translator.dictionaries[locale || defaultLocale] || null\n }\n\n public static trans (translationKey: string, locale?: string): string {\n const dictionary: TranslationDictionaryInterface | null = this.getDictionary(locale)\n if (!dictionary) {\n console.warn('Translation dictionary not found', locale || defaultLocale)\n return translationKey\n }\n const translation: string | null = dictionary[translationKey] as string | null\n if (translation == null) {\n console.warn('Translation key not found on dictionary', translationKey, locale || defaultLocale)\n }\n return translation || translationKey\n }\n}\n<\/code><\/pre><\/div>\n\n\n\nDiccionarios est\u00e1ticamente incrustados vs. cargados din\u00e1micamente<\/h4>\n\n\n\n
Acceso a los atributos de la clase TranslationDictionaryInterface<\/em><\/h4>\n\n\n\n