Retrieve the value of a single attribute from a business object.
Syntax
Object get(String attribute) Object get(int position)
boolean getBoolean(String attribute) double getDouble(String attribute) float getFloat(String attribute) int getInt(String attribute) long getLong(String attribute) Object get(String attribute) BusObj getBusObj(String attribute) BusObjArray getBusObjArray(String attribute) String getLongText(String attribute) String getString(String attribute)
Parameters
Return values
The value of the specified attribute.
Exceptions
CollaborationException--These get methods can set the following exception type for this exception:
Notes
These "get" methods retrieve an attribute value from the current business object. They return a copy of the attribute value. They do not return an object reference to this attribute in the source business object. Therefore, any change to attribute value in the source business object is not made to value that the particular get method returns. Each time one of these get methods is called, it returns a new copy (clone) of the attribute.
These get methods provide the following forms:
These methods provide the ability to access an attribute value by specifying the name of the attribute.
This method provides the ability to access an attribute value by specifying either the name of the attribute or the attribute's index position within the business object attribute list.
Examples
The following example illustrates how get() returns a copy (clone) of the attribute value instead of an object reference:
BusObj mySettingBusObj = new BusObj(); BusObj myBusObj = new BusObj(); myBusObj.set("attr1", mySettingBusObj); BusObj Extract = myBusObj.get("attr1");
After this code fragment executes, if you change the Extract business object, mySettingBusObj does not change because the get() call returned a copy of the attr1 attribute.
The following example uses getBusObj() to retrieve a child business object containing a customer address from the customer business object and assign it to the variable address.
BusObj address = customer.getBusObj("Address");
The following example uses getString() to retrieve the value of the CustomerName attribute. The business object variable is sourceCustomer.
String customerName = sourceCustomer.getString("CustomerName");
The following example uses getInt() to retrieve the Quantity values from two business objects whose variables are item1 and item2. The example then computes the sum of both quantities.
int sumQuantity = item1.getInt("Quantity") + item2.getInt("Quantity");
The following example retrieves the attribute Item from the business object variable order. The attribute Item is a business object array.
BusObjArray items = order.getBusObjArray("Item");
The following example gets the CustID attribute value from the source business object and sets the Customer value in the destination business object to match.
destination.set("Customer", source.get("CustID"));
The following example accesses an attribute value using the attribute's ordinal position within the attribute list:
for(i=0; i<maxAttrCount; i++) { String strValue = (String)myBusObj.get(i); ...