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
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Turbine Documentation Team">
<meta name="email" value="a@a.com">
<meta name="author" value="Leon Messerschmidt">
<meta name="email" value="leon@opticode.co.za">
<title>Turbine - Turbine and Python</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
<a href="http://jakarta.apache.org/turbine/"><img src="./images/logo.gif" alt="Turbine" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Essentials</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./features.html">Features</a>
</li>
<li> <a href="./fsd.html">Specification</a>
</li>
<li> <a href="./project-map.html">Project map</a>
</li>
<li> <a href="./install.html">Installation</a>
</li>
<li> <a href="./getting-started.html">Getting Started</a>
</li>
<li> <a href="./changes.html">Changes</a>
</li>
<li> <a href="./other-docs.html">Other Documentation</a>
</li>
</ul>
<p><strong>Models</strong></p>
<ul>
<li> <a href="./pullmodel.html">Pull MVC Model</a>
</li>
<li> <a href="./model2+1.html">Model 2+1</a>
</li>
<li> <a href="./j2ee-integration.html">J2EE Integration</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="./turbine-documentation-project.html">Turbine Documentation</a>
</li>
<li> <a href="./code-standards.html">Coding Spec</a>
</li>
<li> <a href="./contributors.html">Contributors</a>
</li>
<li> <a href="./branches.html">CVS Branches</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repos</a>
</li>
<li> <a href="./faq.html">FAQ</a>
</li>
<li> <a href="./license.html">License</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="./powered.html">Powered by Turbine</a>
</li>
<li> <a href="./todo.html">Todo</a>
</li>
<li> <a href="./active-developers.html">Active Developers</a>
</li>
<li> <a href="./proposals.html">Proposals</a>
</li>
</ul>
<p><strong>Documentation</strong></p>
<ul>
<li> <a href="./action-event.html">Action Events</a>
</li>
<li> <a href="./services.html">Services</a>
</li>
<li> <a href="./security.html">Turbine and Security</a>
</li>
<li> <a href="./python.html">Turbine and Python</a>
</li>
<li> <a href="./jsp-configuration.html">Turbine and JSP</a>
</li>
<li> <a href="./velocity-site.html">Velocity Site</a>
</li>
<li> <a href="./context-howto.html">Velocity Context</a>
</li>
<li> <a href="./webmacro-site.html">Webmacro Site</a>
</li>
</ul>
<p><strong>Database</strong></p>
<ul>
<li> <a href="./peers.html">Peers</a>
</li>
<li> <a href="./advpeers.html">Advanced Peers</a>
</li>
<li> <a href="./advcriteria.html">Advanced Criteria</a>
</li>
<li> <a href="./torque.html">Torque</a>
</li>
<li> <a href="./turbine-schema.html">Core Schema</a>
</li>
<li> <a href="./db-adapters.html">DB Adapters</a>
</li>
<li> <a href="./postgres-howto.html">Postgres Howto</a>
</li>
<li> <a href="./oracle-howto.html">Oracle 8i Howto</a>
</li>
<li> <a href="./sybase-howto.html">Sybase Howto</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Turbine Python Support"><strong>Turbine Python Support</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
Turbine has support for creating assemblers (see the <a href="fsd.html">
specifications</a>) with Python, by making use of
<a href="http://www.jpython.org">JPython technology</a>.
</p>
<p>
The first question that comes to mind is why one would want do to something
like this. Here are some of the reasons you might want to do this:
</p>
<ul>
<li>
Python is an interpreted language which means that you do not have
to recompile and copy a new jar each time you make changes.
</li>
<li>
Although Python is interpreted it is compiled to java bytecode.
Performance is on par with native java code.
</li>
<li>
Python is very easy to learn. This, together with the fact that
you don't need to use a compiler, makes it possible for people with
little java experience to create screens.
</li>
<li>
You can rapidly build a prototype using python, and later on find
that it is not necessary to systematically move to java :-)
</li>
</ul>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Setting Up Python for Turbine"><strong>Setting Up Python for Turbine</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
The first thing is to download JPython from www.jpython.org and copy
the jpython.jar file into your turibe/lib directory. Now you need to
prepare and compile the jpython files like this:
<source>
build-turbine prepare-python
build-turbine jar
</source>
This will create a new turbine library that contains the Python code.
You need to copy this new .jar file to your application's lib
directory.
</p>
<p>
Now we need to edit the TurbineResources.properties. Add the following
keys to your application's properties:
<source>
services.AssemblerBrokerService.assembler.screen=
org.apache.turbine.util.assemblerbroker.python.PythonScreenFactory
services.AssemblerBrokerService.assembler.action=
org.apache.turbine.util.assemblerbroker.python.PythonActionFactory
services.AssemblerBrokerService.python.path=/path/to/python
</source>
The first two registers the Python Assembler Factories with the
AssemblerBrokerService. The last line tells the Python interpreter
where to find all the .py files for your application.
</p>
<p>
In the root of your services.AssemblerBrokerService.python.path
you need to add a file named config.py that looks like this:
<source>
import java
from java.io import *
from java.util import *
sys.add_package("org.apache.turbine.modules.screens")
sys.add_package("org.apache.turbine.modules")
sys.add_package("org.apache.turbine.util.db")
sys.add_package("org.apache.turbine.util")
sys.add_package("org.apache.turbine.services.security.TurbineSecurity")
sys.add_package("org.webmacro.servlet")
from org.apache.turbine.modules.screens import WebMacroSiteScreen
from org.apache.turbine.modules import Action
from org.apache.turbine.util.db import Criteria
from org.apache.turbine.util import RunData
from org.webmacro.servlet import WebContext
from org.apache.turbine.services.security import TurbineSecurity
</source>
JPython sometimes gets a bit confused with the Servlet Engine
classloader, which forces us to call sys.add_package for each java
package that we wish to use in our Python code. You also need to
import all the classes that you wish to use explicitly. You needn't
add the classes here, but it avoid some duplicate declarations at the
top of each screen/action.
</p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<a name="Using Python with Turbine"><strong>Using Python with Turbine</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
To create python screens we use exactly the same methodology than for
normal java screens. First you need a /screens subdirectory in your
services.AssemblerBrokerService.python.path. This is where your
screen code will live. Layouts goes in /layouts, actions in /actions
and so forth (just remember to register the appropriate assembler
factories).
</p>
<p>
I'm going to create a sample WebMacro screen. First we need a .py file
where this screen can live. The .py file should have the same name as
your .wm file and it must be all lower case. Inside this file we
create a new class with the same name as the file, but in this the
first letter is uppercase (the rest is always lower case). To override
a method is fairly simple (just create a new method with the same
name).
</p>
<p>
There is one problem however - Python does not support method
overloading based on type signatures, so usually the simplest for is
used, which is doBuildTemplate( RunData data ) for WebMacroSiteScreen
in stead of doBuildTemplate( RunData data, WebContext context ). You
have two options to overcome this problem. (1) Create a new superclass
that exposes a method under a different name or (2) just call
getContext in your python code. I usually just go for the second
option because it is fairly straight forward anyway.
</p>
<p>
Now for the code. Let's create a screen called Test. First create a
test.wm file (I assumer everybody knows how to do this). Now create a
test.py and place it in the python-path/screens directory. It should
look something like this:
<source>
class Subjectslist(WebMacroSiteScreen):
def doBuildTemplate (self,data):
context = self.getContext(data)
context.put ("me","Leon")
context.put ("text","Python is cool");
</source>
For more information about the self parameter see the Python docs. You
can call any java code that you would normally be able to use (just
remember to add it to conf.py) including database, services, etc. You
can also freely use any of the Python built-in types and any Python
module that was built on 100% pure Python.
</p>
</blockquote>
</td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright © 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
|
