source: main/trunk/greenstone3/resources/web/servlets.xml.svn@ 38839

Last change on this file since 38839 was 38839, checked in by kjdon, 7 weeks ago

moved oaiservlet specification out of web.xml and into servlets.xml
File size: 11.3 KB
Line 
1<servlet>
2 <!-- !!!! -->
3 <!-- This file was automatically generated from $GSDL3SRCHOME/resources/web/servlet.xml.in -->
4 <!-- !!!! -->
5
6 <servlet-name>library</servlet-name>
7 <description>The standard gsdl3 library program</description>
8 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
9 <!-- this is the servlet url path - needs to match what you have specified in servlet-mapping below -->
10 <init-param>
11 <param-name>library_name</param-name>
12 <param-value>library</param-value>
13 </init-param>
14
15 <!--
16 Production versions of Greenstone will typically need to set 'init-param' valus below if
17 the DL operates through a Reverse Proxy server, such as Apache2, which publically presents
18 externally over 'https' but internally routes things through to an http running instance
19 of tomcat providing Greenstone3.
20
21 For example, to have a Greenstone3 appear as:
22 https://mydomain.org/my-greenstone3/library
23
24 In your Apache2 configuration file include:
25
26 ProxyPass /my-greenstone3 http://localhost:8383/greenstone3
27 ProxyPassReverse /my-greenstone3 http://localhost:8383/greenstone3
28 <Location /my-greenstone3>
29 ProxyPassReverseCookiePath /greenstone3 /my-greenstone3
30 </Location>
31
32 The <Location> tags future proof things for the case where you run more than one
33 Greenstone3 on the same server. This can just be the ProxyPassReverseCookiePath
34 entry, if there is only one GS3 server running.
35
36 In the params below we break things down into constituent parts to make some of the
37 XSL template rules easier to write.
38 -->
39
40 <!--
41 Leave the following commented out if you are using http://localhost:8383/greenstone3/
42 as this is construted automatically from build.properties for use as the HTML <base> tag
43 -->
44 <!-- **** TODO: consider changing this to be built up from servlet_domain, servlet_opt_port, servlet_context / -->
45 <!--
46 <init-param>
47 <param-name>servlet_url_prefix</param-name>
48 <param-value>//mydomain.org//my-greenstone3/</param-value>
49 </init-param>
50 -->
51
52 <init-param>
53 <param-name>site_name</param-name>
54 <param-value>localsite</param-value>
55 </init-param>
56 <init-param>
57 <param-name>interface_name</param-name>
58 <param-value>default</param-value>
59 </init-param>
60 <init-param>
61 <param-name>receptionist_class</param-name>
62 <param-value>DefaultReceptionist</param-value>
63 </init-param>
64 <init-param>
65 <param-name>default_lang</param-name>
66 <param-value>en</param-value>
67 </init-param>
68 <init-param>
69 <!-- Does this servlet provide a favourites option? true/false-->
70 <param-name>favouritebasket</param-name>
71 <param-value>true</param-value>
72 </init-param>
73 <init-param>
74 <!-- Does this servlet provide a documentbasket option? true/false.
75Note, this currently doesn't work properly -->
76 <param-name>documentbasket</param-name>
77 <param-value>false</param-value>
78 </init-param>
79
80 <!--
81 The cookie consent manager is a component of the default interface that alerts the end user
82 to Greenstone's cookie usage. It also allows them to consent to non-essential cookies.
83 It can be customised by editing the 'cookieconsent-init.js' file in the default interface's 'js' folder.
84 To disable the manager for all interfaces that support it, remove or comment out this entire parameter.
85 -->
86 <init-param>
87 <param-name>cookie_consent</param-name>
88 <param-value>comment_this_entire_param_to_disable</param-value>
89 </init-param>
90 <!-- if you want to use a non standard greenstone cookie path (by default it will use greenstone.context in build.properties), then set the value of it here. If you are mapping to an address without this part (eg my-site.org/library) then cookie path will be / -->
91 <!--
92 <init-param>
93 <param-name>cookie_path</param-name>
94 <param-value>/greenstone3</param-value>
95 </init-param>
96 -->
97
98 <!-- ***** -->
99 <!-- Google related keys and id credentials -->
100 <!-- ***** -->
101
102 <!--
103 <init-param>
104 <param-name>google_tracking_id</param-name>
105 <param-value>UA-?????.....?????</param-value>
106 </init-param>
107 -->
108
109 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
110 <!-- More details at: https://developers.google.com/identity/sign-in/web/sign-in -->
111 <!--
112 <init-param>
113 <param-name>googlesignin_client_id</param-name>
114 <param-value>@googlesigninclientid@</param-value>
115 </init-param>
116 -->
117
118 <!-- For details on how to set up a Google API key to use with Google Maps, see:
119 https://developers.google.com/maps/documentation/javascript/get-api-key
120 -->
121 <!-- TLDR:
122 1. On the Credentials page, create an API key (copy the displayed value)
123 2. Then restrict it to your website
124 3. Further restrict calls to just Google Maps API
125 4. Give the key a name you will remember
126 5. Press Save
127 6. Paste the key into the <param-value> below
128 -->
129 <!--
130 <init-param>
131 <param-name>googlemaps_api_key</param-name>
132 <param-value>?????.....?????</param-value>
133 </init-param>
134 -->
135</servlet>
136
137<!-- the /* in the url-pattern below is necessary for the restful URLs to work.
138 e.g. greenstone3/library/collection/lucene-jdbm-demo/page/about
139-->
140<servlet-mapping>
141 <servlet-name>library</servlet-name>
142 <url-pattern>/library/*</url-pattern>
143</servlet-mapping>
144
145<!-- the oai servlet. You can add multiple oai servlets by copying
146 the description and changing site_name and servlet_url params.
147 Remember to add the mapping here and the corresponding servlet_url
148 into build.properties -->
149<servlet>
150 <servlet-name>oaiserver</servlet-name>
151 <description>the default oai servlet</description>
152 <servlet-class>org.greenstone.gsdl3.OAIServer</servlet-class>
153 <init-param>
154 <param-name>default_lang</param-name>
155 <param-value>en</param-value>
156 </init-param>
157 <init-param>
158 <param-name>site_name</param-name>
159 <param-value>localsite</param-value>
160 </init-param>
161 <!-- this needs to correspond to the value in the url-pattern
162 part of the mapping, below.-->
163 <init-param>
164 <param-name>servlet_url</param-name>
165 <param-value>oaiserver</param-value>
166 </init-param>
167</servlet>
168
169<servlet-mapping>
170 <servlet-name>oaiserver</servlet-name>
171 <url-pattern>/oaiserver/*</url-pattern>
172</servlet-mapping>
173
174<servlet>
175 <servlet-name>halftone-library</servlet-name>
176 <description>A library servlet using the standard content, but with the halftone interface.</description>
177 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
178 <init-param>
179 <param-name>library_name</param-name>
180 <param-value>halftone-library</param-value>
181 </init-param>
182 <init-param>
183 <param-name>site_name</param-name>
184 <param-value>localsite</param-value>
185 </init-param>
186 <init-param>
187 <param-name>interface_name</param-name>
188 <param-value>halftone</param-value>
189 </init-param>
190 <init-param>
191 <param-name>receptionist_class</param-name>
192 <param-value>DefaultReceptionist</param-value>
193 </init-param>
194 <init-param>
195 <param-name>default_lang</param-name>
196 <param-value>en</param-value>
197 </init-param>
198
199 <!-- For Google Analytics -->
200 <!--
201 <init-param>
202 <param-name>google_tracking_id</param-name>
203 <param-value>UA-?????.....?????</param-value>
204 </init-param>
205 -->
206
207 <!-- For Google Authenticated Signin, need to specify the client-id (*not* the secret one) -->
208 <!--
209 <init-param>
210 <param-name>googlesignin_client_id</param-name>
211 <param-value>?????.....?????.apps.googleusercontent.com</param-value>
212 </init-param>
213 -->
214</servlet>
215
216<servlet-mapping>
217 <servlet-name>halftone-library</servlet-name>
218 <url-pattern>/halftone-library/*</url-pattern>
219</servlet-mapping>
220
221<!--<servlet>
222 <servlet-name>gs2-library</servlet-name>
223 <description>Greenstone 2 lookalike library program: uses localsite with the gs2 interface</description>
224 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
225 <init-param>
226 <param-name>library_name</param-name>
227 <param-value>gs2-library</param-value>
228 </init-param>
229 <init-param>
230 <param-name>site_name</param-name>
231 <param-value>localsite</param-value>
232 </init-param>
233 <init-param>
234 <param-name>interface_name</param-name>
235 <param-value>gs2</param-value>
236 </init-param>
237 <init-param>
238 <param-name>default_lang</param-name>
239 <param-value>en</param-value>
240 </init-param>
241 <init-param>
242 <param-name>session_expiration</param-name>
243 <param-value>1800</param-value>
244 </init-param>
245 <init-param>
246 <param-name>params_class</param-name>
247 <param-value>GS2Params</param-value>
248 </init-param>
249</servlet>
250
251<servlet-mapping>
252 <servlet-name>gs2-library</servlet-name>
253 <url-pattern>/gs2-library/*</url-pattern>
254</servlet-mapping>
255-->
256
257<!--<servlet>
258 <servlet-name>nzdl-library</servlet-name>
259 <description>gsdl3 library program</description>
260 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
261 <init-param>
262 <param-name>library_name</param-name>
263 <param-value>nzdl</param-value>
264 </init-param>
265 <init-param>
266 <param-name>site_name</param-name>
267 <param-value>nzdl</param-value>
268 </init-param>
269 <init-param>
270 <param-name>interface_name</param-name>
271 <param-value>nzdl</param-value>
272 </init-param>
273 <init-param>
274 <param-name>default_lang</param-name>
275 <param-value>en</param-value>
276 </init-param>
277 <init-param>
278 <param-name>params_class</param-name>
279 <param-value>NZDLParams</param-value>
280 </init-param>
281 <init-param>
282 <param-name>session_expiration</param-name>
283 <param-value>600</param-value>
284 </init-param>
285</servlet>
286
287<servlet-mapping>
288 <servlet-name>nzdl-library</servlet-name>
289 <url-pattern>/nzdl/*</url-pattern>
290</servlet-mapping>
291
292-->
293
294<!--<servlet>
295 <servlet-name>gateway</servlet-name>
296 <description>gsdl3 library based on gateway site and basic interface. It uses SOAP to talk to localsite</description>
297 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
298 <init-param>
299 <param-name>library_name</param-name>
300 <param-value>gateway</param-value>
301 </init-param>
302 <init-param>
303 <param-name>site_name</param-name>
304 <param-value>gateway</param-value>
305 </init-param>
306 <init-param>
307 <param-name>interface_name</param-name>
308 <param-value>basic</param-value>
309 </init-param>
310 <init-param>
311 <param-name>default_lang</param-name>
312 <param-value>en</param-value>
313 </init-param>
314</servlet>
315
316<servlet-mapping>
317 <servlet-name>gateway</servlet-name>
318 <url-pattern>/gateway/*</url-pattern>
319</servlet-mapping>
320-->
321
322<!--<servlet>
323 <servlet-name>basic-library</servlet-name>
324 <description>basic gsdl3 library program: uses localsite and the basic interface</description>
325 <servlet-class>org.greenstone.gsdl3.LibraryServlet</servlet-class>
326 <init-param>
327 <param-name>library_name</param-name>
328 <param-value>basic-library</param-value>
329 </init-param>
330 <init-param>
331 <param-name>site_name</param-name>
332 <param-value>localsite</param-value>
333 </init-param>
334 <init-param>
335 <param-name>interface_name</param-name>
336 <param-value>basic</param-value>
337 </init-param>
338 <init-param>
339 <param-name>default_lang</param-name>
340 <param-value>en</param-value>
341 </init-param>
342 <init-param>
343 <param-name>allow_client_side_xslt</param-name>
344 <param-value>true</param-value>
345 </init-param>
346</servlet>
347
348<servlet-mapping>
349 <servlet-name>basic-library</servlet-name>
350 <url-pattern>/basic-library/*</url-pattern>
351</servlet-mapping>
352-->
Note: See TracBrowser for help on using the repository browser.