资源和工作空间

用户的数据文件的中枢称为工作空间。可以认为平台工作台是一种工具,它允许用户浏览和处理工作空间。资源插件提供了用于创建、浏览和处理工作空间中的资源的 API。工作台使用这些 API 来为用户提供此功能。插件也可以使用这些 API。

从基于资源的插件的观点来看,只有一个工作空间,并且只要插件在运行,它就始终是打开的,以便处理事务。当激活资源插件时,工作空间会自动打开,当关闭平台时,平台也会关闭。如果您的插件需要资源插件,则资源插件将在您的插件之前启动,而工作空间将是可用的。

工作空间包含资源集合。在用户的透视图中,有三种不同类型的资源:项目文件夹文件。项目是任意数目的文件和文件夹的集合。它是用来组织与特定区域相关的其它资源的容器。文件和文件夹就象文件系统中的文件和目录。文件夹包含其它文件夹或文件。文件包含任意顺序的字节。其内容不是由平台解释的。

工作空间的资源组织成树结构,项目位于顶部,而文件夹和文件在下面。特殊资源、工作空间根目录资源充当资源树的根目录。工作空间根目录是在创建工作空间时在内部创建的,只要工作空间存在,工作空间根目录就存在。

工作空间可以有任何数目的项目,每个项目都可以存储在磁盘上的不同位置。

工作空间资源名称空间始终是区分大小写且保持大小写的。因此,工作空间允许多个同代资源以仅大小写不同的名称存在。工作空间对资源名称中的有效字符、资源名称的长度或磁盘上资源的大小也没有任何限制。当然,如果您将资源存储在不区分大小写或存储在对资源名称有限制的磁盘上,则当您实际尝试创建和修改资源时,那些限制始终存在。

样本资源树

以下树(在工作台导航器视图中表示)说明了工作空间中的资源的典型层次结构。树的(隐含)根目录是工作空间根目录。项目是工作空间根目录的直接子代。每个节点(不同于根目录)是三种资源中的其中一种,并且每个节点的名称都与它的同代节点的名称不同。

带有样本工作空间的导航器视图

资源名称是任意字符串(几乎 - 它们必须是合法的文件名)。平台本身不限定资源名称,它也不指定任何具有特殊意义的名称。(一种例外的情况是不能将项目命名为“.metadata”,原因是此名称是内部使用的)。

项目包含文件和文件夹,但是不包含其它项目。项目和文件夹在文件系统中是类似的目录。删除项目时,将询问您是否想删除它包含的所有文件和文件夹。从项目中删除文件夹时将删除该文件夹及其所有子代。删除文件类似于在文件系统中删除文件。