java 的 web 服务器 jswdk 的配置文件 webserver.xml 的翻译文档

翻译 2002年05月24日 12:27:00

<!--
<?xml version="1.0" encoding="gb2312"?>

这个文件是 JSWDK server 缺省的配置文件。下面是 JSWDK server 配置项目的说明。

========================================================

webserver.xml 文件的 dtd 和 xml(格式说明):

元素
    属性(等)
    子元素(等)
========================================================

WebServer - 由一个单独的 HTTP Web Server 实例管理的一套web services 的集合。
 
    id - 一个唯一的 Web Server 的 id
               
    adminPort - 用于从外部对 Web Server 进行管理,例如便捷的执行关闭 Web Server 等管理功能,的端口号。(注:这些管理功能目前还没有提供,这是下一步考虑发展的目标) 
            
    Service - 一个可以被管理的 web service。          
    
Service - 一个可以通过完全合理的网络地址访问的单独的网络资源。
  
    id - 一个唯一的 Service 的 id。 
    port - Service 所注册的端口号。
    hostName - Service 存放的主机的主机名。
   
    inet - Service 存放的主机的 ip 值。
    docBase - Service 主文档的本地文件存放的相对路径.        
    workDir - Service 本地工作记录存放的相对路径.      
    workDirIsPersistent - 注明 Web Server 是否在主机系统关闭的时候把相关的工作文件夹存放到指定的工作目录。
        
    WebApplication - 一个对网络资源进行管理功能的集合     

WebApplication - 一个可以对完全合理的网络地址作出反应的相关联的网络资源的集合   
    id - 一个唯一的 Web Application 的 id. 
    mapping - 可以通过 Service 的路径访问该 Web Application 映射的 URL 前缀
    docBase - 存放该 Web Application 的主文档的相对路径
    maxInactiveInterval - session 最长的过期时间      
   
========================================================

startserver 命令 参数:

 -help                     显示帮助信息
 -config [file|url]        从指定的文件,或者  [file|url] 读取配置信息
 -noconfig                 不读取配置信息
 -adminport [int]          指定管理端口
 -serviceid [str]          开始指定的 serviceid 的服务
 -port[:id|:*] [int]       监听指定的 serviceid 的服务的端口
 -inet[:id|:*] [inetaddr]  把新的 [inetaddr] 的 ip 的服务器绑定到指定的 serviceid 的服务
 -hostname[:id|:*] [name]  使用新的主机名 [name] 作为指定的 serviceid 的服务的主机名
 -docbase[:id|:*] [name]   使用 URL 地址[name] 作为指定的 serviceid 的服务的主文档
 -workdir[:id|:*] [name]   使用 [name] 位置的文件夹作为指定 serviceid 的服务的工作记录文件夹

========================================================  
   
属性配置的详细说明: 
  
    同一类元素的 “id” 必须唯一。
   
    绝大多数配置项目的值可以通过以下三种不同的方法之一来设置
   
    1。 startserver 命令的参数
    2。 xml 文件的对应配置项目的值
    3。 xml 文件的 dtd 为对应的配置项目设置的 and/or 的缺省值
   
    很多配置项目,都在 xml 的 dtd 中,或者在 JSWDK 中有缺省的值。这些缺省的值可以通过修改 startserver 命令导入的存放配置信息的 webserver.xml 文件的元素及元素属性的值来更替。

    JSWDK 服务器在某些平台上可以使用缺省的 webserver.xml 里设置的配置信息,不需要做任何调整,就可以使用。

    如果 JSWDK 服务器在初始化的时候,如果没有在安装目录发现保存配置信息的 webserver.xml 文件,同时在使用 startserver 命令时也没有使用 “-config [file | url]” 参数来指定一个包含配置信息的文件的话,那么 JSWDK 服务器就会自己创建一个缺省的配置文件。

    如果没有指定一个 WebServer 的管理端口,那么 JSWDK 服务器就会在开启时,在端口 2048 - 8192 之间随机尝试 5 次,寻找一个有效的端口作为管理端口,如果成功,被选中的端口就会被写入 “webserverlog.txt” 文件中。如果没有指定 WebServer 的管理端口,同时JSWDK 尝试寻找端口的努力也失败的话,则服务器不会被启动。
   
    元素 WebServer 的 id 属性,可能会在以后的版本中被取消。
   
    元素 WebApplication 的 mapping 属性是标注一个 URI 前缀,使得可以通过相应的地址来访问该 Web Application 的一个实例。该元素属性的值在同一个 Service 的实例中必须是唯一。在以后的版本中,该元素属性的名称可能被修改为“path” 。

    元素 WebApplication 的 docBase 属性是当该 Web Application 被网络访问调用时,Web Server 可以找到该 Web Application 的物理路径。该元素属性的值的描述和上面的 元素 Server 的 docBase 属性的描述有很多相似点。

    元素 WebApplication 的 maxInactiveInterval 属性在目前还没有被使用。在后继的版本中可能作为指定 “session 过期的时间” 来使用。

