xwiki开发者指南-URL架构

2021-01-14 11:52:13 浏览数 (1)

这是URL进入一个XWiki实例时,对它的处理:

具体:

  • 当解析一个传入的URL,Routing Filter使用一个默认资源类型解析器(ResourceTypeResolver)组件从URL(资源类型为URL指向类型例如一个实体,如果URL指向文档例如一个WebJar URL,一个皮肤URL,一个REST URL等)提取资源类型(ResourceType)。默认的资源类型解析器将读取XWiki的配置来查看配置了什么URL方案(通过url.format配置参数),然后通过找到ResourceTypeResolver组件的hint对应URL方案。它会用来提取资源类型。
  • Resource Reference Handler Servlet将使用一个默认资源引用解析器(ResourceReferenceResolver)组件来解析通过的URL为ResourceReference对象,然后可以交给ResourceReferenceHandler执行一个action。默认的资源引用解析器将读取XWiki的配置来查看配置了什么URL方案(通过url.format配置参数),然后通过找到ResourceReferenceResolver组件的hint对应URL方案。它会用来提取资源引用。

欲了解更多详细信息,请参阅Resource API和URL API参考文档。

标准URL Scheme

这是XWiki使用的默认URL格式。查看标准URL Scheme。

自定义URLs

有几种解决方案可以自定义XWiki URLs:

  • 你可以通过修改XWiki的配置文件在一定程度上调整。短网址文档描述了各种选项。
  • 你可以使用Rewrite Filter重写传入的URL和转换的URLs。短网址文档提供使用例子。
  • 你可以实现一个新的URL Scheme。请参阅URL API。
  • 你可以简单地注册新的资源类型或新的Entity Actions。请参阅Resource API。

请注意,使用Tuckey的Rewrite Filter非常强大,因为它允许用Java编写动态规则,通过使用<class-rule>。但是,动态outbound规则尚不可以使用。

这里是编写自定义class-rule的一个例子.

Struts Servlet 架构

如上图所示,当没有Resource Reference Handler注册的处理资源类型时,web.xml中其他部分将处理,如果该URL类型是bin或wiki,Struts Servlet被调用并执行以下操作:

例如,对于http://www.xwiki.org/xwiki/bin/view/Main/WebHome URL,会发生以下情况:

  • URL路径包含/view/,因此ViewAction.java类执行(在struts-config.xml中配置),调用Struts Action(在web.xml中配置)。
  • 在例子中wiki为main wiki(server名字起始与www)。查看访问wiki了解URL如何访问其中一个wiki。
  • ViewAction指定view.vm,使用Velocity呈现
  • 空间为Main,文档名字为WebHome

0 人点赞