코딩 팁 coding-tips

가능한 한 taglibs 또는 HTL 사용 use-taglibs-or-htl-as-much-as-possible

JSP에 스크립틀릿을 포함하면 코드에서 문제를 디버깅하기 어렵습니다. 또한 JSP에 스크립틀릿을 포함시킴으로써 비즈니스 논리를 뷰 레이어와 분리하기가 어렵고, 이는 단일 책임 원칙 및 MVC 디자인 패턴을 위반합니다.

읽기 가능한 코드 작성 write-readable-code

코드는 한 번 작성되지만 여러 번 읽습니다. 작성된 코드를 정리하기 위해 미리 시간을 투자하면 나중에 개발자와 사용자가 읽을 때 향후 배당금이 지급됩니다.

의도가 드러나는 이름 선택 choose-intention-revealing-names

이상적으로 다른 프로그래머는 모듈을 열어 자신이 수행하는 작업을 이해해서는 안 됩니다. 마찬가지로, 그들은 독서 없이 방법이 무엇을 하는지 알 수 있어야 한다. 이러한 아이디어를 더 잘 구독할수록 코드를 더 쉽게 읽을 수 있으며 코드를 더 빨리 작성하고 변경할 수 있습니다.

AEM 코드 베이스에서는 다음 규칙이 사용됩니다.

이러한 규칙은 고객 구현에 반드시 적용되는 것은 아니지만 코드를 유지 관리할 수 있도록 규칙을 정의하고 준수하는 것이 중요합니다.

이상적으로 이름은 그들의 의도를 드러내야 한다. 이름이 원래대로 명확하지 않은 경우에 대한 일반적인 코드 테스트는 변수나 메서드의 용도를 설명하는 주석이 있는 것입니다.

반복하지 마십시오. don-t-repeat-yourself

DRY는 동일한 코드 세트를 복제해서는 안 된다고 설명합니다. 이는 문자열 리터럴과 같은 것에도 적용됩니다. 코드 복제는 무언가를 변경해야 할 때마다 결함을 찾아 제거해야 하는 문을 열어줍니다.

알몸 CSS 규칙 방지 avoid-naked-css-rules

CSS 규칙은 애플리케이션 컨텍스트에서 타겟 요소에 따라 달라야 합니다. 예를 들어 CSS 규칙이에 적용됨 .content .center 는 너무 광범위하며, 나중에 다른 사용자가 이 스타일을 재정의해야 하므로 시스템 전반에 걸쳐 많은 콘텐츠에 영향을 줄 수 있습니다. 반면, .myapp-centertext 가운데를 지정하는 보다 구체적인 규칙입니다. 텍스트 애플리케이션의 컨텍스트에서.

더 이상 사용되지 않는 API 사용 제거 eliminate-usage-of-deprecated-apis

API가 더 이상 사용되지 않는 경우, 더 이상 사용되지 않는 API에 의존하는 대신 새로운 권장 접근 방식을 찾는 것이 좋습니다. 이렇게 하면 향후 더 원활한 업그레이드를 보장할 수 있습니다.

지역화 가능 코드 작성 write-localizable-code

작성자가 제공하지 않는 모든 문자열은 다음을 통해 AEM i18n 사전에 대한 호출로 래핑해야 합니다. I18n.get() JSP/Java 및 CQ.I18n.get() JavaScript. 이 구현은 구현을 찾을 수 없는 경우 전달된 문자열을 반환하므로 기본 언어로 기능을 구현한 후 현지화를 유연하게 구현할 수 있습니다.

안전을 위해 리소스 경로 이스케이프 처리 escape-resource-paths-for-safety

JCR의 경로에는 공백이 없어야 하지만 공백이 있으면 코드가 손상되지 않아야 합니다. Jackrabbit은에서 텍스트 유틸리티 클래스를 제공합니다. escape() 및 escapePath() 메서드를 사용합니다. JSP의 경우 Granite UI는 granite:encodeURIPath() EL 함수.

XSS API 및/또는 HTL을 사용하여 크로스 사이트 스크립팅 공격으로부터 보호 use-the-xss-api-and-or-htl-to-protect-against-cross-site-scripting-attacks

AEM은 손쉽게 매개 변수를 정리하고 교차 사이트 스크립팅 공격으로부터 안전을 보장하기 위한 XSS API를 제공합니다. 또한 HTL은 템플릿 언어에 바로 내장된 이러한 보호 기능을 제공합니다. 에서 API 치트 시트를 다운로드할 수 있습니다. 개발 - 지침 및 우수 사례.

적절한 로깅 구현 implement-appropriate-logging

Java™ 코드의 경우 AEM은 메시지 로깅을 위한 표준 API로 slf4j를 지원하며 관리의 일관성을 위해 OSGi 콘솔을 통해 사용할 수 있는 구성과 함께 사용해야 합니다. Slf4j는 다섯 가지 로깅 수준을 노출합니다. Adobe은 메시지를 기록할 수준을 선택할 때 다음 지침을 사용하는 것을 권장합니다.

JavaScript가 있는 경우 console.log 는 개발 중에만 사용해야 하며 릴리스 전에 모든 로그 문을 제거해야 합니다.

화물 숭배 프로그래밍 방지 avoid-cargo-cult-programming

코드가 수행하는 작업을 이해하지 못한 채 코드를 복사하지 마십시오. 확실하지 않은 모듈 또는 API에 대한 경험이 더 많은 사람에게 문의하는 것이 좋습니다.