Software-Architektur software-architecture
Design für Upgrades design-for-upgrades
Bei der Erweiterung der OOTB-Verhaltensweisen ist es wichtig, Upgrades zu berücksichtigen. Nehmen Sie Anpassungen immer im Verzeichnis /apps vor und überlagern Sie entweder die entsprechenden Knoten im Verzeichnis /libs oder verwenden Sie „sling:resourceSuperType“, um das Standardverhalten zu erweitern. Zwar können Änderungen erforderlich sein, um neue AEM-Versionen zu unterstützen, doch die neue Version sollte Ihre Anpassungen nicht überschreiben, wenn diese Best Practice befolgt wird.
Wiederverwenden von Vorlagen und Komponenten, sofern möglich reuse-template-and-components-when-possible
Dadurch lässt sich das Erscheinungsbild der Website vereinheitlichen und die Code-Pflege vereinfachen. Wenn eine neue Vorlage benötigt wird, stellen Sie sicher, dass sie von einer gemeinsam verwendeten Basisvorlage erweitert wird, sodass globale Anforderungen wie die clientlib-Einbindung an zentraler Stelle kodiert werden können. Wenn eine neue Komponente benötigt wird, sollten Sie versuchen, eine bestehenden Komponente zu erweitern.
Gestalten von Vorlagen-Designs design-template-designs
Indem Sie die Komponenten definieren, die in den einzelnen Absatzsystemen auf der Seite enthalten sein können, können Sie Einfluss darauf nehmen, dass das Erscheinungsbild der Seite einheitlich ist. Durch das Beschränken des Zugriffs auf das Design auf Seiten können „Superautoren“ die zulässigen Komponenten je Seite ohne Unterstützung eines Entwicklers ändern und gleichzeitig sicherstellen, dass die anderen Autoren die Unternehmensstandards einhalten.
Entwickeln einer SOLID-Architektur develop-a-solid-architecture
SOLID ist ein Akronym, das fünf architektonische Prinzipien beschreibt, die beachtet werden sollten:
- Single Responsibility-Prinzip: Jedes Modul, jede Klasse, jede Methode usw. sollte nur eine einzige Verantwortung haben.
- O pen/Closed-Prinzip: Module sollten sowohl offen (für Erweiterungen) als auch geschlossen (für Änderungen) sein.
- L iskovsches Substitutionsprinzip: Typen sollten durch ihre Untertypen ersetzbar sein.
- Interface Segregation-Prinzip: Clients sollten nicht gezwungen werden, von Methoden abzuhängen, die sie nicht verwenden.
- D ependency Inversion-Prinzip: Module höherer Ebenen sollten nicht von Modulen niedriger Ebenen abhängig sein. Beide sollten von Abstraktionen abhängen. Abstraktionen sollten nicht von Details abhängig sein. Details sollten von Abstraktionen abhängen.
Das Streben nach Einhaltung dieser fünf Grundsätze sollte zu einem System führen, das eine strikte Trennung der Bedenken aufweist.
Befolgen des Robustheitsgrundsatzes follow-the-robustness-principle
Der Robustheitsgrundsatz besagt, dass Sie streng sein sollten, bei dem was Sie senden, und offen bei dem, was Sie von anderen akzeptieren. Das heißt, wenn Sie Nachrichten an Dritte senden, sollten Sie sich unbedingt an die jeweiligen Spezifikationen halten. Wenn Sie aber Nachrichten von Dritten empfangen, sollten Sie nicht konforme Nachrichten akzeptieren, solange die Bedeutung der Nachricht klar ist.
Implementierung von Sammlungen in eigenen Modulen implement-spikes-in-their-own-modules
Sammlungen und Test-Code sind ein integraler Bestandteil jeder agilen Software-Implementierung, allerdings sollten Sie sicherstellen, dass sie nicht ohne entsprechende Kontrolle in Ihre Produktions-Code-Basis gelangen. Entsprechend empfiehlt es sich, Sammlungen in ihrem eigenen Modul zu erstellen.
Implementieren von Datenmigrationsskripten in ihrem eigenen Modul implement-data-migration-scripts-in-their-own-module
Bei Datenmigrationsskripten handelt es sich zwar um Produktions-Code, doch diese werden in der Regel nur einmal beim ersten Start einer Site ausgeführt. Nach der Live-Schaltung der Site wird dieser folglich zu totem Code. Um sicherzustellen, dass Sie keinen Implementierungs-Code erstellen, der von den Migrationsskripten abhängig ist, sollten diese in einem eigenen Modul implementiert werden. Dies ermöglicht es Ihnen auch, diesen Code sofort nach dem Start zu entfernen und zu löschen, wodurch toter Code aus dem System entfernt wird.
Befolgen veröffentlichter Maven-Konventionen in POM-Dateien follow-published-maven-conventions-in-pom-files
Apache hat unter https://maven.apache.org/developers/conventions/code.html Stilkonventionen veröffentlicht. Es empfiehlt sich, diese Konventionen zu befolgen, da es damit neuen Mitarbeitern erleichtert wird, sich schnell zurechtzufinden.