About the WebObjects 5.3.1 Update

This document contains an overview and download information for the WebObjects 5.3.1 Update. WebObjects 5.3.1 is primarily for developers who want to develop WebObjects applications with Mac OS X 10.4 using Xcode 2.3 and WebObjects 5.3.1 Developer Tools, which are bundled with the Xcode 2.3 tools release. WebObjects 5.3.1 is formally qualified and supported on the Java 1.4.2 platform.

The WebObjects Current Patch List contains information on all available patches and updates for all versions of WebObjects. Read this document if you're not sure which update you need on your system.

This update addresses the issues and adds support for the features listed below:

Starting with the WebObjects Server Admin plug-in for Mac OS X Server 10.4, the WebObjects StartupItems mechanism for auto starting WebObjects services has migrated to launchd-based services. The documentation for deploying WebObjects applications can be found at here, and this documentation has been updated to describe the features of Mac OS X Server 10.4

Important: There are two mutually exclusive updates for this platform. In order to install the WebObjects 5.3.1 developer tools, you will need to install the Xcode 2.3 developer tools with the optional WebObjects packages enabled. WebObjects deployment is distributed through Mac OS X Server 10.4 and is installed by default. In order to update WebObjects Deployment to WebObjects 5.3.1, you will need to either run the Software Update application or manually download them and install.

WebObjects 5.3.1 Developer for Mac OS X 10.4

System requirements

WebObjects 5.3.1 Developer requires:

If you have not yet updated to the correct version of Mac OS X or Developer Tools, you must do so before installing WebObjects 5.3.1. Mac OS X 10.4 and the Xcode 2.2 Developer tools are available through Software Update and ADC downloads.

If you are creating a new Mac OS X WebObjects 5.3.1 development system, you should install the software in the following order:

  1. Install Mac OS X 10.4.
  2. Run the Xcode 2.3 installer.
  3. Select the Custom Install option.
  4. Enable the WebObjects install packages.

WebObjects 5.3.1 Deployment for Mac OS X 10.4 Server

This update is available through the Software Update feature of Mac OS X. If you use this method, only the proper update for the software which you have installed on your system is visible and available for download.

System requirements

WebObjects 5.3.1 Deployment requires:

If you have not yet updated to the correct version of Mac OS X Server, you must do so before installing WebObjects 5.3.1.

If you are creating a new Mac OS X WebObjects 5.3.1 deployment system, you should install the software in the following order:

  1. Mac OS X 10.4
  2. WebObjects 5.3 Server Manual Software Update
  3. WebObjects 5.3.1 Server Software Update

Note: The WebObjects Server 5.3 Update is available only from Apple Downloads.

Configuration tasks

To configure and start the WebObjects services:

  1. Start the Server Admin application.
  2. Select the WebObjects service.
  3. Click the Settings tab.
  4. Configure the wotaskd and monitoring services.
  5. Click the Start button.

Important: You do not need to manually edit the apache.conf file with the line. We have already inserted it for you:

# Including WebObjects Configs
Include /System/Library/WebObjects/Adaptors/Apache/apache.conf

 

Issues Outstanding in WebObjects 5.3.1

4430398: TITLE: OpenBase JDBC and J2SE 5.0

ISSUE: If you have upgraded to Java 1.5 Update 4, database transactions with OpenBase fail with strange data mapping errors.

RESOLUTION: Download the latest the latest J2SE 5.0-compliant OpenBase JDBC driver at: http://www.openbase.com

 

Issues resolved in WebObjects 5.3.1

4443822: TITLE: EOModeler incompatible with J2SE 5.0

ISSUE: Older versions of the EOModeler application, bundled with WebObjects, are incompatible with J2SE 5.0 Release 4.

RESOLUTION: This issue has been resolved.

 

3120230: TITLE: WOEventDisplay page is not accessible

ISSUE: The WOEventDisplay page was not accessible.

RESOLUTION: This issue has been resolved.

 

4209546: TITLE: Potential NullPointerException in EOEditingContext

ISSUE: Fixed a potential error condition in EOEditingContext.

RESOLUTION: This issue has been resolved.

 

4240473: TITLE: EOUtilities.localInstanceOfObject() NullPointerException when passed null

ISSUE: EOUtilities.localInstanceOfObject() was not properly checking for null values.

RESOLUTION: This issue has been resolved.

 

