CN101727318A - 用于促进持久化应用编程接口的方法和装置 - Google Patents

Abstract

本发明涉及用于促进持久性持久化应用编程接口的方法和装置。一种实施方式提供了一种用于实现持久化应用编程接口(API)的系统，所述持久化API是平台独立的并且能够对业务逻辑进行向上调用。在操作期间，该系统在API处接收在n层分布式应用的持久层处执行命令的请求。响应于所述请求，系统确定受该命令影响的实体的实体类型。接着，系统标识与该实体类型和命令相关联的n层分布式应用的中间层处的函数，其中该中间层包括业务逻辑。系统继而向中间层发送指令以执行所述函数。最后，响应于在API处接收到有关函数已执行的确认，系统在持久层处执行所述命令。

Description

用于促进持久化应用编程接口的方法和装置

技术领域

本发明涉及编程领域，更具体地，本发明涉及用于促进持久化应用编程接口的方法和装置。

背景技术

为了改善性能和可扩展性，大部分基于web的应用都是使用多层架构构建的，其中基于web的应用分布在提供不同类型功能的多个服务器或集群(层)上。例如，典型的基于web的应用可以包括三个不同的独立层：表示层，其用作应用的前端，充当用户与基于web的应用之间的媒介；业务层，或称中间层，其包括基于web的应用的所有业务逻辑；以及持久层，其包括数据库或其他存储系统或设备。每一层独立于其他层执行，并且可以被替换或升级而不会有害地影响其他层。

尽管多层web应用有很多优点，但是这些web应用还是存在若干问题的。例如，在多数环境中，每一层由具有很少或没有其他层的知识的不同群体来维护。例如，创建业务逻辑的应用程序员通常不知道持久层的实现细节。而且，数据库管理员通常不知道太多有关业务逻辑的知识。当复杂操作涉及层之间的多次交互时，这可能会成问题。例如，如果对数据库中记录的更新触发了对第二表的连带升级，则对第二表的补充升级可能需要由业务逻辑来检查，以确保此补充升级与已定义的业务约束和规则相兼容。在此示例中，持久层必须将补充升级发送回中间层(“向上调用”)，从而中间层可以执行此检查。

在某些多层应用中，特定触发器或被存储的过程在持久层实现，从而在需要时对业务层进行这些向上调用。然而，这些实现牵涉到层边界的模糊化，并且会使组织束缚于特定实现或持久层提供方。

发明内容

本发明的一个实施方式提供了一种用于实现持久化应用编程接口(API)的系统，所述持久化API是平台独立的并且能够对业务逻辑进行向上调用。在操作期间，该系统在API处接收在n层分布式应用的持久层处执行命令的请求。响应于所述请求，系统确定受该命令影响的实体的实体类型。接着，系统标识与该实体类型和命令相关联的n层分布式应用的中间层处的函数，其中该中间层包括业务逻辑。系统继而向中间层发送指令以执行所述函数。最后，响应于在API处接收到有关函数已执行的确认，系统在持久层处执行所述命令。

在本发明的某些实施方式中，当系统向中间层发送所述指令以执行函数时，系统还向中间层发送所述命令，其中该命令的一部分用作该函数的参数。

在本发明的某些实施方式中，系统在API处从中间层接收在持久层执行第二命令的第二请求。

在本发明的某些实施方式中，响应于第二请求，系统确定受该第二命令影响的第二实体的第二实体类型。接着，系统标识与该第二实体类型和第二命令相关联的n层分布式应用的中间层处的第二函数。系统继而向中间层发送第二指令以执行第二函数。最后，响应于在API处接收到有关第二函数已执行的第二确认，系统在持久层处执行第二命令。

在本发明的某些实施方式中，系统在API处创建包括指令和命令中的至少一个的事务。接着，系统确定在中间层处是否成功执行函数以及在持久层处是否成功执行命令。如果是，则系统提交(commit)事务。然而，如果否，则系统回退(rollback)事务。

在本发明的某些实施方式中，系统通过在持久层创建持久层子事务来创建事务。注意，提交事务包括提交持久层子事务，回退事务包括回退持久层子事务。

在本发明的某些实施方式中，持久层包括关系型数据库。

在本发明的某些实施方式中，在标识n层分布式应用的中间层处的函数之前，系统在API处接收注册，该注册标识函数以及相关联的实体类型和命令。

