译：如何配置Red5应用程序

HOWTO-NewApplications-WAR_zh_CN.txt

--------------------------------------- 如何配置Red5应用程序 WAR附录 ---------------------------------------

译者的话： Red5的资料有点乱，没有什么头绪。但是把这些资料翻译成中文多少会有一些帮助，即使有时翻译的内容也不是那会容易看懂。如果大家有时间，也希望能够选择一些资料翻译出来，然后发布到OpenRed5中文社区http://www.OpenRed5.com，让我们大家共同进步。

序言 ========================== 这个文档描述了Red5应用在使用WAR实现时如何配置。在此版本的Red5，J2EE容器没有包含在Red5中，因此它的配置会有所不同。此文档假定应用程序WAR包已经展开。(译注：这里的J2EE容器是指提供J2EE运行环境的软件，如Tomcat，JBoss)

应用程序目录 ========================== 一个应用程序WAR包已经用WAR包的名称正常的展开到一个目录下。 例：red5.war展开到Tomcat服务器的tomcat/webapps/red5目录下。在一个标准的Red5安装中，所有的应用都被存储在webapps目录下它们自己的目录中。

配置 ========================== 此WAR版本保存所有的应用程序定义到以"-context.xml"为后缀的Spring配置文件中。如果你的应用名为ofla，那么它的配置文件就是"ofla-context.xml"。此上下文文件会在服务启动时自动加载。(译注：上下文亦可称作环境)

将被加载的主配置文件为"web.xml"。它包含下列参数：

globalScope -------------------------- 全局作用域，它可以使用默认的设置

    <context-param>         <param-name>globalScope</param-name>         <param-value>default</param-value>     </context-param>

contextConfigLocation -------------------------- 为此应用指定handler配置文件名。handler配置文件关联到类，用于告知应用程序关于连接/断开客户端，提供方法供客户端调用。 handler配置文件为这些类指定作用域层次。 路径名可以使用通配符来加载多个文件。

        <context-param>                 <param-name>contextConfigLocation</param-name>                 <param-value>/WEB-INF/applicationContext.xml, /WEB-INF/red5-common.xml, /WEB-INF/red5-core.xml, /WEB-INF/*-context.xml</param-value>         </context-param>

listener (start-up / shutdown) -------------------------- 参考此应用程序上下文监听器servlet，此技术获取Standalone.class的位置。(译注：这里原文亦不很明确，有一点难以理解了)

        <listener>                 <!-- 模拟 org.springframework.web.context.ContextLoaderListener -->                 <listener-class>org.red5.server.MainServlet</listener-class>         </listener>

parentContextKey -------------------------- 上级上下文的名称，通常为"default.context"

    <context-param>         <param-name>parentContextKey</param-name>         <param-value>default.context</param-value>     </context-param>

log4jConfigLocation -------------------------- 日志子系统的配置文件路径

    <context-param>         <param-name>log4jConfigLocation</param-name>         <param-value>/WEB-INF/log4j.properties</param-value>     </context-param>

Handler配置 ========================== 每个handler配置文件必需包含最少三个类

上下文 -------------------------- 默认上下文类使用保留名'web.context'，通常用于映射路径到作用域，参考service和handler。默认的类为'org.red5.server.Context'

默认的设置为；

    <bean id="web.context" class="org.red5.server.Context" autowire="byType" />

每个应用程序仅能拥有一个上下文，而且必需遵循此命名规范'<application name>.context'，这样就不会引起冲突。应用程序上下文可以在所有的作用域内共享。(译注：这里的Application Scope与WEB应用中的Application Scope是同样的意思)

作用域 -------------------------- 每个应用都需要最少一个作用域，将handler链接到上下文和服务器中。作用域可以用于构建一个树，客户端可以在这个作用域范围内连接到每一个节点和共享对象(如作用域内的共享对象或实时流)。

默认的作用域名通常为'web.scope'，而且必需遵循此命名规范'<application name>.scope'，这样就不会引起冲突。

这个类有以下属性：

  'server'     参考全局服务`red5.server`。   'parent'     参考上级作用域，通常为`global.scope`。   'context'     此作用域的服务上下文，使用刚才提到的`web.context`。   'handler'     此作用域的handler。   'contextPath'     连接到此作用域的路径。   'virtualHosts'     此作用域运行所在的主机名或IP地址列表(主机名或IP地址之间用逗号分隔)。此版本我们没有控制主机，它由服务器完成(处理)。

这是一个定义的例子：

    <bean id="ofla.scope" class="org.red5.server.WebScope" init-method="register">         <property name="server" ref="red5.server" />         <property name="parent" ref="global.scope" />         <property name="context" ref="ofla.context" />         <property name="handler" ref="ofla.handler" />         <property name="contextPath" value="/oflaDemo" />         <property name="virtualHosts" value="localhost, 127.0.0.1" />     </bean>

配置中指定'contextPath'可以看作是作用域的root路径。当需要连接到动态生成的扩展作用域时，你可以在配置路径后添加额外的元素。

这些扩展作用域都使用同样的handler，但是拥有它们自己的属性、共享对象和实时流。

Handlers -------------------------- 每一个上下文都需要一个handler，当一个客户端连接到作用域时实现被调用的方法，包含可以被客户端调用的额外的方法。这些handler需要实现指定的接口'org.red5.server.api.IScopeHandler'，当然，你也可以实现其它接口来控制和访问共享对象或者流。

一个实现的例子：可以使用一个基础类'org.red5.server.adapter.ApplicationAdapter'。详细内容请查阅API文档。

作用域handler类设置为：

    <bean id="ofla.handler" class="the.path.to.my.Application" singleton="true" />

`id`属性参考作用域定义

如果你无需特定的服务端逻辑，你可以使用Red5提供的默认应用程序handler

    <bean id="web.handler" class="org.red5.server.adapter.ApplicationAdapter" singleton="true" />