4142548: TITLE: Cannot create relations across multiple EOModels using XCode's EOModeler Plug-in

ISSUE: Cannot create relations across multiple EOModels using XCode's EOModeler Plug-in

RESOLUTION: In most instances, we are able to make cross model relationships available.

 

4142566: TITLE: EOModeler Plugin does not preserve Allow Null Values when upgrading from WO 5.2

ISSUE: XCode's EOModeler Plug-in was not respecting null values

RESOLUTION: This issue has been resolved.

 

4143767: TITLE: XCode will not open .eomodeld file with charValue

ISSUE: XCode's EOModeler Plug-in was not respecting char external types

RESOLUTION: This issue has been resolved.

 

4144527: TITLE: Exception in plugin when opening models with 'requiresAllQualifierBindingVariables' key

ISSUE: XCode's EOModeler Plug-in was not respecting the requiresAllQualifierBindingVariables key in eomodels

RESOLUTION: This issue has been resolved.

 

4149671: TITLE: Can not open existing eomodels with new xcode 2.1 modeller plugin

ISSUE: XCode's EOModeler Plug-in was not handling certain instances of Single Table Inheritance in eomodels correctly

RESOLUTION: This issue has been resolved.

 

4159090: TITLE: EOModeler application will not generate java files

ISSUE: EOModeler application could not generate java files because templates files were not installed

RESOLUTION: This issue has been resolved.

 

4171161: TITLE: EOModeled data does not retain graph layout between openings

ISSUE: XCode's EOModeler Plug-in does not retain graph layout between openings

RESOLUTION: Please note that if you had created or modified an eomodel in the Xcode 2.1 EOModeler plugin some of the diagram state may be invalid and will require you to delete the layout and elements files in your .eomodeld bundle.

 

4171162: TITLE: Schema generation problems with EOModel and xCode 2.1

ISSUE: XCode's EOModeler Plug-in might generate an exception with certain eomodels

RESOLUTION: This issue has been resolved.

 

4108931: TITLE: EOModeler application quit causes Xcode 2 to hang

ISSUE: Under some circumstances, when quitting EOModeler, Xcode would hang.

RESOLUTION: This issue has been resolved.

 

4120429: TITLE: Problems creating WebObjects J2EE enabled Application

ISSUE: An error panel appears creating WebObjects J2EE enabled Application in Xcode

RESOLUTION: This issue has been resolved.

 

4215730: TITLE: WOComponent template generates HTML 3.2 DTD, not 4.0.1

ISSUE: One of the WOComponent file templates was not generating HTML 4.0.1

RESOLUTION: This issue has been resolved.

 

4218449: TITLE: Assistant window in Xcode has 'Project Builder' in text

ISSUE: There were some references to 'Project Builder' instead of 'Xcode' in the WebObjects Assistant

RESOLUTION: This issue has been resolved.

 

4262647: TITLE: Infinite loop in New WebObjects Application Project assistant path chooser field

ISSUE: The WOAssistant could over aggressively validating file paths

RESOLUTION: This issue has been resolved.

 

4140818: TITLE: WebObjects Builder closes documents without quitting on Quit Command

ISSUE: WebObjects Builder closes documents without quitting on Quit Command

RESOLUTION: This issue has been resolved.

 

4141630: TITLE: Version error in WebObjects Builder Application

ISSUE: WebObjects Builder reported it's version incorrectly in the About box

RESOLUTION: This issue has been resolved.

 

4142458: TITLE: WebObjects Builder mouse over a Dynamic Element changes selection from selected text

ISSUE: Selection tracking in WebObjects Builder was not working correctly

RESOLUTION: This issue has been resolved.

 

4142654: TITLE: Saving WO component generates an error and deletes the component

ISSUE: WebObjects Builder was not respecting encoding specified in the preferences and therefore failed to save component changes

RESOLUTION: This issue has been resolved.

 

4145480: TITLE: Missing table buttons in WebObjects Builder inspector panel

ISSUE: The table manipulations buttons did not appear in WebObjects Builder inspector

RESOLUTION: This issue has been resolved.

 

4145481: TITLE: Need configurable palette of WO element icons

ISSUE: A replacement for the one click workflow toolbar functionality in WebObjects Builder

RESOLUTION: There is now a 'Elements and Components' window.

 

4151714: TITLE: HTML blockquote in WebObjects Builder produces a misspelled tag