在本发明的某些实施方式中，标识中间层处的函数以及向中间层发送指令的步骤由协调代理(Orchestration Delegate)来处理，其中当满足注册条件时，协调代理命令执行先前向API注册的代码。

附图说明

图1示出了根据本发明一个实施方式的计算环境；

图2示出了根据本发明一个实施方式的装置；以及

图3提供了示出根据本发明一个实施方式、促进平台独立的并且能够对业务逻辑进行向上调用的持久化应用编程接口(API)的过程的相关联流程图。

具体实施方式

提供以下描述以使得本领域任何技术人员能够制造和使用本发明，其中在特定应用及其需求的上下文中提供此描述。对所公开的实施方式的各种变形对于本领域技术人员来说将是很明显的，并且此处所定义的通用原理可以应用到其他实施方式和应用，而不偏离本发明的精神和范围。因此，其意图不在于将本发明限制在所示出的实施方式，而是按照与此处所公开的原理和特征相一致的最宽广的范围。

在此具体实施方式部分描述的数据结构和代码通常存储在计算机可读存储介质上，计算机可读存储介质可以是能够存储代码和/或数据以供计算机系统使用的任何设备或介质。计算机可读存储介质包括但不限于，易失性存储器、非易失性存储器、磁的和光学存储设备，诸如磁盘驱动、磁带、CD(紧致盘)、DVD(数字多功能盘或数字视频盘)，或者现在已知的或者以后开发的能够存储计算机可读介质的其他介质。

在此具体实施方式部分所描述的方法和过程可以具体化为代码和/或数据，其可以存储在上述计算机可读存储介质中。当计算机系统读取并执行这些存储在计算机可读存储介质中的代码或数据时，该计算机系统执行这些具体化为数据结构和代码并且存储在计算机可读存储介质中的方法和过程。

此外，下文描述的方法和过程可以包括在硬件模块中。例如，硬件模块可以包括但不限于，专用集成电路(ASIC)芯片、现场可编程门阵列(FPGA)、以及现在已知的和以后开发的其他可编程逻辑器件。当激活硬件模块时，这些硬件模块执行包括于其中的方法和过程。

概述

本发明的一个实施方式提供了一种用于实现持久化应用编程接口(API)的系统，该持久化API是平台独立的并且能够对业务逻辑进行向上调用。在操作期间，该系统在API处接收请求，以在n层分布式应用的持久层处执行命令。响应于该请求，系统确定受该命令影响的实体的实体类型。接着，系统标识与该实体类型和命令相关联的n层分布式应用的中间层处的函数，其中该中间层包括业务逻辑。系统继而向中间层发送指令以执行所述函数。最后，响应于在API处接收到有关函数已执行的确认，系统在持久层处执行所述命令。

例如，对持久层的所有调用可以由持久化API来处理。持久化API支持基于web的应用将数据保存到数据库，并且在如此操作时，执行检查有效性的业务逻辑、做簿记，等等。持久化API使得有可能从持久层调用中间层逻辑，这实际上是从较低层到较高层的向上调用。进行这些向上调用，而编写中间层代码的程序员无需具有关于持久层的实现的任何知识。注意，持久层API使得中间层逻辑不必知晓持久层的细节。此外，持久层API使得基于web的应用能够在数据库、对象关系(OR)映射器、语言(诸如Java^TM和)以及平台(诸如

和

)保留可移植性。

在本发明的某些实施方式中，当系统向中间层发送指令以执行函数时，系统还向中间层发送命令，其中该命令的一部分用作该函数的参数。

在本发明的某些实施方式中，系统在API处从中间层接收在持久层执行第二命令的第二请求。注意，尽管中间层正在执行与所述命令相关联的代码，但是中间层可以向持久化API发送附加请求。而且，这些附加请求的每一个甚至可以转而引起更多的附加请求。

在本发明的某些实施方式中，响应于第二请求，系统确定受该第二命令影响的第二实体的第二实体类型。接着，系统标识与该第二实体类型和第二命令相关联的n层分布式应用的中间层处的第二函数。系统继而向中间层发送第二指令以执行第二函数。最后，响应于在API处接收到有关第二函数已执行的第二确认，系统在持久层处执行第二命令。

在本发明的某些实施方式中，系统在API处创建包括指令和命令中的至少一个的事务。接着，系统确定在中间层处是否成功执行函数以及在持久层处是否成功执行命令。如果是，则系统提交该事务。然而，如果否，则系统回退该事务。注意，事务是从持久化API创建、提交和回退的。

