Home >	Contents >	Index >

Template Tags TOC   |    Alpha TOC   |    Tag Family TOC   |    Purpose TOC   |    Annotated TOC   |    Index

object:load

Loads an object.

Syntax

<object:load
      classname="classname"
      name="object name"
      [objectid="object id"]
      [objectversion="object version"]
      [checkout="checkout info"]
      [nodeid="node ID"]
      [field="field"]
      [value="object value"]
      [arg1="argument 1"]
      [arg2="argument 2"]
      [list="list name"] />

Parameters

classname (required)

Classname of the object.

name (required)

Name of the object.

objectid (optional)

ID of the object.

objectversion (optional)

Version of the object.

checkout (optional)

Checkout information for the object.

nodeid (optional)

Node ID for the object.

field (optional)

This parameter specifies the name of a field argument that can be used to uniquely identify an object. When using this parameter the, value parameter should also be specified to indicate the value of the specified field.

value (optional)

Specifies the value of a field for unique identification. The value parameter must be used in conjunction with the field parameter.

arg1 (optional)

Argument 1.

arg2 (optional)

Argument 2.

list (optional)

Name of existing list. This parameter allows you to load an object from an existing list rather than from the database.

Description

This tag creates a new instance of the implementing class, loads a specific object into the object instance, and saves the object instance in the object pool using the specified name. The object can be requested by referencing the following information:

• object identifier

• object version

• node object identifier

• key field and key value

The implementing class must implement a load method. The load method should have one of the following prototypes:

• public static MyClass Load(ICS ics, Long lObjectId, Integer iObjectVersion, boolean bLock)

• public static MyClass Load(ICS ics, Long lObjectId, Integer iObjectVersion, boolean bLock, String sArg1)

• public static MyClass Load(ICS ics, Long lNodeId)

• public static MyClass Load(ICS ics, Long lNodeId, String sArg1)

• public static MyClass Load(ICS ics, String sField, String sValue)

  public static MyClass Load(ICS ics, String sField, String sValue, String sArg1)

Error Numbers

The possible values of errno include:

Value	Description
-10026	No list by specified name exists.

Example

The following example loads object1 from the sample catalog.

<object:load 
       classname="com.openmarket.framework.objects.AbstractObject"
       name="object1"
       objectid='<%=ics.GetVar("id"%>'
       arg1="sample"/>

The following example uses the optional list parameter.

<object:list 
	 classname="com.openmarket.framework.objects.AbstractObject" 
	 arg1="obj03" 
	 list="list1"/>
        <ics:listloop listname="list1">
                <object:load classname="com.openmarket.framework.objects.AbstractObject" 	 	 	 	 arg1="obj03" 
	 	 	 	 list="list1" 
	 	 	 	 name="object1"/>
                <object:scatter name="object1" 
	 	 	 	 prefix="object1"/>
                id: <ics:getvar name="object1:id"/><br/>
        </ics:listloop>

See Also

object:save

		Home >	Contents >	Index >
	Oracle JSP Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.