ISSUE: HTML blockquote in WebObjects Builder produces a misspelled tag

RESOLUTION: This issue has been resolved.

 

4161213: TITLE: WebObjects Builder 5.3 allows binding to invalid action

ISSUE: WebObjects Builder allowed for invalid binding actions in the inspector

RESOLUTION: This issue has been resolved.

 

4168235: TITLE: WebObjects Builder Floating Inspector does not float under WebObjects Builder

ISSUE: WebObjects Builder floating inspector did not always order front correctly.

RESOLUTION: This issue has been resolved.

 

4234707: TITLE: WebObjects Builder loses Font and Font Size Setting

ISSUE: WebObjects Builder loses Font and Font Size Setting

RESOLUTION: This issue has been resolved.

 

4188001: TITLE: Problems with the WOStatsPage HTML template

ISSUE: The WOStatsPage was not accessible

RESOLUTION: This issue has been resolved.

 

4237223: TITLE: Direct Action generate non-valid URL

ISSUE: URLs generated by DirectActions sometimes incorrectly converted &

RESOLUTION: This issue has been resolved.

 

4169582: TITLE: Iterator returned by NSArray.iterator() returns null values

ISSUE: Sometimes Iterator returned by NSArray.iterator() returns null values

RESOLUTION: This issue has been resolved.

 

4267639: TITLE: WebObjects war servlet fails to open eomodeld hidden in application jar on Java 1.4.2_09

ISSUE: WebObjects war servlet failed to find eomodeld files within the bundle on Java 1.4.2 Update 2

RESOLUTION: This issue has been resolved.

 

4144617: TITLE: WODeclarationFormatException from deleting EO in D2W app with Basic look

ISSUE: One of the Direct To Web components caused a WODeclarationFormatException

RESOLUTION: This issue has been resolved.

 

4149116: TITLE: DirectToWeb generation misses removebutton

ISSUE: One of the Direct To Web components caused a WODeclarationFormatException

RESOLUTION: This issue has been resolved.

 

4164111: TITLE: D2W WOLInspectPage.wo misspelled submitchanges tag in 'WebObjects' template

ISSUE: One of the Direct To Web components caused a WODeclarationFormatException

RESOLUTION: This issue has been resolved.

 

4232286: TITLE: DTW generation error in one of the components

ISSUE: One of the Direct To Web components caused a WODeclarationFormatException

RESOLUTION: This issue has been resolved.

 

4232286: TITLE: incorrectly quoted value in HTML code causes runtime error in D2W

ISSUE: One of the Direct To Web components caused a WODeclarationFormatException

RESOLUTION: This issue has been resolved.

 

Troubleshooting

1. My application is throwing the exception "com.webobjects.foundation.NSForwardException for java.lang.NoClassDefFoundError: javax/servlet/ServletContext".

For some reason, the necessary packages are not in your classpath. Debug your classpath to make sure the javax.servlet.* classes are there. If the classes are not found, the resolution is to download the servlet.jar and put it into /Library/Java/Extensions or in your classpath. The servlet.jar can be found with many open source distributions (such as tomcat).

2. How do I convert my legacy WebObjects application to build as a true war bundle?

  1. In Xcode, configure your build settings to the following:

     


    SERVLET_SINGLE_DIR_DEPLOY = NO
    SERVLET_STUB_WAR = NO
    SERVLET_TRUE_WAR = YES
    SERVLET_DEPLOY_LICENSE = <your deployment license> 
    SERVLET_WEBAPPS_DIR = /Library/JBoss/3.2/deploy
  2. Add the JavaWOJSPServlet.framework to your project.
  3. You should also verify that all of your custom frameworks are being built as jar files and are installed or linked into /Library/WebObjects/lib.

3. Interface Builder and the WebObjects Assistant in Xcode is complaining about the Enterprise Objects palette not being installed.

The Enterprise Objects palette is not loaded by default in the Xcode 2.3 release and has been moved from an auto-loaded location in /Developer/Palettes to /Developer/Extras/Palettes. This mainly effects people building Java Client nib based applications.

To load the palette from the new location:

  1. Launch Interface Builder.
  2. Choose Tools > Palettes > Palette Preferences.
  3. Delete the "Missing" Enterprise Objects palette reference.
  4. Add a new reference to the Palette in: /Developer/Extras/Palettes
Published Date: Feb 19, 2012