Documentation Archive Developer
Search
Table of Contents Previous Section

Converting Old Projects

Under version 3.5 of WebObjects, projects are organized differently than under previous versions. This section describes how to convert your old projects to the new organization so that you can work with them in WebObjects 3.5 and beyond.

If your existing project is already a WebObjectsApplication project (that is, it was created by Project Builder and has a PB.project file), you can use Project Builder to convert your project. If your project does not have a PB.project file, you must create a new project and add your existing files to the appropriate suitcases.

In version 3.5, the .woa extension is reserved for the application wrapper. Previously, the project directory itself had the .woa extension. Before converting your project, you should rename its folder to remove the .woa extension.

Performing the Conversion

To convert your project, open it in Project Builder. (It's a good idea to create a backup of your project before converting.) If your project was created prior to WebObjects 3.5, Project Builder detects that a conversion needs to be done. It reassigns the files in your project to new suitcases, as appropriate. It uses the file extension to determine what action to take; if there are files whose extensions it doesn't recognize, it reports these at the end of the conversion, and you must manually assign those files to the appropriate suitcases.

The following list summarizes the conversions that take place:

In the conversion process, you are prompted to confirm each type of operation. In general, you should accept the default action for each prompt; otherwise, you will have to perform the action manually.

Once the conversion has begun, there is no way to cancel it. If you choose not to convert at all, you may not be able to view some of your files, since they are assigned to suitcases that aren't visible.

Moving Your Images

After the project is converted, there are additional changes you may want to make in order to take advantage of the new features of WebObjects 3.5. In previous versions, images were stored inside the components themselves. To support the new "split installation" procedure, images should be stored in the Web Server Resources suitcase, so that the web server can access them at run time. (When you build your project, the items in this suitcase are copied to the WebServerResources directory inside the application wrapper.)

When using the dynamic elements WOImage and WOActiveImage, you use their filename attribute to reference images inside the WebServerResources directory. You may also have images in a framework that can be shared by multiple applications. To access these images, use the framework attribute to specify the framework name. See "Working With Dynamic Elements" in this document and the Dynamic Elements Reference for more information.