Wonder for CAWUG

Prev Home Next

introduction to
Project WONDER

Jonathan "Wolf" Rentzsch
Red Shed Software
jon at redshed dot net

Prev Home Next

What is Project WONDER?

World's largest Open Source WebObjects project
- Bigger than WebObjects itself!
Hosted at SourceForge:
- http://wonder.sourceforge.net
- available under a BSD-style license
Umbrella project for:
- Reusable Components
- Powerful Frameworks
- Handy Utilities
- Useful Sample Applications
“WONDER” is actually an acronym:
- WebObjects
- Nodes for
- Distributing
- E-Resources

Prev Home Next

Brief History of WONDER

A dotcom is born: eResource
Its focus: commercial real estate on the web
- Big user & advocate of DirectToWeb — more on that later
Later on eResource was renamed NetStruxr
- But name lives on...
- Classes were already prefixed with ER
- Switching to NS would cause namespace conflicts
- Even today, WONDER's classes begin with ER
Folks from NetStruxr, now working on WONDER:
- Patrice Gautier — one of DirectToWeb's original authors!
- Max Muller
- Travis Cripps
- Jim Roepcke

Prev Home Next

Brief History of WONDER

NetStruxr open-sourced a great deal of its code
Lots of innovative, high-quality code
But there were a couple of issues:
- No efficient method to contribute back to NetStruxr
  - No CVS repository, no mailing lists, etc.
- Was coded in Java for WebObjects 4.5
  - Needed some rewriting for version 5
Unfortunately, NetStruxr closed for business
Fortunately, the rewritten code was placed into a public SourceForge project: WONDER

Prev Home Next

WONDER Overview

Adaptors: Adaptor enhancements & binaries
Sample Apps: BugTracker, Stepwise, Wrox...
ERChangeNotificationJMS: Cross-instance EO change notification using JMS
ERDirectToWeb: DirectToWeb additions & fixes
ERExtensions: WebObjects additions & fixes
ERJavaMail: WebObjects JavaMail integration
JavaWOExtensions: WOExtensions enhancements
WOOgnl: Key-Value Coding on Steroids
WOPayPal: WebObjects PayPal integration
Utilities: HTMLColorPalette, PBX AppleScript...
Validity: EOModel-level validation system

Prev Home Next

Adaptors

Public hosting of Apple's Open Source Web Server Adaptor
Three bugs fixed
Two enhancements already rolled in
Increased platform support
- Linux (Red Hat*, SuSE, Debian)
- BSDs (Free, Open)
Additional adaptor type added (FastCGI)
Hosting of precompiled versions
- Saving you compilation headaches!
Help needed to cover all platform possibilities

Prev Home Next

BugTracker

One of the sample applications included in WONDER
Simple, intuitive bug tracking application
NOT related to Eric Noyau's BugTracker WWDC sample
Built using ER frameworks
Demonstrates a more advanced D2W app
Localization effort by Tatsuya Kawano (Japanese) and Anjo Krank (German)
Supports MySQL and FrontBase via prototypes

Prev Home Next

ERExtensions

Validation Templates
Localization
Log4J
JUnit
JavaScript Components
Compiler Proxy
Browser Detection

EO Prototyping
EO Qualifiers
EOF Delegates
Per-Thread Storage
Utilities Galore
145 classes
61 components

Prev Home Next

ERDirectToWeb

Better Rule Caching
Localization
Templates
Sub Tasks
Delegates

XML Target Output
Lots of Property-Level Components
Custom Assignments
197 classes
120 components

Prev Home Next

ERJavaMail

Revision of Camille Troillard's famous OdaikoJavaMail
Integration of Jonathan Rentzsch's not-so-famous JRMailDelivery
- Drop-in replacement for WOMailDelivery
- Renamed to ERWOMailDelivery
Mulithreaded mail delivery
Internal queuing system
Advanced WOComponent mailing methods (attachments!)
Supports Localization
Handles plain text and HTML messages

Prev Home Next

JavaWOExtensions

Public hosting of Apple's Open Source JavaWOExtensions framework
Reasons:
- Fix bugs
- Formally private ivars and methods made public
- Retrofit localization support
Drop in replacement for Apple's JavaWOExtensions
- Enhancements should go into ERExtension instead

Prev Home Next

WOOgnl

OGNL: Object Graph Navigation Language
http://www.ognl.org
Think: Key-Value Coding on Steroids
WOOgnl integrates OGNL into binding resolution
Examples:
- ~\"Hello Mr.\"+session.user.firstName
- ~name.length().(#this>100?2*#this:20+#this)
- ~#A=new NSMutableArray(),#A.addObject(name),#A

Prev Home Next

WOPayPal

Easy WebObjects PayPal integration
- Donated by Travis Cripps
Requires Business or Premiere account
Supports Instant Payment Notifications via a delegate
Offers WOComponents that automatically generate correct PayPal urls

Prev Home Next

Utilities

D2WSorter:	sorts rules in .d2wModel files prior to cvs checkins
HTMLColorPalette:	HTML color palette for Cocoa apps
PBXAppleScriptMenuPlugin:	Adds an AppleScript menu to PBX
PBXTool:	Adds and sorts entries & groups in PBX .pbproj files
template_creator.pl:	Look & Feel Helper
woaFrameworkMerger:	Copies referenced frameworks into a .woa

Prev Home Next

Validity

Gammastream's formally commercial offering
- now part of WONDER!
Two parts: a framework and a tool (ValidityModeler)
Use tool to add validation rules to your .eomodeld
The framework hooks into your EOs' validateFor[Insert|Save|Update|Delete] methods
Framework engine applies rules at runtime
- throws exception if rule is broken
Less validation code necessary your EOs

Prev Home Next

Getting WONDER

Building WONDER can be tricky
Recommendation: use a pre-built release instead
- However, official release doesn't include all goodies
If you want to build from cvs:
- You must have a ~/Roots directory
  - Build products will be placed there
- ant is used to build frameworks and make documentation
  - http://jakarta.apache.org/ant
  - http://wonder.sourceforge.net/start.html

Prev Home Next

Folks Behind WONDER

Andrus Adamchik:	woproject ant support
Bill Bumgarner:	Project Lead
Travis Cripps:	WOPayPal framework, project web site, look & feel
Patrice Gautier:	Project Lead, ER Frameworks
Tatsuya Kawano:	ER Frameworks, Localization, ant build scripts, ERChangeNotificationJMS
Anjo Krank:	ER Frameworks, Compiler Proxy, Localization, ant, tools
Angela Muller:	ER Frameworks, ERXGraph
Max Muller:	Project Lead, ER Frameworks
Wojtek Narczynski:	FastCGI Adaptor
Bruno Posokhow:	ERFrameworks
Jonathan Rentzsch:	Adaptors, ERJavaMail
Jim Roepcke:	ER Frameworks
Jermey Sacket:	Validity
Michael Sacket:	Validity
Camille Troillard:	ERJavaMail, ERFrameworks

Prev Home Next

Join Project WONDER

We want your help to make WONDER even more WONDER-ful!
Come visit us at http://wonder.sourceforge.net
Subscribe to the wonder-disc mailing list

Prev Home Next

Project WONDER

originated by Max Muller & Patrice Gautier

http://wonder.sourceforge.net

Q & A