在本发明的某些实施方式中，系统通过在持久层创建持久层子事务来创建事务。注意，提交事务包括提交持久层子事务，回退事务包括回退持久层子事务。在这些实施方式中，持久化API利用数据库的已有事务框架。

在本发明的某些实施方式中，持久层包括关系型数据库。注意，尽管本发明的多数实施方式使用关系型数据库，但是通常可以使用任何类型的数据存储。在某些实施方式中，这可以包括基于XML的文件管理系统。

在本发明的某些实施方式中，在标识在n层分布式应用的中间层处的函数之前，系统在API处接收注册，该注册标识函数以及相关联的实体类型和命令。注意，程序员仅需要注册具有相关联的实体类型和命令特定函数，而无需知道有关持久层任何其他知识。

例如，程序员可以注册这样的特定函数，当API接收到向客户表输入新记录的命令时，其应用用于添加新客户的业务规则。

在本发明的某些实施方式中，标识中间层处的函数以及向中间层发送指令的步骤由协调代理来处理，其中当满足注册条件时，协调代理命令执行先前向API注册的代码。

注意，当命令在API处执行时，协调代理主动地将这些指令派送给中间层。备选地，系统可以使用注册模型以代替协调代理，其中中间层处的函数被配置为监听API处的特定事件。

在本发明的一种实施方式中，称为“存储库”的API是用于所有持久操作的公共API。此API的实现：分析普通对象和实体的进入图形；确定哪些项目是新的，哪些项目是对已有项目的更新；交换合成父母的合成孩子；施加约束；以及调用执行实际持久操作(创建、读取、更新以及删除)的逻辑代理。逻辑代理还调用中间层逻辑，其实现为向系统注册的一个或多个协调原子。中间层逻辑可以任意执行复杂操作，包括对存储库进行附加调用。存储库也处理启动、提交和回退事务。

计算环境

图1示出了根据本发明一个实施方式的计算环境100。计算环境100包括多个计算机系统，其通常可以包括基于微处理器、大型计算机、数字信号处理器、便携式计算设备、个人记事本、设备控制器、或器件内的计算引擎的任意类型的计算机系统。更具体地，参考图1，计算环境100包括客户端110-112、用户120和121、服务器130-150、网络160、数据库170、设备180以及器件190。

客户端110-112可以包括网络上的任何节点，其包括计算能力并且包括用于通过网络进行通信的机制。此外，客户端110-112可以包括n层应用架构中的一层，其中客户端110-112可以作为服务器(为来自较低层或用户的请求提供服务)，并且客户端110-112可以作为客户端(将请求转发给更高层)。

类似地，服务器130-150通常可以包括网络上的任何节点，其包括用于为来自客户端的对计算和/或数据存储资源的请求提供服务的机制。服务器130-150可以加入高等计算集群，或者可以作为单机服务器。在本发明的一种实施方式中，服务器140是服务器150的在线“热备件”。

用户120和121可以包括：个人；个人群体；组织；组织群体；计算系统；计算系统群体；或可以与计算环境100交互的任何其他实体。

网络160可以包括能够将计算节点耦合到一起的任何类型的有线或无线通信信道。这包括但不限于，局域网、广域网或网络的组合。在本发明的一种实施方式中，网络160包括互联网。在本发明的某些实施方式中，网络160包括电话和蜂窝电话网络。

数据库170可以包括用于在非易失性存储设备中存储数据的任何类型的系统。这包括但不限于，基于磁的、光的或光磁存储设备的系统，以及基于闪存和/或电池供电存储器的存储设备。注意，数据库170可以耦合至：服务器(诸如服务器150)、客户端、或直接耦合至网络。

设备180可以包括能够耦合至客户端(诸如客户端112)的任何类型的电子设备。这包括但不限于，蜂窝电话、个人数字助理(PDA)、智能手机、个人音乐播放器(诸如MP3播放器)、游戏系统、数字相机、便携式存储介质、或能够耦合至客户端的任何其他设备。注意，在本发明的某些实施方式中，设备180可以直接耦合至网络160并且可以以与客户端110-112相同的方式工作。

器件190可以包括能够耦合至网络160的任何类型的器件。这包括但不限于，路由器、交换机、负载平衡器、网络加速器、以及专用处理器。器件190可以用作服务器140和网络160之间的网关、代理或转译器。

