Skip to Content
Last modified by Klaus Berkling on 2012/06/20 12:13
From version 20.1
edited by kiberkli
on 2011/10/11 20:46
Change comment: Added "Add ERPrototypes if your EO model uses/will use prototypes"
To version 25.1
edited by Klaus Berkling
on 2023/11/13 11:58
Change comment: Renamed from xwiki:documentation.Integrate Wonder Into an Existing Application

Summary

Details

Page properties
Parent
... ... @@ -1,0 +1,1 @@
1 +How-tos
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.kiberkli
1 +XWiki.kberkling@dyned_com
Content
... ... @@ -1,7 +1,7 @@
1 1  == Introduction ==
2 2  
3 3  So you have decided to take the plunge and take advantage of the many useful features of Project Wonder. The most common usage of Project Wonder is to simply integrate the Wonder foundation frameworks of ERJars, ERExtensions and JavaWOExtensions into your project. Doing this fixes many problems with the standard WebObjects frameworks and provides easy access to many configurable features that most typical WebObjects applications need.
4 -In this short article, we itemize the absolute minimum to add Wonder to your project and avoid initial integration stumbles.
4 + In this short article, we itemize the absolute minimum to add Wonder to your project and avoid initial integration stumbles.
5 5  
6 6  == Minimum Wonder Integration ==
7 7  
... ... @@ -12,15 +12,10 @@
12 12  * Make it so your Session class subclasses ERXSession
13 13  * Make it so your DirectAction classes extend ERXDirectAction
14 14  * Make it so your Enterprise Objects extend ERXGenericRecord instead of EOGenericRecord. If you use EOGenerator, simply change your superclass template class declaration and import statements.
15 -* Your Application class' main static method **{+}must{+}** call ERXApplication.main(...) instead of WOApplication.main(...). Your application will fail to initialize and launch otherwise.
15 +* Your Application class' main static method (% style="text-decoration: underline;" %)**must**(%%) call ERXApplication.main(...) instead of WOApplication.main(...). Your application will fail to initialize and launch otherwise.
16 16  * Use ERXEC.newEditingContext() to create new editing contexts in your application
17 -* Add minimal content to Properties file. To get minimal content, create a temporary empty project using the WOnderApplication WOLips project template and copy/paste the contents from that template's Properties file.
17 +* Add minimal content to Properties file. To get minimal content, create a temporary empty project using the WOnderApplication WOLips project template and copy/paste the contents from that template's Properties file.
18 18  
19 -{{warning title="Remember"}}
20 -All of these steps are important. Failing to integrate properly may lead to errors during runtime or your application will fail to launch successfully
21 -
22 -{{/warning}}
23 -
24 24  {{code title="Application main method"}}
25 25  
26 26  public static void main(String argv[]) {
... ... @@ -34,17 +34,11 @@
34 34  If you got the minimum Wonder integration done and your app is working, then adding these extra fundamental useful frameworks are definitely worthwhile from the start:
35 35  
36 36  * Ajax - Just what it says - easy Ajax in your WO apps
37 -* ERPrototypes - save yourself lots of manhours fiddling with EOModel attributes by using convenient prototypes. This is considered best practice.
32 +* ERPrototypes - save yourself lots of manhours fiddling with EOModel attributes by using convenient prototypes. This is considered best practice. (Don't forget to select a prototype in your database config in Entity Modeler, otherwise the prototype won't show up when adding/editing an attribute.)
38 38  * ERJavaMail - send all kinds of emails - plain text, html, multi-part, attachments, etc. HTML can be generated from a WOComponent or be set using a HTML String.
39 -* ERSelenium - functional testing that simulates user interaction with your app's web pages.
34 +* ERSelenium - functional testing that simulates user interaction with your app's web pages.
40 40  
41 -{{tip value=" Link To Wonder Source in your Workspace"}}
42 -Wonder source is in itself a very useful reference and gives insight into the inner workings of the WebObjects frameworks, so having the source directly linked to your project in your workspace has many advantages. See other tutorials on this wiki that show how to set that up.
43 -
44 -{{/tip}}
45 -
46 -{{info value="Start Your Next Project on the Right Foot"}}
36 +{{info 0="Start Your Next Project on the Right Foot"}}
47 47  For your next project, simply select the WOnderApplication project template instead of the WOApplication template and all the minimum integration tasks itemized above are already done for you. Besides, the WOnder Application project template is so neatly organized that some have commented on how it is a better overall project template for WebObjects projects even if you are not using Wonder.
48 -\\ !Picture 9.jpg!
49 -
38 +[[image:attach:Picture 9.jpg]]
50 50  {{/info}}
Picture 9.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +26.6 KB
Content