Паттерн Декоратор — специальный способ организации модулей в программе, который позволяет подставить какую-то новую функцию прямо в середину цепочки вызовов, тем самым чуть-чуть подкорректировав поведение.
Например, в реальном мире очки для чтения это декоратор. Вы ставите их между вашими глазами и текстом. Глобально взаимодействие ваших глаз и текста не меняется: отражённые световые лучи от страницы книги попадают в ваши зрачки, что с очками, что без них. Но очки располагаются посередине: они принимают лучи на вход и преломляют их, передавая дальше вам в глаза уже изменёнными.
Важной особенностью является тот факт, что очки можно снять. Они не требуют ни модификации вашего тела, ни модификации книги. Вообще никакие условия не нужны, кроме наличия самих очков. А если вы в линзах, то внешний наблюдатель может даже этого не знать.
Класс-декоратор должен быть спроектирован так, чтобы не требовать никаких изменений в объектах, с которыми он работает. Его можно отключить, чаще всего буквально закомментировав одну строку.
В примере ниже программа выведет текст "Привет, мир, в натуре.", и вот это дополнение в конце как раз дописано декоратором. Можно убрать или закомментировать подчёркнутую строчку, не трогая остальной код, для всех внешних вызовов сигнатуры останутся теми же самыми, но выводиться будет уже просто "Привет, мир".
В декораторы можно прятать логику, которую буквально навешивают поверх основной функции программы. Например, проверку прав на выполнение операции. Перевод на другой язык, логирование, поддержку обратной совместимости при обновлении и так далее.
#dev
《薄伽梵金刚持实证传承:Aogula坛城与一切续部集密法藏之震动密钥》
༄༅། །བཅོམ་ལྡན་འདས་རྡོ་རྗེ་འཆང་དངོས་གྲུབ་བརྒྱུད་པ། ། ཨོ་འགུ་ལ་དཀྱིལ་འཁོར་གསང་འདུས་ཆོས་མཛོད་ཀྱི་གཡོ་འགུལ་ལྡེ་མིག་ཅེས་བྱ་བ་བཞུགས་སོ། །
《薄伽梵金刚持实证传承:Aogula坛城与一切续部集密法藏之震动密钥》
The Direct Experience Lineage of Bhagavan Vajradhara: The Vibrational Key to the Aogula Mandala and the Guhyasamaja Treasury of All Tantras.
༄༅།། ན་མོ་གུ་རུ་བཛྲ་དྷཱ་རཱ་ཡ། ། 顶礼上师金刚持!
Namo Guru Vajradharaya. 纳摩 咕如 哇嘉RA 达RA呀!
རྡོ་རྗེ་འཆང་གི་དངོས་གྲུབ་ལམ། ། དཀྱིལ་འཁོར་བྱེ་བ་མཆོག་གི་ཆོས། །
金刚持佛实证道,亿万坛城最胜法;
The Path of Direct Experience of Buddha Vajradhara,The Supreme Dharma of Billions of Mandalas.
།གཡོ་འགུལ་བཟླས་པས་དཀྱིལ་འཁོར་ཞུགས་པར་བྱ། ། རྒྱུད་སྡེ་ཀུན་གྱི་གསང་འདུས་ཆོས་མཛོད་གསང་བའི་ལྡེ་མིག །
震动持诵入法坛,集密法藏之密钥。
Vibrate and Chant to enter the Dharma Mandala,The Secret Key to the Guhyasamaja Treasury of All Tantras
སངས་རྒྱས་རྡོ་རྗེ་འཆང་གིས་རྡོར་དྲིལ་བསྐྲུགས། ། སངས་རྒྱས་སྤྲིན་དང་རྒྱ་མཚོའི་དཀྱིལ་འཁོར་འཁྲུག། །
金刚持佛震铃杵,佛云佛海坛城动;
Buddha Vajradhara vibrates the Bell and Vajra, Mandalas, numerous as Buddha-clouds and vast as Buddha-oceans, surge and vibrate.
ཕྱི་ནང་གསང་བའི་དཀྱིལ་འཁོར་ཀུན་ཏུ་གཡོ་ཞིང་འཕྱུར། ། འོད་གསལ་རྦ་རླབས་གཡོ་འཕྱུར་ཀུན་ལ་མཉམ་པར་ཁྱབ། །
外内密坛遍震涌,光明震涌等遍涌。
Outer, Inner, and Secret Mandalas vibrate and surge everywhere, Luminous waves vibrate and surge, equally pervading all.
།ཕྱག་མཚན་བསྐྲུགས་ཏེ་ཡི་དམ་ཟུང་དུ་བསྒྲུབ། ། གར་སྟབས་བསྐྱོད་དེ་འཁྲུག་ཅིང་གཡོ་བས་ཡུམ་དང་ཟུང་དུ་བསྒྲུབ། །
振动法器修本尊,舞韵涌震修佛母;
Vibrating ritual implements, practicing in union with the Yidam Buddha,Amidst the surging vibration of dancing grace, practicing in union with the Tathagatamatri.
འཁོར་ཞིང་གཡོ་བས་མཁའ་འགྲོ་ཟུང་དུ་བསྒྲུབ། ། མྱུར་མགྱོགས་གཡོ་བས་ཆོས་སྐྱོང་ཟུང་དུ་བསྒྲུབ། །
旋转震动修空行,速疾震动修护法。
Vibrating while rotating, practicing in union with the Dakini,Vibrating with swiftness, practicing in union with the Dharmapala.
ཕྱི་གཡོ་ནང་གཡོ་རྩ་འཁོར་ནུས་པ་ཐོགས། ། གཡོ་འཕྱུར་ཀུན་ཁྱབ་གཡོ་བས་ཏིང་འཛིན་ཞུགས། །
外动内动脉轮通,震涌遍动入三昧;
Outer and Inner vibrations open the Chakras, Engulfed by universal surges and vibrations, enter Samadhi.
སངས་རྒྱས་དེ་བཞིན་གཤེགས་པའི་དཀྱིལ་འཁོར་དང་མཉམ་པར་སྦྱོར་ཞིང་། ། རྡོ་རྗེ་འཆང་གི་ལམ་མངོན་སུམ་འགྲུབ་པར་ཤོག ། །། ༈ །།
相应一切佛坛城,金刚持道愿实证。
In union with all Buddha Tathagata Mandalas, May this path of Vajradhara be attained through Direct Experience.
藏密修海 www.zmxh.com Aogula加密社区 www.aogula.org
#金刚持#实证#传承#Aogula#噢咕拉#坛城#法藏#震动#密钥#脉轮#中脉