========================================================

另注:
 只要使用符合已经注明的 dtd 格式和相应规则,来书写 xml 的内容,很多Service 和 Web Application 实例的配置信息都可以很方便的添加到一个已经存在的 Web Server 的配置信息中。

========================================================

 

<!DOCTYPE WebServer [

<!ELEMENT WebServer (Service+)>
<!ATTLIST WebServer
    id ID #REQUIRED
    adminPort NMTOKEN "">

<!ELEMENT Service (WebApplication*)>
<!ATTLIST Service
    id ID #REQUIRED
    port NMTOKEN "8080"
    hostName NMTOKEN ""
    inet NMTOKEN ""
    docBase CDATA "webpages"
    workDir CDATA "work"
    workDirIsPersistent (false | true) "false">

<!ELEMENT WebApplication EMPTY>
<!ATTLIST WebApplication
    id ID #REQUIRED
    mapping CDATA #REQUIRED
    docBase CDATA #REQUIRED
    maxInactiveInterval NMTOKEN "30">
]>

<WebServer id="webServer">
    <Service id="service0">
        <WebApplication id="examples" mapping="/examples" docBase="examples"/>
    </Service>
</WebServer>

-->

java 的 web 服务器 jswdk 的配置文件 webserver.xml

  • zgqtxwd
  • zgqtxwd
  • 2008年04月25日 17:45
  • 148

Java开发Web程序中修改类文件和配置文件不重启服务器的方法

开发环境 1.  JDK 2.  MyEclipse 3.  Tomcat 4.  Struts2 5.  JavaRebel/JRebel   第一步:修改...
  • aimiaochun1
  • aimiaochun1
  • 2014年12月15日 18:49
  • 1327

javaWeb项目中读取配置文件

在开发过程中,我们经常会遇到读取配置文件的情况,对于配置文件的读取,根据环境等情况又各有不同,一般情况下,如果从非jar包中使用相对/路径,比较简单,就不在累述了,而在很多情况下,我们需要把我们的cl...
  • lcj8
  • lcj8
  • 2008年04月17日 18:36
  • 5485

sun 提供的 jswdk 的 FAQ 的翻译文档

 JavaServer Pages (tm) Web Development Kit  [faq] 这一份文档列出了一些经常被提及的有关 JavaServer(TM) Web Development ...
  • joards
  • joards
  • 2002年05月24日 12:24
  • 558

java中读取服务器配置文件方法

自定义配置文件 配置文件名为:project.properties,内容如下: 1 2 3 # 是否开启逻辑删除 del.filter.on=fal...
  • u014196852
  • u014196852
  • 2014年12月29日 23:44
  • 1011

关于一个具有配置文件的 Java Project 项目(非 web 项目)在服务器上的一个便捷部署

用 Eclipse 写了一个可以执行的 Java Project 项目,是一个数据库性能自动测试的项目,有很多配置文件,比如数据库的 log4j.properties,日志的 log4j.proper...
  • defonds
  • defonds
  • 2013年11月11日 15:12
  • 11523

Java中最常见的5种Web服务器介绍

Java中最常见的5种Web服务器分别是: Tomcat、Resin、JBoss、WebSphere、WebLogic, Web服务器是运行及发布Web应用的容器,只有将开发的Web项...
  • singit
  • singit
  • 2017年04月29日 23:40
  • 1251

web项目目录结构和一些配置文件

在一个web项目中,一般都会有这两个文件src、WebweContent(WebRoot)目录,具WebContent(Eclipse)还是WebRoot(Myeclipse)要看你是使用什么开发工具...
  • qq_35635091
  • qq_35635091
  • 2017年08月04日 15:28
  • 337

Java Web学习(1):Web应用程序与Web服务器

一Web应用程序         (1)什么是Web应用程序         应用程序有两种模式C/S、B/S。C/S是客户端/服务器端程序,也就是说这类程序一般独立运行。而B/S就是浏览 器端...
  • erlian1992
  • erlian1992
  • 2016年07月09日 21:45
  • 4964

JAVA简易WEB服务器(一)

这一篇博客开始将和大家一起使用JAVA编写一个简易的Web服务器。 众所周知Web服务器与客户端之间的通信是使用HTTP协议的。HTTP是一个客户端和服务器端请求和应答的标准(TCP)。因为HTTP...
  • jianggujin
  • jianggujin
  • 2016年02月22日 16:25
  • 3770
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:java 的 web 服务器 jswdk 的配置文件 webserver.xml 的翻译文档
举报原因:
原因补充:

(最多只允许输入30个字)