xwiki开发者指南-URL架构

这是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