注意，本发明的不同实施方式可以使用不同的系统配置，并且不限于计算环境100中示出的系统配置。一般而言，能够经由网络160通信的任何设备可以包含本发明的元件。

例如，在本发明的一个实施方式中，用户120使用客户端110来访问服务器140和150上容纳的n层基于web的应用以及数据库170。在此实施方式中，服务器140用作表现层，其处理与用户120和客户端110的所有交互。此外，服务器150包含业务层或中间层，并且包括所有业务逻辑。最后，数据库170包含持久层，并且为基于web的应用提供数据存储。

装置

图2示出了装置200，图3提供了示出根据本发明一个实施方式、促进平台独立的并且能够对业务逻辑进行向上调用的持久化应用编程接口(API)的过程的相关联流程图。

装置200例如可以包含服务器150、数据库170、器件190、客户端110、设备180或其任意组合，其包括接收机制202、确定机制204、标识机制206、发送机制208、执行机制210、处理器214以及存储器216。

在操作期间，接收机制202在API处接收请求，以在n层分布式应用的持久层处执行命令(操作302)。接着，确定机制204响应于该请求，确定受该命令影响的实体的实体类型(操作304)。例如，命令可以包括对雇员记录进行更新以调整该雇员的薪水。在此示例中，实体类型可以是雇员表。

继而，标识机制206标识与该实体类型和命令相关联的n层分布式应用的中间层处的函数(操作306)，其中该中间层包括业务逻辑。例如，此函数可以检查薪水在允许的范围内并且发布命令的人员有足够的权利这么做。

此时，API可以可选地启动事务(操作307)。在本发明的某些实施方式中，如前面所描述的，API可以利用作为数据库170的一部分的已有事务系统。

接着，发送机制208向中间层发送指令以执行所述函数(操作308)。响应于在API处接收到有关函数已执行的确认，执行机制210在持久层处执行所述命令(操作310)。最后，如果API之前启动了事务，并且如果所述函数和命令都已成功执行，则API提交此事务(操作312)。

示例性实施方式

以下部分描述了仅用于示例性目的的本发明的一个实施方式。

注意，其意图不在于将本发明限于此实施方式中描述的细节。

此实施方式提供了一种系统，其中对象的持久化由实体服务API来控制，实体服务调用Hibernate以执行CRUD(创建、读取、更新、删除)操作。

注意，Hibernate通过使用其用于检测脏对象以及可到达即持久化(persistence-by-reachability)的内部机制(其中，其自动确定对整个对象图形或一组对象图形中的元素进行CRUD需要完成哪些)来确定创建、更新和删除的内容。

存储库是用于可扩展数据访问层的公共API，并且是实体服务之上的抽象层，其不会为了创建、更新或删除操作而直接调用实体服务。相反，存储库通过调用创建、更新和删除CRUD协调来执行创建、更新和删除。

注意，CRUD协调是ICrudDelegate接口的实现，在存储库项目中定义了ICrudDelegate接口。

CRUD协调代理接口非常简单，其类似于：

public interface ICrudDelegate

{

    public Entity[]create(Entity[]entities)；

    public Entity[]update(Entity[]entities)；

    public void delete(Entity[]entities)；

}

在系统启动期间，CRUD协调代理实现由协调初始化代码代理到存储库中。当调用存储库操作时，存储库检查以查看存储库中是否有CRUD协调代理。如果没有CRUD协调代理，则存储库执行CRUD操作而不执行协调。然而，如果有CRUD协调代理，则存储库与CRUD协调代理一起工作以正确执行确认有效性逻辑、其他业务逻辑以及CRUD操作。

对于合成关系，系统可以令Hibernate来持久化对象图形。系统可以这么做是因为系统仅定义了用于合成父母的CRUD协调。

对于数据对象的关联，以及对于数据类型的哈希映射，系统令Hibernate持久化图形。系统可以这么做是因为CRUD协调从来没有被定义用于数据对象或数据类型。然而，对于实体之间的关联，系统定义了用于关联的两端的CRUD协调，并且运行这两个CRUD协调。注意，这要求协调由Hibernate执行的CRUD协调运行和操作以便联结关联的持久化。

以下讨论描述了存储库如何管理CRUD协调的运行以及用于所呈现的实体的对象图形闭包的Hibernate持久化以保存和删除API的细节。

需求和用例

