MOAI 2.0.0

MOAI，机构知识库的开源服务器平台

MOAI是一个从不同来源聚合内容并通过开放存档初始化协议进行元数据收割进行发布的平台。它专为处理关系元数据和资产文件的教育机构知识库而构建。

安装MOAI

MOAI软件可以在任何wsgi兼容的服务器上运行。

MOAI附带一个开发服务器，可用于测试。在生产中，可以使用mod_wsgi在Apache网关中运行Moai。

安装步骤

MOAI是一个普通的Python包。它已在python2.5和2.6上进行了测试。我建议创建一个virtualenv来安装该软件包。

http://pypi.python.org/pypi/virtualenv/

这使得开发和部署更加容易。以下说明针对Unix，但MOAI也应该在Windows上运行

进入包含setup.py的MOAI目录，并运行virtualenv命令

> cd moai > virtualenv .

现在，激活virtualenv

> source bin/activate

使用pip在virtualenv中安装MOAI

> pip install -e .

(这可能需要一段时间)

当此过程完成后，Moai及其所有依赖项将被安装。

以开发模式运行

开发服务器不应用于生产，它方便用于测试和开发。请注意，您应始终激活virtualenv，否则将找不到依赖项

> cd moai > source bin/activate > ./bin/paster serve settings.ini

这将打印如下内容：

启动服务器，PID为7306。在http://127.0.0.1:8080上启动HTTP服务器

您现在可以访问localhost:8080/oai来查看moai oaipmh源。

配置MOAI

配置在settings.ini文件中进行。默认设置文件使用Paste#urlmap应用程序将wsgi应用程序映射到URL。

在composite:main部分中有一行：

/oai = moai_example

它将/oai URL映射到Moai实例。这使得在一个服务器上运行多个Moai实例并具有各自配置变得容易。

app:moai_example配置允许您指定以下选项：

name

OAI源（在Identify动词返回）的名称

url

OAI数据流的URL（在oaipmh xml输出中返回）

admin_email

管理员的电子邮件地址（在Identify动词中返回）

formats

可用的元数据格式

disallow_sets

不允许在此数据流输出中使用的setspec列表

allow_sets

如果使用，则仅返回此处列出的集合

database

用于存储的数据库的SQLAlchemy uri

provider

moai从其中检索内容的提供者标识符

content

将提供者格式映射到moai格式的类

添加内容

Moai系统旨在定期从提供者那里抓取内容，并将其转换为Moai的内部格式，然后可以将其转换为oaipmh数据流的不同元数据格式。

Moai附带了一个示例，展示了这一原理

在moai/moai目录中有两个XML文件。让我们假设这些文件来自一个远程系统，我们希望使用MOAI发布它们。

在settings.ini文件中，指定了以下选项

provider = file://moai/example-*.xml

这告诉moai我们想使用一个文件提供者，一些文件位于moai/example-*.xml。

以下选项指向我们想要用于将示例内容XML数据转换为Moai内部格式的类。

content = moai_example

最后一个选项告诉Moai存储数据的位置，这通常是一个sqlite数据库

database = sqlite:///moai-example.db

现在让我们尝试添加这两个XML文件，首先访问oaipmh数据流以确保没有任何内容正在被提供

http://localhost:8080/oai?verb=ListRecords&metadataPrefix=oai_dc

这应该返回一个noRecordsMatch错误。

要添加内容，运行update_content脚本，以settings.ini中的部分名称作为参数

> ./bin/update_moai moai_example

这将产生以下输出

/ 正在更新内容提供者：example-2345.xml 内容提供者返回了2个新的/修改的对象

100.0%[====================================================================>] 2 更新数据库中的2个对象耗时0秒

现在当您再次访问oaipmh数据流时，您应该看到这两个记录

http://localhost:8080/oai?verb=ListRecords&metadataPrefix=oai_dc

当您再次运行update_moai脚本时，它将创建一个新的数据库，其中包含所有记录（在本例中为moai_example.db）。您也可以使用–date开关指定数据。当指定数据时，仅添加在此日期之后修改的记录。update_moai脚本可以从每日或每小时cron作业中运行以更新数据库

添加您自己的提供者/内容和元数据类

扩展Moai以适应您的用例是可能的，也是大多数情况下需要的。如果想要这样做，示例中的提供者和内容类可能是一个很好的起点。您所有的自定义都应该通过entry_points注册到Moai中。有关更多信息，请参阅Moai的setup.py。最佳方法是将自己的python包与setup.py创建，并将其安装在与Moai相同的环境中。这将使Moai能够找到您的自定义。请注意，当您更改setup.py中的内容时，您必须重新安装包，以便Moai能够识别更改。

请注意，moai.interfaces文件包含了有关您可以实现的不同类的文档。

添加您自己的数据库

除了编写自己的提供者/内容类，您还可以注册自己的自定义数据库。实现moai.database.SQLDatabase的替代品可能比编写提供者/内容类更复杂，但它有一个优点，那就是Moai始终是最新的，并且您不需要第二个sqlite数据库。

查看MOAI代码中的setup.py文件，它注册了几个数据库。您可以使用此机制从自己的Python包中注册自己的数据库。

在settings.ini配置中，您可以引用您的数据库（“mydb://some+config+variables”）。

对于数据库，请查看database.py中的通用数据库提供程序。您需要实现的方法只有：oai_sets，oai_earliest_datestamp和oai_query。oai_query方法返回包含记录数据的字典。这些字典的键在元数据文件（例如metadata.py）中定义，请查看源代码。

对于oai_dc，有以下名称

“标题”，“创作者”，“主题”，“描述”，“出版商”，“贡献者”，“类型”，“格式”，“标识符”，“来源”，“语言”，“日期”，“关系”，“范围”，“权利

因此，返回值可能如下所示

{'id': <oai record id>,
 'deleted': <bool>,
 'modified': <utc datetime>,
 'sets': <list of setspecs>,
 'metadata': {
   'title': [<list with publication title>],
   'creator': [<list of creator names>],
   ...}
}

MOAI变更