如何配置 OData 服务器

必须在配置文件中对数据库连接参数、嵌入式 HTTP 服务器选项和 OData 创建器选项进行配置。启动 OData 服务器时在命令行中指定此文件。

嵌入式 HTTP 服务器选项

可在配置文件中指定以下嵌入式 HTTP 服务器选项：

选项	说明
LogFile = path-and-filename	指定路径和文件名，以供嵌入式 HTTP 服务器记录 OData 创建器输出。缺省行为是禁用记录功能。路径相对于服务器可执行文件的位置。
LogVerbosity = { 1 \| 2 \| 3 \| 4 }	指定日志的详细程度级别。较高的详细程度级别中记录了追加信息，并且包括所有较低级别提供的信息。详细程度级别 1 将输出所有意外错误的相关信息。详细程度级别 2 将输出一般信息和配置消息。详细程度级别 3 将输出关于 HTTP 请求的详细信息。详细程度级别 4 将输出调试消息。
ServerPort = port-number	指定嵌入式 HTTP 服务器应监听的端口号。缺省设置为 80。
ShutdownListenerPort = port-number	指定嵌入式 HTTP 服务器应监听哪个端口号上的关闭请求。缺省设置为 2449。
SSLKeyStore = path-and-filename	指定嵌入式 HTTP 服务器对通信量进行加密时所用 SSL 证书所在的 Java 密钥存储库的路径和文件名。指定此选项时，将启用 SSL 并阻塞未加密的 HTTP 通信量。路径相对于服务器可执行文件的位置。
SSLKeyStorePassword = SSLKeyStore-password	指定嵌入式 HTTP 服务器在针对由 SSLKeyStore 选项标识的 Java 密钥存储库进行验证时使用的口令。

OData 创建器选项和数据库连接参数设置

可在配置文件中指定以下 OData 创建器选项和连接参数设置：

选项	说明
Authentication = { none \| database }	指定用于连接到数据库的证书。缺省设置 database 表示各个用户使用个性化证书进行连接，这些个性化证书附加到 DbConnectionString 选项中以形成其自己的完整数据库连接字符串。使用基本 HTTP 验证请求这些证书。 none 设置表示所有用户使用同一个连接字符串进行连接，该连接字符串由 DbConnectionString 选项指示。
ConnectionPoolMaximum = num-max-connections	表示 OData 创建器保持打开以供在连接池中使用的最大同时连接数。连接池使用的连接可能会更少，这取决于服务器的负荷。缺省情况下，连接池大小受数据库服务器所允许的最大同时连接数的限制。
DbConnectionString = connection-string	指定用于连接到数据库的连接字符串。当验证选项设置为数据库时，连接字符串应排除 UID 和 PWD 参数。
DbProduct = sqlanywhere	表示 OData 创建器所连接到的数据库服务器的类型。
PageSize = num-max-entities	指定在下一条链接发出之前，检索实体集响应中可包括的最大实体数。缺省设置为 100。
Model = path-and-filename	指定 OData 服务定义语言（OData Service Definition Language，简称 OSDL）文件的路径和文件名，该文件中所含的 OData 创建器服务模型可指出 OData 元数据中将公开哪些表和视图。缺省行为是根据用户特权对表和视图进行公开。不会公开不具备主键的表和视图。路径相对于服务器可执行文件的位置。
ModelConnectionString = connection-string	指定 OData 创建器在启动期间校验 OSDL 文件时所使用的连接字符串。 OSDL 校验可确保以下内容：征用的表和列均存在，密钥列表的使用正确，且文件的语义正确。连接字符串应包括 UID 和 PWD 参数。缺省行为是假设 OSDL 文件有效。
ReadOnly = { true \| false }	指出是否应忽略修改请求。缺省设置为 false。
ServiceRoot = / path-prefix	指定 OData 服务器上 OData 服务的根目录。缺省设置为 /odata。此 OData 创建器的所有资源均通过以下格式的 URI 进行访问： scheme:host:port/path-prefix/resource-path[query-options] 例如：http://services.odata.org/OData/OData.svc/Category(1)/Products?$top=2&$orderby=name

另请参见

示例

以下示例说明了如何格式化配置文件以使用 OData 服务器：

# Embedded HTTP server options
# ----------------------------
LogFile = ../../odata.log
LogVerbosity = 1
ServerPort = 8000
ShutdownListenerPort = 8083
SSLKeyStore = ../../samplekeystore.jks
SSLKeyStorePassword = pwd

# OData Producer options
# ----------------------
Authentication = none
ConnectionPoolMaximum = 10
DbProduct = sqlanywhere
Model = ../../model.osdl
ModelConnectionString = uid=dba;pwd=sql;eng=orderentry;dbf=orderentry.db
PageSize = 100
ReadOnly = false
ServiceRoot = /odata/MyProducer

# Database connection parameters
# ------------------------------
DbConnectionString = uid=dba;pwd=sql;eng=orderentry;dbf=orderentry.db

将文件保存为 server.properties，然后运行以下命令以使用该配置文件中所指定的选项来启动 OData 服务器：

dbosrv16 server.properties

使用DocCommentXchange讨论此页。