WebObjects/Project WONDER/快速入门

快速入门

使用 Project WONDER 非常简单。只需几个步骤即可开始运行。

下载并安装 Project WONDER 框架；
将 ERJars.framework 和 ERExtensions.framework 添加到您的 WebObjects 项目中；
将您的应用程序类更改为扩展 er.extensions.ERXApplication 而不是 WOApplication；
将您的 Application.main 方法更改为调用 er.extensions.ERXApplication.main 而不是 WOApplication.main；
将您的 Session 类更改为扩展 er.extensions.ERXSession 而不是 WOSession；
将您的 DirectAction 类更改为扩展 er.extensions.ERXDirectAction 而不是 WODirectAction；
构建。

使用开箱即用的 Xcode 时，启动此应用程序将出现错误（截至 2007 年 2 月 6 日）

"在 NSMutableArray 中未找到 ERX_MARKER 字段。"

这意味着您的类路径不正确。调整它，使 ERExtensions 位于 JavaFoundation 之前。为此，您必须更改类路径的顺序，使 ERExtensions 位于 JavaFoundation 之上。在我的默认类路径中，JavaFoundation 位于列表的首位。如果您使用的是 Xcode，请遵循 Jerry Walker 的说明。

在 Xcode 窗口左上角的“Active Target”下拉菜单中选择“Application Server”。
键入 command-option-e 或选择“Project->Edit Active Target 'Application Server'”菜单项。这将打开一个目标编辑窗口。
在左侧视图中选择“Build Phases”下的“Link Binary With Libraries”。
您可以通过在右侧列表中上下拖动框架来编辑框架加载顺序。将 ERExtensions.framework 拖动到顶部。
通过在编辑窗格中拖放这些框架来重新排列它们，以达到您想要的顺序。
将您的“Active Target”下拉菜单设置回您的项目名称。这很重要。
清理并重建您的应用程序，您的类路径设置将相应地重新排列。

此错误仅在 Xcode 中出现，显然，此解决方法适用于 Xcode 而不是 Eclipse。此外，还提供了一个用于 ERXApplication 的 Xcode 项目模板。（来自哪里？）

如果您使用的是 WOLips，您可以创建一个新的“Project Wonder Application”，它将使用这些步骤设置一个项目。

就是这样！您现在正在使用 Project WONDER，并且已经开始了轻松进行 WO 应用程序开发的旅程。

来自 David Teran 的笔记

来自 David Teran 2004 年 12 月 1 日：了解框架的指针

"PW 包含不同的框架，最重要的一个是 ERExtensions，然后对于 D2W 应用程序来说，还有 ERDirectToWeb，有些人（如果不是所有人）都在使用 ERCoreBusinessLogic。其他框架是建立在这些框架之上，或建立在其中多个框架之上。

但是：我会先阅读类描述，然后阅读 javadoc，它是从源代码生成的，使用 Eclipse 在一秒钟内生成（好吧，也许是 60 秒……），阅读大约需要 1-3 个小时。

然后我会看一下 ERXApplication、ERXSession、ERXGenericRecord、ERXEC（非常有趣！）、ERXThreadStorage（也很有趣）、ERExtensions……以及各种实用程序类：ERXEOControlUtilities、ERXEOAccessUtilities、ERXArrayUtilities 等等。"

来自 Chris Meyer 的笔记

国际化和本地化

《Practical WebObjects》概述了一种处理国际化的技术。它与 Project WONDER 不兼容。

要在 Project WONDER 中处理国际化，请从您的 Session 类（现在应该从 ERXSession 派生）中删除 takeValuesFromRequest。同样，从您的 Application 类（现在应该从 ERXApplication 派生）中删除 createResponseInContext 方法。然后，将以下调用添加到您的 Application 构造函数中

ERXMessageEncoding.setDefaultEncodingForAllLanguages("UTF8");

日志记录

《Practical WebObjects》概述了一种 SQL 日志记录技术。Project WONDER 使用完全不同的技术。

在 Project WONDER 中，将此代码放入其中一个属性文件中（我使用 ~/WebObjects.properties）

# turn off annoying INFO logs
log4j.logger.er=INFO
log4j.logger.er.extensions.ERXExtensions=OFF

# Enable delegate to emit SQL debugging info. The Logger used is
log4j.category.er.extensions.ERXAdaptorChannelDelegate.sqlLogging=DEBUG
#  put this to true if you want to log sql stuff
er.extensions.ERXAdaptorChannelDelegate.enabled=true
# How long a statement must run to cause a log message. Messages with longer than
# error also emit a stack-trace
er.extensions.ERXAdaptorChannelDelegate.trace.milliSeconds.debug=0
er.extensions.ERXAdaptorChannelDelegate.trace.milliSeconds.info=50
er.extensions.ERXAdaptorChannelDelegate.trace.milliSeconds.warn=1000
er.extensions.ERXAdaptorChannelDelegate.trace.milliSeconds.error=5000
# MaxLength of the message
er.extensions.ERXAdaptorChannelDelegate.trace.maxLength = 30000
# What entities to watch
er.extensions.ERXAdaptorChannelDelegate.trace.entityMatchPattern = .*

回溯

Project WONDER 提供了几种处理回溯的技术。

我推荐的方法是在您的 WOComponent 中添加一个方法。

    /**
     * Determine whether the user backtracked.
     * @return true or false indicating whether the user backtracked
     */
    public boolean didBacktrack()
    {
    	return ((Session)session()).didBacktrack();
    }

然后，在提交表单（回溯可能会出现问题）的任何位置，将此代码添加到操作方法中。

if (this.didBacktrack())
    {
    	ec.revert();
    	// handle and prepare to report errors
    	// this.errors.addObject("Unable to process page after back button was pressed.");
    	return this.context().page();
    }

ERXWORepetition 也包含一些处理回溯的代码。从 Project WONDER 3.0 开始，该代码似乎工作不一致。当页面回溯并提交表单时，表单中的值将作为 null 传递。这往往会导致比它解决的问题更多，尽管您的情况可能有所不同。此外，还可以选择在页面回溯时抛出异常，但该异常似乎并非始终抛出。

Javadocs

预建

从 Wonder 源代码创建 javadocs（不使用 Eclipse）

如果您想创建 javadoc 并且还没有使用 Eclipse

从 nightly build 服务器获取最新源代码。
解压后，您将创建一个 Wonder 文件夹。
在终端应用程序中，% cd 到 Wonder/Build/build 目录
% ant doc
等待几分钟，让一些好东西在您的终端窗口中滚动（如果 ant 给您错误，您可能需要将其设置为使用 ant 1.4 而不是 1.5，方法是导出：JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/1.4/Home）
找到新创建的 dist/wonder-2.0/Documentation/api/index.html 页面，它位于与 Wonder 文件夹解压缩到同一目录中
双击 index.html 页面，javadoc 将在您的浏览器中打开

从 Wonder 源代码创建 javadoc（使用 Eclipse）

其他人将不得不填写此部分...