首先，系统可以理想地提供API，此API具有直观行为、易于使用并且产生正确结果。这是顶级要求。此部分中列出的其他一切旨在于为存储库API的客户端满足此要求。例如，API的客户端可以进行以下操作：

1.创建新的顾客实体，包括保存指向新顾客实体的发票(新的或以前保存的)。

2.更新以前保存的顾客实体，包括改变存储器中以前保存的顾客实体、从发票关联到该顾客实体以及保存此发票。

3.更新以前保存的、已经与发票相关联的顾客实体，包括改变存储器中的顾客实体以及保存该发票。

系统也可以运行一个事务下的整套操作。存储库需要在调用存储库操作(例如，保存)的开始时启动事务，并且在该调用结束时提交此事务。如果在操作期间任何点处发生错误，存储库需要回退整个事务。

系统也可以在将阵列递交给CRUD协调代理之前，移除重复的实体。在实体和数据对象的重要图形中，有可能(事实上，很可能)同一实体可由不止一条通过图形的路径到达。例如，两个不同的发票实体可以指向同一顾客实体。

为了避免对协调逻辑的过多调用，存储库可以在将阵列递交给CRUD协调代理之前，将所有复制品从所有阵列中移除，从而使每个不同实体被协调引擎确切地只看到一次。

系统可以被配置为仅递交新实体以创建协调。递交给CRUD协调代理创建方法的阵列应当仅包含新实体(以前从未被保存到数据库的实体)。

系统应当仅递交之前保存的、目前是脏的实体以便更新协调。

注意，递交给CRUD协调代理更新方法的阵列应当仅包含以前已经保存到数据库并且现在脏了的实体。如果实体的任何简单属性已经改变，或者如果其任何1∶1关系已经从非空改变为空(假设它们可以为空)或者从空改变为非空，或者如果其任何汇集关系已经添加或删除了元素，则此实体是脏的。

例如，如果源实体与目标实体之间的单向关联不再存在，则存储库可以将源实体递交给CRUD协调代理以进行更新。类似地，如果两个实体之间的双向关联不再存在，则存储库可以将两个实体都递交给CRUD协调代理以进行更新。注意，这暗示着关系(1∶1和1比多)应当跟踪添加的和删除的元素。

系统应当仅递交以前保存的实体以删除协调。而且，递交给CRUD协调代理删除方法的阵列应当仅包含以前已经保存到数据库的实体。实体可以基于以下两个原因之一而被删除：

1.API客户端明确调用对该实体的存储库删除。

2.实体是从合成关系(1∶1或1比多)移除的合成孩子，并且保存了合成父母，这需要触发对所移除的实体的删除。

系统可以运行沿着用于实体的继承路径定义的CRUD协调。例如，实体类可以是其他实体类的子类，直到建模器指定的任何深度。当对其继承路径中具有父类的实体执行CRUD时，可以在此实体上运行针对此父类定义的CRUD协调。换言之，协调可以多形态地运行。

注意，存储库不能实现此要求，因为其没有要递交到CRUD协调代理中的父实体实例。相反，通过沿着继承路径走以及运行为路径中每个实体类定义的协调，此要求可以完全实现在协调CRUD协调代理内。

系统还可以防止删除新实体。当对新实体调用存储库删除时，其可能抛出异常。(注意，这已经由实体服务处理了。)

系统可以递交扩展实体，来代替对CRUD协调代理的扩展。当对扩展执行CRUD操作时，存储库可以用其扩展实体来替换扩展，以及将扩展实体递交给CRUD协调代理，而不是给它原始扩展。此要求存在两个原因：

1.扩展可以是特定实体的n个扩展之一。为了CRUD协调能够正确地运行，这些CRUD协调应当不仅仅在扩展上运行，而是还在扩展实体上运行，并且在扩展实体的所有其他扩展上运行。通过翻转对其在调用CRUD协调代理之前扩展的实体的扩展，所有协调都正确地运行。注意，这要求协调扩展适当地工作。

2.在合成中，与扩展实体相关联的协调可以被撤消，不过这不会正确地工作，除非扩展实体(而不是扩展)传递到CRUD协调代理中。

系统也应当仅将合成父实体递交给CRUD协调代理。当对新的或脏的合成子实体调用存储库保存或删除时，存储库应当用父实体替换子实体，并且将父实体递交给CRUD协调代理，而不是给它子实体。如果父实体是新的，则存储库可以将父实体递交给CRUD协调代理以进行创建。如果父实体不是新的，则存储库可以将父实体递交给CRUD协调代理以进行更新。

