jetty.start.config中英文对照

声明：英语水平不好，错误或者不通顺地方请留言指出，或发邮件[email protected]

欢迎大家一起努力。

 

 

# This file controls what file are to be put on classpath or command line.

# //这个文件是控制那些文件被加载与命令行配置

# Format is as follows:

# //格式如下：

#

# Each line contains entry in the format:

# //每一行包含条目的格式

 

配置文件以行为单位，每一行的结构如下：

 

#  SUBJECT [ [!] CONDITION [AND|OR] ]*

# 

# where SUBJECT: 

#   ends with ".class" is the Main class to run.

# //如果以".class" 结尾，则它是一个Main类运行入口

#   ends with ".xml" is a configuration file for the command line

# //如果以".xml"结尾，则表示是一个配置文件，将会被包含到命令行

#   ends with "/" is a directory from which to add all jar and zip files. 

# //如果以"/"结尾，则表示是一个目录，且目录下面的所有jar和zip文件都会纳入到类路径中 

#   ends with "/*" is a directory from which to add all unconsidered jar and zip files.

# //如果以"/*"结尾，会将这一个目录下所有不管重要与否的jar和zip文件应用

#   ends with "/**" is a directory from which to recursively add all unconsidered jar and zip files.

# //如果以"/**"结尾，则表示subject是一个目录，该目录下的jar和zip文件会纳入到类路径。如果该目录下面还有子目录，那

# //么也将子目录下的jar/zip文件也纳入到类路径中（依次递归）

#   Containing = are used to assign system properties.

# //如果包含 = 号，则该语句是用于增加系统属性的（可以通过System.getProperty获取这里指定的属性） 

#   Containing ~= are used to assign start properties.

# //如果包含 ~= 号，则用于指定一个启动属性，即一个命令行属性。 

#   Containing /= are used to assign a canonical path.

# //如果包含 /= 号，则表示指定一个标准的路径。如果你使用相对路径，则会被转化为绝对路径

#   all other subjects are treated as files to be added to the classpath.

# //如果SUBJECT不符合以上的内容，则它将会作为一个文件加入到类路径中！

#

# ${name} is expanded to a start property

# //${name} 获取启动属性（在命令行中指定的属性） 

# $(name) is expanded to either a start property or a system property. 

# //获取系统属性 

# The start property ${version} is defined as the version of the start.jar

# //注：${version}是一个内置的属性，指Jetty的版本，该值在start.jar中的类中固化了。可以直接使用！

#

# Files starting with "/" are considered absolute, all others are relative to

# the home directory.

# //使用"/"开头的文件会被认为是绝对路径的，其它则当作主目录为Jetty的相对目录

#

# CONDITION is one of:

# //条件说明

#   always                 

#//表示true

#   never

#//检测后面的class是否存在

#   available classname        # true if class on classpath

# //如果classname指定的类可以在当前的类路径中找到,则返回true 

#   property name              # true if set as start property

# //property name 如果启动属性name被设置,则返回true 

#   system   name              # true if set as system property

# //system name 如果系统属性name被设置，则返回true 

#   exists file                # true if file/dir exists

# //如果file文件存在，则返回true 

#   java OPERATOR version      # java version compared to literal

# //java虚拟机版本

#   nargs OPERATOR number      # number of command line args compared to literal

# //nargs表示用于命令行

# //命令行参数的数目比较 

#   OPERATOR := one of "<",">","<=",">=","==","!="

# //运算符"<",">","<=",">=","==","!="之一

#

# CONTITIONS can be combined with AND OR or !, with AND being the assume

# operator for a list of CONDITIONS.

# //在使用时，可以将多个CONDITION使用 AND, OR 组合成一个CONDITION。

#

# Classpath operations are evaluated on the fly, so once a class or jar is

# added to the classpath, subsequent available conditions will see that class.

#//另外，上面提到的类路径操作都是立即执行——也就是说，如果在某一行中将A.class加入到类路径中，那该行以后其它命令

#//都可以在类路径中找到A.class，而不是非要等到配置文件处理完后才能找到A.class.(jar包添加立即执行)

# The configuration file may be divided into sections with option names like:

#//配置文件可以通过使用以下方式划分成不同的块。 

# [ssl,default]

#

# Clauses after a section header will only be included if they match one of the tags in the 

# options property.  By default options are set to "default,*" or the OPTIONS property may

# be used to pass in a list of tags, eg. :

#//在该块之后，新块之前的语句都将只对指定的选项OPTIONS生效。用户可以在命令行指定OPTIONS，如下： 

#//这里顺便说一下，OPTIONS就是一个启动属性！如果用户没有使用OPTIONS参数，那么该参数默认为"default,*"。如果

#//用户执行上面的命令，那么配置文件中[ssl,default]块下面的语句就会被执行，因为选项中ssl项

#    java -jar start.jar OPTIONS=jetty,jsp,ssl

#

# The tag '*' is always appended to the options, so any section with the * tag is always 

# applied.

#-----------------------------------------------------------------------------------------------------------------------------

 

# add a property defined classpath

#//添加一个属性定义类路径

${path}.path                                     property path

 

# add a property defined library directory

# //添加一个定义目录的属性

