Linked Java Object builder inputs

Table 1. General input

Input Name	Description
Name	Name for this builder call. The WebSphere Portlet Factory Designer displays this name in the builder call list.

Table 2. Overwriting input

Input Name

Description

Rename Existing

This input is useful to change the behavior of code that was placed in the WebApp by a high-level builder or by an imported model. For example, you might want to do this if you have a Domino View and Form builder in your model, and you want to use a different class for one of the LJOs that builder adds to the WebApp. The Domino View and Form builder does not provide an LJO Class Name input. But you can place a new LJO builder in the model and give it the same name as that assigned by the Domino View and Form builder, thus replacing the existing LJO and specifying a new class. Enable When set, this input causes the builder to replace an existing WebApp object with a new object. The builder locates the existing WebApp object (variable, LJO, and so on), renames it, and creates a replacement object. Note: This input is available on the following low-level builders that create WebApp objects: Action List, Imported Page, Linked Java Object, Linked Model, Method, Method Call, Page, Variable, and Schema.

Table 3. Advanced inputs

Input Name	Description
Class Name	Enter the fully-qualified name for the class to use for your LJO. For example, com.acme.BigRock mypackage.MyClass If there is no package (the class is either in IBM® WebSphere Portlet Factory WEB-INF/classes or work/classes directory), enter the class name.
Instantiation Method	Select a method that calls a constructor in your Java class and passes any necessary arguments. Use a no argument method in your web application that returns an instance of the LJO class after constructing it.
State and Failover	Select the failover behavior for the LJO. You can choose from the following values: Read-Write This setting prompts the model to save the current value for the variable in the case of a failover event. This failover functionality does incur a small performance hit, so only use the default setting when necessary. Read-Write but not persisted for failover This setting allows your variable value to change, but its value at the time of failover is not preserved. Read-only: shared across all users This setting makes your variable behave like a constant. Its value never changes from the initial setting. As a result, some performance gains are realized because a copy of the variable is not made during generation and the variable is not processed during the failover event. Request Scope This setting stores the variable value in a request attribute rather than in a class (WebAppInstanceData). Doing this can improve performance for large variables that are set and read within a single request, and not needed across multiple requests. Note: Do not use Request Scope for items such as XML variables that are used in multiple requests. Doing so would clone and initialize the request copy of that variable for every use. Use Request Scope for infrequently used variables and variables that hold large objects or hierarchies of objects (such as XML). A typical use of Request Scope might be for a variable that contains data for a table that is displayed on only page of a multiple page application.
Model Method Base	Select whether you want the class generated for the model Method builder calls to extend the class specified for this LJO. Select either of these values: Use this Linked Java Object's class as a base for all methods in model Select this value to define the generated class for the model method as extending the class specified for this LJO. Doing so provides the following benefits: Methods in the LJO get displayed as top-level methods in the reference chooser. Calling methods in the LJO from other methods is simpler. For example, webAppAccess.callMethod("MethodName"); instead of: webAppAccess.callMethod("LJOName.MethodName"); Don't extend model methods from this Linked Java Object class Select this value if it does not make sense to extend the LJO class for the model methods. For example, if the LJO contains many member variables.
Target Phase	Select the generation phase in which to execute the LJO as one of the following options. This useful only if existing elements are being modified. The LinkedJavaObject class uses this for the getTargetPhase method. Construction Post-construction Modification Validation Process Externalize