由于NE提供了接口支持对其保存的资源进行几乎所有的操作,所以提交工具获取资源部分比较简单,仅仅通过界面选择,然后调用接口将需要处理的资源信息导入到提交工具中即可。NE接口定义如图2所示:

图2

	Figure Option ViewDownloadNew Window
	图2 NE接口定义

在提交工具中需要用户选择提交到DSpace系统的具体Collection(专题),所以需要获取DSpace系统的组织结构信息,同时为了DSpace的数据安全,提交工具将在提交的时候带入DSpace的用户验证信息,这样DSpace系统就可以验证是否接受用户提交的资源。提交工具使用HTTP协议访问机构知识库的组织结构,即Community/Collection页面,然后通过页面分析即可以获取到完整的Community/Collection树形图,如图3所示:

图3

	Figure Option ViewDownloadNew Window
	图3 提交工具组织结构展现

提交工具将数据通过网络传递到DSpace系统,需要定义数据规范。数据按照该规范由提交工具提交到DSpace系统,然后DSpace服务器端负责解析数据,并保存到DSpace仓库中。为了简化系统开发,规范采用“文本+简单标签”方式来传输数据。该数据传输格式简单,便于解析还原出原始的信息。编码后数据传输到DSpace系统采用的是HTTP协议,由于数据资源中包含全文附件,所以采用HTTP Multipart/Form-data的编码方式上传数据,这样可以将元数据和附件数据同时打包发到DSpace服务器。在不更改DSpace系统的情况下,在DSpace服务器端将数据解析和提交的逻辑封装在一个新Servlet中,然后配置DSpace网站系统(北工大使用的是JSPUI应用)的web.xml文件,将该Servlet安装到DSpace的JSPUI子系统中。

NE有比较完善的接口,提交工具需要用到的NE接口有: INEHost2、INELibraries、sINEItems、INEItem^{[ 8]}。通过以下步骤获取NE中选中记录的全部信息:

(1)通过Windows的API函数CreateComObject("NEHost2"),可以获取NE的根接口——INEHost2,它包含4个属性,分别是:Libraries,Services,Internals,MainForm;

(2)通过根接口INEHost2的Libraries属性获取当前选择的数据库,该属性返回的是一个INELibraries接口类型;

(3)通过当前选择数据库的接口INELibraries的SelectedItems属性获取所有选择的记录集合,该属性返回的是INEItems接口类型;

(4)通过获取的记录集合接口INEItems的Count属性和Items属性枚举出所有的记录对象;

(5)通过记录对象接口INEItem的Values属性和AttachmentFiles属性获取记录的元数据和附件信息。

对照NE软件,找到接口各自的对应关系如图4所示(与MS Office类似,NE的接口封装大部分也可以与界面元素相对应):

图4

	Figure Option ViewDownloadNew Window
	图4 NE软件中接口的对应关系

在提交工具中获取NE选择的记录信息的核心代码如下:

FItems:= FHost.Libraries.SelectedItems;//FHost是NoteExpress自动化根接口

FItems.Items[I].Values['Title'];//获取第I条资源标题

提交工具通过HttpSend库,采用浏览器访问方式,使用HTTP协议来与DSpace系统进行交互。获取组织结构就是通过访问community-list页面,然后通过转换为XML格式,以反映其层级关系,最后再将XML格式反馈到提交工具界面上(见图3),在获取组织结构前,系统将弹出用户校验界面,只有通过DSpace验证的用户才能获取组织结构数据。

按照设计的传输格式,提交工具将转换数据格式,并且集成用户信息、数据提交目标位置和附件全文等信息,然后通过HttpPost方法提交到DSpace系统中。

为了接收从客户端提交工具发送过来的数据,DSpace服务器端需要在JSPUI中新建一个NeImportServlet,对客户端数据进行解析,然后保存到DSpace仓库中。

NeImportServlet的框架代码如下:

public class NeImportServlet extends DSServlet {

protected void doDSGet(Context context, HttpServletRequest request, HttpServletResponse response) throws Exception {

throw new Exeption("Get Method Is Not Supported.");

//不支持get请求

}

protected void doDSPost(Context context, HttpServletRequest request, HttpServletResponse response) throws Exception {

//核心处理例程,所有的导入逻辑都将在本函数中处理完成

…

}

NeImportServlet首先使用DSpace封装好的FileUploadRequest对象接收客户端提交过来的数据并解析出各个部分。然后采用DSpace默认的发布对象来发布资源,这中间包含字段映射的处理步骤,将资源由网络传输的格式转换为DSpace需要的对象。为了操作的简便和利于未来代码的维护,对整个操作进行简单封装,以便调用更加简洁,但其内部都是基于DSpace的标准提交方式:

addNeRefrence(context, context.getCurrentUser(), collectionHandle, fur));

DSpace内部标准提交的开发方法,可以参考文献[9]中Metadata Import数据批量导入接口的核心源代码,addNEReference内部就是借鉴其实现代码,也可以参考DSpace源码中的InstallItem部分^{[ 10]}。最后将NeImportServlet安装到DSpace的JSPUI子系统中,修改web.xml,加入以下部分:

<servlet>

<servlet-name>neimport</servlet-name>

<servlet-class> web.Servlet.NeImportServlet</servlet-class>

</servlet>

<servlet-mapping>

<servlet-name>neimport</servlet-name>

<url-pattern>/neimport</url-pattern>

</servlet-mapping>

安装完成后,提交工具可以通过http://DSpace-URL/neimport来提交数据(网址中的DSpace-URL部分为用户实际部署DSpace的IP地址或者域名)。至此,整个系统从设计到编码全部完成。