如果拥有子实体的实体本身在合成关系中是孩子，那么存储库可以将此父母的父母给予CRUD协调代理，而不是将父母给予它，依此类推，直到合成关系的传递闭包向上到尽头为止。应当仅将合成链的最终父母给CRUD协调代理以进行更新或创建。

例如，如果A拥有B，B拥有C，则应当仅有为A定义的协调，并且此协调需要处理B和C二者所需的任何业务逻辑。

注意，此要求包含了之前有关扩展的要求，因为扩展被映射为双向1∶1合成，其中扩展作为孩子。然而，由于协调应当在扩展实体的所有扩展上运行的子要求，因此明确调出扩展用例非常重要。

遵从根实体的持久化而运行CRUD协调

此部分概述用于运行CRUD协调以作为存储库持久化操作的一部分的修订方法。用于驱动实体对象的自动CRUD协调的初始设计路径，提供给存储库保存和删除操作，涉及从所提供对象的图形闭包中收集所有候选实体对象以及在同类实体类型的批量中将它们递送给CRUD协调代理，其中实体服务持久化操作和CRUD协调二者都将执行。

紧密耦合的实体持久化和CRUD协调对于递送到存储库保存和删除方法的每个实体对象都能很好地工作。然而，当尝试为作为在保存或删除操作中递送到存储库的实体的对象图形闭包的一部分而间接持久化的实体执行CRUD协调时，产生了疑问。目的为隐含持久化的实体可以很容易地从输入实体的对象图形闭包中标识出来。问题是如何将这种实体递送给CRUD协调代理，其中要执行CRUD协调和持久化二者而不引起持久层中的冲突。例如，如果已经持久化为保存输入实体的一部分，那么保存在递送给存储库.保存(T)的对象图形闭包中发现的新实体将产生异常。

代替于引入对持久化配置的约束或者施加对允许的自动CRUD协调的扩展的限制，可选设计最大化了针对所有受存储库保存和删除操作影响的实体的自动CRUD协调的运行。此思想是通过两步骤处理实体，其中在任何给定时刻仅有单个实体被递送到CRUD协调代理。首先，系统针对提供给存储库操作的每个实体执行持久化和CRUD协调。实际上，递送给CRUD协调代理的实体事实上可以是合成根父母(如果所提供的实体是合成孩子的话)，或者是所提供实体扩展的扩展实体。在此步骤中，转送给CRUD协调代理的实体可以称为“根实体”。注意，根实体已被持久化，并且执行注册的CRUD协调。

在这点上，用于被间接持久化的实体的CRUD协调尚未执行并且有待处理。记住，它们被持久化为根实体持久化的一部分。第二步骤包括将这些实体的每一个发送给CRUD协调代理。在这么做时，实体解除CRUD协调，并且被第二次递送给持久化管理器。在已有实体已经更新过并且正在等待再次更新的情况下，Hibernate会在同一事务内将更新请求合并成一个。基本上，第二保存变为空操作。持久化冲突可能仍然会产生，诸如在新实体被较早地间接持久化为根实体保存操作的一部分的情况中。辨认与已经持久化的实体的持久化的各种类型的冲突以及围绕其进行编码支持自动CRUD协调的更大覆盖。

根实体的对象图形闭包中的新实体(其在保存根实体时就已经持久化)不应当在同一事务中再次呈现给持久层。在CRUD协调代理内，可以检查实体isNew()的值。如果该值为真并且实体也具有ID值(其指示在较早的保存中创建了实例)，则其已经运行了CRUD协调并且不再被持久化。

在提供实体的输入阵列的存储库保存和删除操作中，对于复制实例而言，也有可能显式地出现在阵列元素中，或者隐式地出现在阵列中的实体的对象图形闭包中。除非被处理，否则复制实例可以得到针对同一实体的CRUD协调的多个运行。存储库标识复制实体，并且在遇到异常时抛出异常，以帮助调用方供应实体(无需复制品)给存储库。

删除根实体的对象图形闭包中的相关联实体可能破坏关系的语义。例如，删除发票不应当导致移除与其相关联的顾客。存储库将只删除根实体，因此仅在其上允许CRUD(也即，删除)协调。这意味着，根实体的对象图形闭包中移除或更新的实体跟随根实体的删除，其不会使CRUD协调运行。

