Manual Adjustments to Java Client Projects

You should always use the Java Client wizards if you can because the files that they generate have characteristics that are important for Java Client applications. These files have various dependencies and assumptions, which you must know about if you decide to create them manually.

• If you create a subproject of type EOJavaClientSubproject by hand, make sure that EOJavaClient.framework is added to the frameworks of the main project. Otherwise the compiler might not find all the Java Client classes required by the interface controllers.

• The file's owner class of an Java Client interface (nib) file must be the EOInterfaceController subclass that uses it. It is also very important that the package name of the file's owner class is identical to the package name of the interface controller. So if you change the package of the interface controller, you have to open the interface file in Interface Builder and change the name of the EOInterfaceController subclass used for the file's owner.

• The "interfaceControllerClassName" binding of WOJavaClientApplet used in web components has to be the complete class name of an interface controller in a EOJavaClientSubproject, including the full package prefix. If you change the package of the interface controller, you have to change the value of the "interfaceControllerClassName" binding.

• If you change the size of a window in a nib file which is later placed in a WOJavaClientApplet (because the WOJavaClientApplet uses the corresponding EOInterfaceController subclass), you have to modify the size bindings of the WOJavaClientApplet so that the window contents still fit into it.

• You might want to add additional bindings to a WOJavaClientApplet. This component takes standard java.applet bindings plus some special Java Client ones. See " The Ingredients of a Java Client Project " in the tutorial for more information or refer to the WOJavaClientApplet directory in the WebObjects Java Client examples for a complete list of bindings.

• If you use Sun's Java Plug-in, you must set the value of the "useJavaPlugin" binding of all WOJavaClientApplets to YES.

A typical .wod file for a web component using a WOJavaClientApplet looks like this:

Previous | Back Up One Level | Next