NNTP服务受config.xml文件中的nntpserver和nntp-repository配置块控制。
nntpserver配置块
nntpserver标签定义了nntpserver配置块的边界,它包含了大部分的NNTP服务器相关配置。
这个标签有一个可选的布尔属性- enabled -定义了这个服务是否处于活动状态。如果该属性不存在,则取默认值“true”。
nntpserver标准的子标签是:
port -可选的整型值,配置NNTP服务器在哪个端口上监听。如果这个标签或它的值被忽略了,则取默认的标准NNTP端口-119。
bind - 可选值,描述绑定该服务的IP地址,是一个字符串值。 如果这个标签或它的值没有出现,则该服务将绑定到机器的所有网络接口。
useTLS - 可选的布尔值,如果其值为“true”,使用“ssl”服务器socket接口工厂为这个服务生成服务器socket连接。否则使用“plain”服务器socket工厂。但无论该值为什么,如果配置文件中存在下面专家配置选项中所讨论的serverSocketType标签,该行为最终都由serverSocketType标签的值决定。
handler - 这是一个保持向后兼容性的工艺品,它只是将一些相关的参数放到一组中。在将来的版本中这个标签应该会被去掉。
helloName - 这是一个必需的标签,它的值定义了用于服务启动时的问候语中的服务器名,但它的值是可选的。这个标签可能会有一个可选的属性 - autodetect。如果autodetect属性存在并且为“true”,则该服务会使用Java库返回的本地主机名。否则就使用该标签的值,在这种情况下,如果标签的值不存在,那就会用“localhost”。
connectionTimeout - 取值为非负整型值的可选标签。
authRequired - 取值为布尔值的可选标签,如果其值为“true”,服务器在允许客户端显示新闻文章之前会要求身份认证。如果这个标签不存在或其值为“false”,就不会提示客户端进行身份认证。现在还只支持简单的用户/口令认证方式。
nntpserver标签还有几个适用于高级配置的子标签。这些值仅供专家级的系统管理员使用,在这一组中的所有标签都是可选的。
serverSocketFactory - 取值为字符串值的可选标签,如果该标签存在,那它的值必须是一个在socket manager块中说明的服务器socket工厂的名字。其它任何值都将导致一个错误。另外,这个值会使useTLS标签失效。
threadGroup - 取值为字符串值的可选标签,如果该标签存在,那它的值必须是一个在thread manager块中说明的线程组的名字。其它任何值都将导致一个错误。这个标签最好用于在服务之间协调优化线程的分配。
connectionLimit - connectionLimit参数说明了该服务所允许的最大客户端连接。如果没有说明任何值,则默认为connectionmanager块中所定义的值。0表示该服务不对打开的连接数进行任何限制,尽管其它组件(比如线程数的最大值)的资源限制可能会限制能够打开的连接数。
nntp-repository配置块
NNTP服务的其余配置信息包含在nntp-repository配置块内。这部分的配置数据与服务器端的NNTP文章存储有关。
readOnly - 必需的布尔类型标签,如果该值为“true”,NNTP服务器将不允许post方法。
rootPath - 必需的字符串类型标签, 它必须是带有前缀“file”的URL格式。这个标签指定了NNTP数据仓库的的根目录。NNTP服务器上的组会映射为这个根目录下的文件夹,并且新闻文章会存储在适当的文件夹中。
tempPath - 必需的字符串类型标签,它必须是带有前缀“file”的URL格式。这个标签指定了NNTP服务器在将已提交的文章添加到缓冲池之前的文件存储目录。
articleIDPath - 必需的字符串类型标签, 它必须是带有前缀“file”的URL格式。这个标签指定了NNTP服务器保存文章ID和包含文章的组之间的映射信息的目录。
articleIDDomainSuffix - 必需的字符串类型标签,添加到所有NNTP服务器产生的文章ID的后缀。
newsgroups - 必需的容器标签,这个服务器上的每个新闻组都有一个单独的newsgroup子标签。每个newsgroup标签的值都是新闻组的名字,