针对合成孩子调用删除操作将会抛出异常。存储库可以跳过孩子到其根父母，并且对其调用删除，导致删除父母及其所有孩子。这不应该是调用方的本意。如果删除应当孩子，则应该通过移除指定孩子来修改父母并继而保存。

发送到存储库保持操作的新的合成孩子应当仅是父实体的新孩子。当在相同父母下创建不止一个新子实体时，不可能确定合适的子实体。如果这种情况出现的话，则抛出InvalidOperationException(无效操作异常)。

访客

可以实现访客以标识递送到存储库保存和删除方法的实体的对象图形闭包中新的或更新的实体。访客实现IEntity访客。对于保存和删除两种情况，访客可以：

1.提供在保存和删除模式之间切换的方式。

2.遍历递送到保存(实体)/删除(实体)方法中的整个对象图形、以及递送到保存(实体[])/删除(实体[])方法中的整个对象图形的整个阵列，同时执行循环检测以避免访问任何节点超过一次(已经是EntityCommon中访客实现的一部分)。

3.分析对象图形中的节点以标识和收集应当递送到CRUD协调代理的实体。

对于保存，访客将：

1.除去作为扩展的实体之外，在未设置唯一ID的每个实体中设置唯一ID。

2.将新实体置入特定于每个实体确切类型的创建阵列中。

3.将之前保存的、现在脏了的实体置入特定于每个实体确切类型的更新阵列中。

4.确定每个实体在整个阵列集合中只出现一次。

5.利用扩展所扩展的内容来替换扩展。

6.利用合成子实体的父实体来传递性地替换这些合成子实体，直到到达最终父母。

7.使得所收集的阵列实体对于存储库可用。

对于删除，访客可以确定对象图形闭包中的实体是否是新的，以支持存储库抛出异常。注意，实体服务已经实现了这个，不过如果系统可以较早抓住错误，那么将整个图形发送给服务器就太浪费了。

存储库行为

当调用存储库保存时，存储库可以：

1.启动事务。

2.创建访客并将其置入保存模式。

3.在一个或多个输入实体或实体上运行该访客。

4.翻转标识为对扩展实体的可扩展的根实体。

5.翻转标识为根合成父母的合成孩子的根实体。

6.将根实体递交给CRUD协调代理更新或创建方法。

7.将访客所标识的每个实体递交给CRUD协调代理更新或创建方法。

8.提交事务以完成实体对数据库的持久化。

9.将保存的实体/多个实体返回给调用方。

当调用存储库删除时，存储库可以：

1.启动事务。

2.创建访客并将其置入删除模式。

3.如果在对象图形闭包中发现新实体，则在根实体上运行访客以抛出异常。

4.对于删除(实体[])，如果在对象图形闭包中发现复制实体，则抛出异常。

5.将根实体递交给CRUD协调代理删除方法。

6.提交事务。

异常

在处理用于保存和删除操作的输入实体中，存储库标识多个新的错误情形。在每种情况中，抛出InvalidOperationException(无效操作异常)。异常被存储库抓住以便回退针对保存或删除操作初始发起的事务。注意，异常详述了：

1.新实体被提供给删除操作。

2.在提供给保存操作的实体的对象图形闭包中发现了没有合成父实例的合成孩子。

3.合成孩子被提供给删除操作。假定存储库总是翻跳到父母，则删除父母不太适合。

4.在提供给保存操作的一个或多个实体的对象图形闭包中发现同一实体实例多次出现。

5.在提供给保存操作的实体的对象图形闭包中发现未解决的实体。

6.不能返回对应于提供给保存操作的实体的已保存对象。

仅出于示例性和描述性的目的提供了本发明的实施方式的前述描述。其意图不在于穷尽或将本发明限制于所公开的形式。相应地，对于本领域的技术实践者而言，多种修改和变形是很明显的。此外，上述公开不在于限制本发明。本发明的范围由所附权利要求来定义。

Claims (18)

1.一种用于实现持久化应用编程接口(API)的方法，所述持久化API是平台独立的并且能够对业务逻辑进行向上调用，所述方法包括：

在所述API处接收在n层分布式应用的持久层处执行命令的请求；

响应于所述请求，确定受所述命令影响的实体的实体类型；