${lib}/**                                        exists ${lib}

#exists ${lib} 验证这个目录是否存在，存在返回true

 

# Try different settings of jetty.home until the start.jar is found.

jetty.home=.                                     ! exists $(jetty.home)/start.jar 

jetty.home=..                                    ! exists $(jetty.home)/start.jar 

jetty.home=jetty-distribution/src/main/resources     ! exists $(jetty.home)/start.jar 

jetty.home=../jetty-distribution/src/main/resources  ! exists $(jetty.home)/start.jar 

jetty.home=.                                     ! exists $(jetty.home)/start.jar

jetty.home/=$(jetty.home)                        exists $(jetty.home)/start.jar

 

# The main class to run

org.eclipse.jetty.xml.XmlConfiguration.class

${start.class}.class                             property start.class

 

# The default configuration files

$(jetty.home)/etc/jetty.xml                      nargs == 0

./jetty-server/src/main/config/etc/jetty.xml     nargs == 0 AND ! exists $(jetty.home)/etc/jetty.xml

 

# Default OPTIONS if not specified on the command line

OPTIONS~=default,*                               ! property OPTIONS

 

# Add a resources directory if it is there

[All,resources,default]

$(jetty.home)/resources/

 

# Add jetty modules

[*]

$(jetty.home)/lib/jetty-util-$(version).jar                                             ! available org.eclipse.jetty.util.StringUtil

$(jetty.home)/lib/jetty-io-$(version).jar                                               ! available org.eclipse.jetty.io.Buffer

 

[Server,All,xml,default]

$(jetty.home)/lib/jetty-xml-$(version).jar                                              ! available org.eclipse.jetty.xml.XmlParser

 

[Server,All,server,default]

$(jetty.home)/lib/servlet-api-2.5.jar                                                   ! available javax.servlet.ServletContext

$(jetty.home)/lib/jetty-http-$(version).jar                                             ! available org.eclipse.jetty.http.HttpParser

$(jetty.home)/lib/jetty-continuation-$(version).jar                                     ! available org.eclipse.jetty.continuation.Continuation

$(jetty.home)/lib/jetty-server-$(version).jar                                           ! available org.eclipse.jetty.server.Server

 

[Server,All,security,default]

$(jetty.home)/lib/jetty-security-$(version).jar                                         ! available org.eclipse.jetty.security.LoginService

 

[Server,All,servlet,default]

$(jetty.home)/lib/servlet-api-2.5.jar                                                   ! available javax.servlet.ServletContext

$(jetty.home)/lib/jetty-servlet-$(version).jar                                          ! available org.eclipse.jetty.servlet.ServletHandler

 

[Server,All,webapp,default]

$(jetty.home)/lib/jetty-webapp-$(version).jar                                           ! available org.eclipse.jetty.webapp.WebAppContext

 

[Server,All,deploy,default]

$(jetty.home)/lib/jetty-deploy-$(version).jar                                           ! available org.eclipse.jetty.deploy.ContextDeployer

 

[Server,All,servlets,default]

$(jetty.home)/lib/jetty-servlets-$(version).jar                                         ! available org.eclipse.jetty.servlets.WelcomeFilter

 

[All,rewrite]

$(jetty.home)/lib/jetty-rewrite-$(version).jar                                          ! available org.eclipse.jetty.rewrite.handler.RewriteHandler

 

[All,jmx]

$(jetty.home)/lib/jetty-jmx-$(version).jar                                              ! available org.eclipse.jetty.jmx.MBeanContainer

 

[All,ajp]

$(jetty.home)/lib/jetty-ajp-$(version).jar                                              ! available org.eclipse.jetty.ajp.Ajp13Connection      

 

[All,plus,jndi]

$(jetty.home)/lib/jetty-jndi-${version}.jar                                             ! available org.eclipse.jetty.jndi.ContextFactory

$(jetty.home)/lib/jetty-plus-${version}.jar                                             ! available org.eclipse.jetty.plus.jndi.NamingEntry

$(jetty.home)/lib/jndi/**                                                               exists $(jetty.home)/lib/jndi 

 

[All,annotations]

$(jetty.home)/lib/jetty-annotations-$(version).jar                                      ! available org.eclipse.jetty.annotations.AnnotationFinder

$(jetty.home)/lib/annotations/**                                                        exists $(jetty.home)/lib/jndi 

 

[All,setuid]

$(jetty.home)/lib/jetty-setuid-$(version).jar                                           ! available org.eclipse.jetty.setuid.SetUID

$(jetty.home)/lib/setuid/**                                                       

 

[All,policy]

$(jetty.home)/lib/jetty-policy-$(version).jar                                           ! available org.eclipse.jetty.policy.JettyPolicy

$(jetty.home)/lib/policy/jetty.policy                                                           

 

[All,Client,client]

$(jetty.home)/lib/jetty-http-$(version).jar                                             ! available org.eclipse.jetty.http.HttpParser

$(jetty.home)/lib/jetty-client-$(version).jar                                           ! available org.eclipse.jetty.client.HttpClient

 

[Client]

$(jetty.home)/lib/jetty-http-$(version).jar                                             ! available org.eclipse.jetty.http.HttpParser

 

[All,websocket]

$(jetty.home)/lib/jetty-websocket-$(version).jar                                        ! available org.eclipse.jetty.websocket.WebSocket

 

 

# Add ext if it exists

[Server,All,default,ext]        

$(jetty.home)/lib/ext/**

 

# Add all other sub-directories in /lib/ as options in a dynamic way

#//添加在lib/下面的所有文件,/**将递归所有文件夹

[All,=$(jetty.home)/lib/**]