Show last authors
1 1 URLs resolution
2
3 #startfloatingbox()
4 *Content*
5 #toc("" "" "")
6 #endfloatingbox()
7
8 In a single instance of XWiki you have many sections and the URLs need to reflect all that. This documentation details the way URLs are parsed by XWiki and what means each part of it.
9
10 {image:url.png}
11
12 1.1 Protocol
13 By default "http" is used when generating an url in XWiki.
14
15 You can set "secure" parameter to true in a wiki descriptor to generate urls with "https" in place of "http". See [How to edit wiki descriptor>manager:AdminGuide.EditWiki].
16
17 1.1 Host
18
19 In virtual mode it is used to determine the wiki to access. See [manager:AdminGuide.AccessWiki#HThedomainnamebasedwikiaccess] for more details.
20
21 In non-virtual mode is has non effect.
22 1.1 Application context (OPTIONAL)
23
24 See [platform:Main.ShortURLs#HApplicationname] for more details on how to remove this part of the url.
25
26 It's what the web container (jetty, tomcat, glassfish, etc.) use to find XWiki in all the web applications it contains. To remove it mainly depends on the possibilities and configuration of your web container.
27
28 1.1 Servlet mapping name (OPTIONAL)
29
30 See [platform:Main.ShortURLs#HServletmappingname] for more details on how to remove this part of the url.
31
32 This is used by the container to call the right servlet.
33
34 It can be:
35 * /bin/: this calls the Struts servlet which will calls the right action for the following part of the URL.
36 * /wiki/\[wikialias\]: call the same servlet but will be use to determine the subwiki to access if <tt>xwiki.virtiual.usepath</tt> is enabled in <tt>xwiki.cfg</tt>. Notes that you can change the "wiki" part with anything else using <tt>xwiki.virtual.usepath.servletpath</tt> and by modifying web.xml to reflect the new Struts action name.
37 ** XWiki tries to match a wiki descriptor with the provided <tt>wikialias</tt> like it was a domain name
38 ** then if it can't find any wiki descriptor it search for it with <tt>wikialias</tt> as the wiki name
39 * /xmlrpc/: call xmlrpc servlet. See [platform:Features.XMLRPC] for more details.
40 * /webdav/: call webdav servlet. See [dev:Drafts.WebDAV] for more details.
41
42
43
44
45 1.1 Struts action (OPTIONAL)
46
47 See [platform:Main.ShortURLs#HStrutsactionname] more more details on how to remove this part of the url.
48
49 When the servlet mapping name is <tt>bin</tt> or the value of <tt>xwiki.virtual.usepath.servletpath</tt>, XWiki use "action" identifiers to determine what is the goal of the user when going to a page.
50
51 For example if the action is "edit", XWiki will print an editor the user use to modify a page content but if the "view" action is used XWiki will execute the page content to print/render the content.
52
53 1.1 Space
54 Any wiki pages is located in what is called a "space". XWiki support only one level of space but you can indicate a "parent space" for a space.
55
56 See [platform:Features.Spaces] for more details about spaces.
57
58
59 1.1 Page
60 The page is what contains wiki contents and objects/classes and attachments.
61
62 1.1 Attachment
63 This part indicate the attachment you want to download from a particular page.
64
65 See [platform:Features.Attachments] for more details about attachments.
66 1.1 Query string
67 Actions can use URL parameters to modify there action depending of there value.
68
69 For example you can make a velocity script that print the content of this value with:
70 {code}
71 The value of the parameter is: $request.param1
72 {code}
73 if you have a parameter "param1=Hello World" the result will be
74 {code}
75 The value of the parameter is: Hello World
76 {code}
77
78 See [platform:DevGuide.Scripting] for more details about scripting.

Get Connected