标识与所述实体类型和所述命令相关联的、所述n层分布式应用的中间层处的函数，其中所述中间层包括所述业务逻辑；

向所述中间层发送指令以执行所述函数；以及

响应于在所述API处接收到有关所述函数已执行的确认，在所述持久层处执行所述命令。

2.如权利要求1的方法，其中向所述中间层发送所述指令还包括向所述中间层发送所述命令，其中所述命令的一部分用作所述函数的参数。

3.如权利要求1的方法，还包括在所述API处从所述中间层接收在所述持久层执行第二命令的第二请求。

4.如权利要求3的方法，还包括：

响应于所述第二请求，确定受所述第二命令影响的第二实体的第二实体类型；

标识与第二实体类型和第二命令相关联的、所述n层分布式应用的所述中间层处的第二函数；

向中间层发送第二指令以执行第二函数；以及

响应于在API处接收到有关第二函数已执行的第二确认，在持久层执行第二命令。

5.如权利要求1的方法，还包括：

在所述API处创建包括所述指令和所述命令中的至少一个的事务；

确定在中间层处是否成功执行所述函数以及在持久层处是否成功执行所述命令；

如果是，则提交所述事务；以及

如果否，则回退所述事务。

6.如权利要求5的方法，其中创建所述事务可以包括在持久层处创建持久层子事务，其中提交所述事务包括提交所述持久层子事务，并且回退所述事务包括回退所述持久层子事务。

7.如权利要求1的方法，其中所述持久层包括关系型数据库。

8.如权利要求1的方法，其中在标识在所述n层分布式应用的中间层处的所述函数之前，所述方法还包括：在API处接收注册，该注册标识所述函数以及相关联的实体类型和命令。

9.如权利要求1的方法，其中标识中间层处的所述函数以及向中间层发送所述指令的步骤由协调代理来处理，其中当满足注册条件时，所述协调代理命令执行先前向API注册的代码。

10.一种用于实现持久化应用编程接口(API)的设备，所述持久化API是平台独立的并且能够对业务逻辑进行向上调用，所述设备包括：

用于在所述API处接收在n层分布式应用的持久层处执行命令的请求的装置；

用于响应于所述请求，确定受所述命令影响的实体的实体类型的装置；

用于标识与所述实体类型和所述命令相关联的、所述n层分布式应用的中间层处的函数的装置，其中所述中间层包括所述业务逻辑；

用于向所述中间层发送指令以执行所述函数的装置；以及

用于响应于在所述API处接收到有关所述函数已执行的确认，在所述持久层处执行所述命令的装置。

11.如权利要求10的设备，其中用于向所述中间层发送所述指令的装置还包括用于向所述中间层发送所述命令的装置，其中所述命令的一部分用作所述函数的参数。

12.如权利要求10的设备，其中所述设备还包括用于在所述API处从所述中间层接收在所述持久层执行第二命令的第二请求的装置。

13.如权利要求12的设备，还包括：

用于响应于所述第二请求，确定受所述第二命令影响的第二实体的第二实体类型的装置；

用于标识与第二实体类型和第二命令相关联的、所述n层分布式应用的所述中间层处的第二函数的装置；

用于向中间层发送第二指令以执行第二函数的装置；以及

用于响应于在API处接收到有关第二函数已执行的第二确认，在持久层执行第二命令的装置。

14.如权利要求10的设备，还包括：

用于在所述API处创建包括所述指令和所述命令中的至少一个的事务的装置；

用于确定在中间层处是否成功执行所述函数以及在持久层处是否成功执行所述命令的装置；

用于如果是，则提交所述事务的装置；以及

用于如果否，则回退所述事务的装置。

15.如权利要求14的设备，其中用于创建所述事务的装置可以包括用于在持久层处创建持久层子事务的装置，其中用于提交所述事务的装置包括用于提交所述持久层子事务的装置，并且用于回退所述事务的装置包括用于回退所述持久层子事务的装置。

16.如权利要求10的设备，其中所述持久层包括关系型数据库。

17.如权利要求10的设备，其中在标识在所述n层分布式应用的中间层处的所述函数之前，所述设备还包括：用于在API处接收注册的装置，该注册标识所述函数以及相关联的实体类型和命令。

18.如权利要求10的设备，其中用于标识中间层处的所述函数的装置以及用于向中间层发送所述指令的装置由协调代理来处理，其中当满足注册条件时，所述协调代理命令执行先前向API注册的代码。

Images