1.系统配置文件config.xml
系统配置文件config.xml内存放着域内所有的配置信息,该文件的存放位置 为/WLS_HOME/user_projects/domains/base_domain/config/config.xml
(1)config.xml文件概述
weblogic的管理和配置服务基于sun公司的Java Management Extensions (JMX)api. 创建config.xml文件的目的是存储管理对象的变更信息,以便确保在weblogic重新启动时这些对象仍然可用.
通常应使用管理控制台来配置Weblogic Server的管理对象和服务以及允许weblogic server维持config.xml文件.每次通过管理控制台或其他工具修改config.xml文件,weblogic都会把它归档到一个旧文件中,你可以配置weblogic保存的归档文件个数.
虽然config.xml是一个良好的xml文档,你可以使用文本编辑器修改,但你应该把它看做是一个数据库,你只会在特殊情况下直接更新它. 该文件并不是一个正式的xml内容文档.它实际上是一个库,其中每个xml元素包含了一个weblogic server 管理对象在内存中实例的请求保存的数据.
(2)何时去编辑config.lxm
只有在很少的情况下您会选择直接修改文件而不是通过管理控制台.这些情况下您要保证所有的更改遵循最小化,明确化.你不能试图通过写一个新的config.xml文件来创建一个新的weblogic配置.
需要注意的是:
您不能在weblogic运行期间修改config.xml,因为weblogic会定期重写config.xml文件.您的更改将会丢失并且根据您平台的不同可能会导致weblogic服务的失败. 在任何情况下您应该先保存一份config.xml的副本,再去修改文件.
适合直接修改config.xml文件的情况可以有如下几种:.
a.如果您要部署多个weblogic server实例,您可以克隆一个config.xml文件并编辑新的服务器上的每个值.
b.如果您由一台服务器上定义一个对象,并希望将其复制到另一台服务器,您可以复制在config.xml文件中定义的xml元素到另一个config.xml文件中.
c.一些第三方应用程序可能需要您修改config.xml文件.
(3)config.xml文件里的内容
config.xml文件中包含了一系列的xml元素.其中域元素的顶层元素,域中的所有元素都是域元素的子集.域元素包括服务器,集群,应用等子元素,这些元素可能还有其自己的子元素.例如,服务器的子元素包括web服务器,ssl和日志等,应用程序的子元素包含EJB组件和web应用组件等.
每个元素都有一个或多个可配置的属性.一个属性有一个配置API中相应的属性.例如,服务器元素有一个ListenPort属性,同样,weblogic.management.configuration.ServerBean有一个ListenPort属性.可配置的属性是可读可写的.也就是getListenPort()和setListenPort()方法.
所有属性的值都必须加引号。Boolean属性的值只能是true或false。整数值不能包含逗号或小数点,但如果属性允许负值,可以有一个前置的减号。
2.属性文件weblogic.xml
WebLogic Server允许通过设置WebLogic应用程序扩展描述符(weblogic.xml)配置jsp容器,该文件通常位于web应用程序的web-inf目录下,可配置的元素包含在
<weblogic-web-app></weblogic-web-app>根目录下。
可配置的属性详解如下:(只列出部分属性)
description: Web应用程序的文字描述
weblogic-version: Web 应用程序即将部署至的 WebLogic Server 的版本。
security-role-assignment: 声明 Web 应用程序安全角色与 WebLogic Server中一个或多个委托人之间的映射,还可以使用它将给定角色标记为外部定义的角色。
run-as-role-assignment: run-as-role-assignment 元素将 web.xml 中的 run-as 角色名(servlet 元素的子元素)映射为系统中的有效用户名。
对于给定 servlet,该值将被 servlet-descriptor 中的 run-as-principal-name 元素替代。如果给定角色名中没有指定run-as-role-assignment,
则 Web 应用程序容器使用 security-role-assignment 中定义的第一个 principal-name。
reference-descriptorGroup :这个weblogic.xml 部署描述符指reference-descriptorGroup,它属于 weblogic-j2ee-xsd 文件的一部分。
session-descriptor: 定义 servlet 会话的参数。
jsp-descriptor: 指定 JSP 编译器的配置参数列表。
auth-filter: 指定身份验证筛选器 HttpServlet 类。
container-descriptor: 指定影响 Web 应用程序行为的参数列表。
charset-params: 用于定义非 unicode 操作的编码集行为。
virtual-directory-mapping: 使用virtual-directory-mapping 元素指定文档根,取代某些特定请求(例如图像请求)的 Web 应用程序的默认文档根。一组 Web 应用程序的所有图像
可以存储于一个位置上,不需要复制到使用这些图像的每个 Web 应用程序的文档根中。对于传入的请求,如果已经指定虚拟目录,则 servlet 容器将首先
在该虚拟目录中搜索所请求的资源,然后再在 Web 应用程序的原始文档根下搜索。这定义了两个位置上具有同一文档时的搜索优先级。
url-match-map: 使用该元素指定用于 URL 模式匹配的类。WebLogic Server 默认 URL 匹配映射类是基于 J2EE 标准的 weblogic.servlet.utils.URLMatchMap。
WebLogic Server 中包含的另外一个实现是 SimpleApacheURLMatchMap,可以通过使用 url-match-map 元素将该实现用作插件。
security-permission: 根据安全策略文件语法指定单个安全权限。
context-root: 定义该独立 Web 应用程序的上下文根。如果 Web 应用程序不是独立的,而属于某 EAR 的一部分,请在该 EAR 的 META-INF/application.xml 文件中指定上下文根。
application.xml 中的 context-root 设置优先于 weblogic.xml 中的 context-root 设置。
wl-dispatch-policy: 使用wl-dispatch-policy 元素,通过标识执行队列名称,从而将 Web 应用程序分配至已配置的执行队列。可以使用 per-servlet-dispatch-policy 元素在单
个 servlet 或 jsp 级别上替代该 Web 应用程序级别参数。
servlet-descriptor: 使用servlet-descriptor 元素聚合 servlet 特定的元素。
3.属性文件web.xml
web工程中,使用web.xml文件来配置欢迎页面、servlet、filter等web元素。web.xml的模式文件是由JavaEE对应的规范定义的,每个web.xml文件的根元素在<web-app>中都必须标明这个web.xml使用的是哪个模式文件。
而且web.xml的模式文件中定义的标签并不是死的,模式文件也是可以改变的,一般来说,随着web.xml模式文件的版本升级,里面的功能也会越来越复杂,也就是标签的种类会变多,我们只记住常用的就可以了
可配置的属性详解如下:
icon:可以给应用指定一大一小两个图标。
display-name:指定Web应用程序显示的名称。
description:提供有关Web应用程序的一些说明性文字。
content-param:声明一个Web应用程序的servlet上下文初始化参数。
filter:定义了一个过滤器(servletfilter)和它的初始化属性。
filter-mapping:指定过滤器生效的URL。
listener:定义一个应用程序的监听器。
servlet:声明一个HTTPServlet
servlet-mapping:指定Servlet所处理的URL。
session-config:指定Web应用和HTTPServlet相关的配置。
mime-mapping:定义文件扩展名和mime type之间的映射。
welcome-file-list:指定欢迎界面的列表,当客户的URL是一个目录名是,weblogic根据这个列表来返回一个缺省的界面。
error-page:错误页配置,当错误发生时服务器可以根据异常或者HTTP响应的状态码将对应的页面返回给客户端。
taglib:定义一个JSP标签库。
resource-ref:定义了一个到外部资源的引用,这使得Web应用代码里面可以使用一个“虚拟”的JNDI名字来引用一个外部资源,而具体的资源可以再weblogic.xml中指定。
security-constraint:定义Web资源集合的访问权限。
web-resource-collection:定义Web应用中安全约束的应用范围。
auth-constraint:定义哪些组或角色得此安全约束集合中定义的Web资源。
user-data-constraint:定义客户端如何与服务器通信。
logi-config:指定用户登录相关的选项,设置了该选项以后,当用户访问通过<sesurity-constraint>设置的受限资源时,必须通过用户认证,认证后,才可以访问被授权的访问资源。
from-login-config:FROM表单登录配置。
secutity-role:安全角色定义。
env-entry:环境参数设置。
ejbref:EJB映射的定义。
ejb-local-ref:定义一个对EJB Local Home接口的引用。