可持续升级

自定义框架

架构（功能／基础架构／内容／应用程序）

自定义框架功能旨在帮助减少在不易升级的代码（如API）或内容（如叠加）的非可扩展区域中的违规行为。

自定义框架有两个组件： API Surface 和内 容分类。

API Surface

在AEM的早期版本中，许多API都通过Uber Jar公开。其中一些API并非旨在供客户使用，但是会跨捆绑套件提供对AEM功能的支持。今后，Java API将标记为“公共”或“私有”，以向客户指示哪些API在升级环境中是安全的。其他具体信息包括：

标为的Java API可 Public 以由自定义实施包使用和引用。
公共API将向后兼容于兼容性包的安装。
兼容性包中将包含一个兼容性Uber JAR，以确保向后兼容性
标记为的Java API Private 仅供AEM内部捆绑包使用，不应由自定义捆绑包使用。

注意

在这种情 Private 况下 Public ，不应将Java的公共类和私人类的概念混为一谈。

image2018-2-12_23-52-48

内容分类

AEM长期以来一直使用叠加和Sling Resource Mergare的主体来允许客户扩展和自定义AEM功能。为AEM控制台和UI提供支持的预定义功能存储在 /libs中。客户永远不得修改 /libs下的任何内容 ，但可以在/apps下添加其他内容以叠加和扩展 /libs中定义的功能 （有关详细信息，请参阅使用Overlays开发）。这仍在将AEM升级为 /libs中的内容时导致许多问题 ，因为这些问题可能会更改，从而导致叠加功能以意外方式中断。客户还可以通过继承扩展AEM组 sling:resourceSuperType件，或直接通过sling:resourceType在 /libs 中引用组件。类似的升级问题可能会通过引用和覆盖使用案例发生。

为了使客户更安全、更轻松地了解哪些 /libs区域是安全的，并且 /libs中的内容已通过以下混音进行了分类：

公共(granite:PublicArea) -将节点定义为公共，以便它可以覆盖、继承( sling:resourceSuperType)或直接使用( sling:resourceType)。在/libs下标为“公共”的节点下添加兼容性包后，升级将是安全的。通常，客户只应利用标记为“公共”的节点。
摘要(granite:AbstractArea) -将节点定义为摘要。节点可以覆盖或继承( sling:resourceSupertype)，但不能直接使用( sling:resourceType)。
Final(granite:FinalArea) -将节点定义为final。分类为最终理想状态的节点不应被覆盖或继承。最终节点可以直接通过使 sling:resourceType用。默认情况下，最终节点下的子节点被视为内部节点。
内部(granite:InternalArea) *- *将节点定义为内部。归类为内部理想情况的节点不应被覆盖、继承或直接使用。这些节点仅用于AEM的内部功能
无注释 -节点会基于树层次继承分类。默认情况下，/ root为“公共”。 父节点分类为“内部”或“最终”的节点也应视为“内部”。