-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathservletmode.html
314 lines (273 loc) · 11.2 KB
/
servletmode.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
<?xml version="1.0" encoding="UTF-8"?>
<html>
<head>
<title>BshServlet and Servlet Mode Scripting</title>
</head>
<body bgcolor="ffffff">
<table cellspacing="10">
<tr>
<td align="center"><a href="http://www.beanshell.org/"><img src="images/homebutton.png" /><br />Home</a>
</td>
<td><a href="remotemode.html#Remote_Server_Mode"><img src="images/backbutton.png" /><br />Back
</a></td>
<td align="center"><a href="contents.html"><img src="images/upbutton.png" /><br />Contents</a></td>
<td align="center"><a href="appletmode.html#The_BeanShell_Demo_Applet"><img
src="images/forwardbutton.png" /><br />Next
</a></td>
</tr>
</table>
<h1>BshServlet and Servlet Mode Scripting</h1>
BshServlet is a simple servlet that can be used to evaluate BeanShell
scripts inside of an application server or servlet container. BshServlet
accepts BeanShell scripts via the POST method, evaluates them capturing output
(optionally including standard out and standard error) and returns the results.
<p CLEAR="ALL" />
BshServlet has a simple form based interface for interactive experimentation
(analogous to the remote server mode). But more generally you can send
standalone BeanShell scripts from the command line to the BshServlet for
evaluation using the bsh.Remote launcher. bsh.Remote complements
bsh.Interpreter and bsh.Console as a launch point for BeanShell.
<p CLEAR="ALL" />
<p />
<center>
<table cellpadding="5" border="1" width="100%">
<tr>
<td><strong>Tip:</strong><br CLEAR="ALL" />
You may find BshServlet useful for writing unit tests that must run inside an
application server environment. In this mode BshServlet can be used
in the same way as or in combination with the Jakarta project's cactus.
</td>
</tr>
</table>
</center>
<p />
<h2><a name="Deploying_BshServlet">Deploying BshServlet</a></h2>
To test drive BshServlet you can grab one of the following sample application
WAR files here:
<ul>
<li><a href="http://www.beanshell.org/bshservlet.war">
http://www.beanshell.org/bshservlet.war</a></li>
<li>
<a href="http://www.beanshell.org/bshservlet-wbsh.war">
http://www.beanshell.org/bshservlet-wbsh.war</a>
<em>Rename this file to "bshservlet.war" for use.</em>
</li>
</ul>
<p />
<center>
<table cellpadding="5" border="1" width="100%">
<tr>
<td><strong>Tip:</strong><br CLEAR="ALL" />
A WAR file is a Web Application Archive. It is a JAR file containing HTML,
images, servlets, and configuration files comprising a complete web
application. Web applications can usually be deployed to a servlet container by
simply dropping the WAR file into a special directory.
</td>
</tr>
</table>
</center>
<p />
The first file, bshservlet.war, assumes that BeanShell has been installed in
your application server's classpath. It includes only the web.xml file
necessary to deploy an instance of the test servlet and an index.html README
file.
<p />
<center>
<table cellpadding="5" border="1" width="90%">
<tr>
<td bgcolor="#eeeebb"><strong>Note:</strong><br CLEAR="ALL" />
To install BeanShell in the Tomcat server classpath place the bsh.jar file in
common/lib. To use BeanShell in Weblogic you must upgrade its version of the
package. See <a href="weblogic.html">Upgrading BeanShell in Weblogic</a>
(http://www.beanshell.org/weblogic.html).
</td>
</tr>
</table>
</center>
<p />
The second WAR, bshservlet-wbsh.war, includes a copy of the BeanShell
application bsh.jar inside the WAR's lib directory. This WAR includes
everything you need to just drop the WAR into an application server.
<p />
<center>
<table cellpadding="5" border="1" width="90%">
<tr>
<td bgcolor="#eeeebb"><strong>Note:</strong><br CLEAR="ALL" />
Using bshservlet-wbsh.war will still *not* work in Weblogic 6.x unless
you upgrade Weblogic's internal version of BeanShell first.
See <a href="weblogic.html">Upgrading BeanShell in Weblogic</a>.
(http://www.beanshell.org/weblogic.html).
</td>
</tr>
</table>
</center>
<p />
To use the servlet for testing your own applications you will probably want to
deploy an instance of the test servlet in your WAR file. This will allow
the test servlet to to share a classloader with your webapp so that you can
test things like application classes and EJB local homes. Since the servlet
is included in the standard BeanShell distribution, all that is necessary to
do this is to include bsh.jar and add an entry to your wegapp's web.xml file.
Here is an example:
<p />
<center>
<table border="1" cellpadding="5" width="100%">
<tr>
<td bgcolor="#dfdfdc">
<pre>
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<servlet>
<servlet-name>bshservlet</servlet-name>
<servlet-class>bsh.servlet.BshServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>bshservlet</servlet-name>
<url-pattern>/eval</url-pattern>
</servlet-mapping>
</web-app>
</pre>
</td>
</tr>
</table>
</center>
<p />
The above example deploys an instance of BshServlet under the name "/eval".
The full path to the servlet will then depend on the name given to the
webapp WAR file. For example if the above appears in a WAR file named
"myapp.war" then the path would be:
<p />
<center>
<table border="1" cellpadding="5" width="100%">
<tr>
<td bgcolor="#dfdfdc">
<pre>
http://localhost/myapp/eval
</pre>
</td>
</tr>
</table>
</center>
<p />
<h2><a name="Running_Scripts">Running Scripts</a></h2>
After deploying the servlet, test it by fetching the default page with
your web browser.
<p />
<center>
<table border="1" cellpadding="5" width="100%">
<tr>
<td bgcolor="#dfdfdc">
<pre>
http://localhost/bshservlet/eval
</pre>
</td>
</tr>
</table>
</center>
<p />
You can use the servlet interactively through the form that it generates, or,
more importantly, through the command line launcher bsh.Remote.
bsh.Remote accepts a URL for a target bsh interpreter
and one or more file names to send to that server, printing the results.
<p />
<center>
<table border="1" cellpadding="5" width="100%">
<tr>
<td bgcolor="#dfdfdc">
<pre>
java bsh.Remote http://localhost/bshservlet/eval test1.bsh
</pre>
</td>
</tr>
</table>
</center>
<p />
You can execute remote scripts programmatically using the static method
bsh.Remote.eval().
<p CLEAR="ALL" />
If bsh.Remote can parse the retun value as an integer it will
return it as the exit status to the command line.
<p CLEAR="ALL" />
<h2><a name="The_Script_Environment">The Script Environment</a></h2>
Scripts have access to the servlet environment through two predefined variables:
<ul>
<li>bsh.httpServletRequest</li>
<li>bsh.httpServletResponse</li>
</ul>
which are the standard servlet request and response objects, respectively.
<p CLEAR="ALL" />
When set to "raw" output mode via the forms interface or servlet parameter
(described in the next section) the script is expected to generate the
complete response using the httpServletResponse object. This means that you
can have your script generate HTML or other output to be consumed by the client.
For example:
<p />
<center>
<table border="1" cellpadding="5" width="100%">
<tr>
<td bgcolor="#dfdfdc">
<pre>
// Server side script generates HTML response page
bsh.httpServletResponse.setContentType("text/html");
out = bsh.httpServletResponse.getWriter();
out.println("<html><body><h1>Hello World!</h1></body></html>");
</pre>
</td>
</tr>
</table>
</center>
<p />
More generally, you can use the httpServletRequest to get access to the
server environment such as the servlet session object. You can also access
all of the standard Java tools such as JNDI to fetch EJB homes, etc. and
perform testing or script activities.
<h2><a name="BshServlet_Parameters">BshServlet Parameters</a></h2>
The following parameters are recognized by BshServlet:
<table border="1" cellpadding="5">
<tr>
<td>Parameter</td>
<td>Value</td>
</tr>
<tr>
<td><strong>bsh.script</strong></td>
<td>The BeanShell Script</td>
</tr>
<tr>
<td><strong>bsh.servlet.captureOutErr</strong></td>
<td>"true" -
capture standard out and standard error during the evaluation of the
script. Note: this is inherently non-thread safe. All output from the
VM will be captured.
</td>
</tr>
<tr>
<td><strong>bsh.servlet.output</strong></td>
<td>"raw" - Do not generate
the servlet HTML result page. Instead rely on the script to generate the
complete result using the servlet response.
<tr>
<td><strong>bsh.client</strong></td>
<td>"remote" - set by the bsh.Remote
launcher to indicate that results should be raw and the return value should
be encoded for transport back to the client.</td>
</tr>
</td>
</tr>
</table>
<table cellspacing="10">
<tr>
<td align="center"><a href="http://www.beanshell.org/"><img src="images/homebutton.png" /><br />Home</a>
</td>
<td><a href="remotemode.html#Remote_Server_Mode"><img src="images/backbutton.png" /><br />Back
</a></td>
<td align="center"><a href="contents.html"><img src="images/upbutton.png" /><br />Contents</a></td>
<td align="center"><a href="appletmode.html#The_BeanShell_Demo_Applet"><img
src="images/forwardbutton.png" /><br />Next
</a></td>
</tr>
</table>
</body>
</html>