Working with custom data using Java

You can store data of your own format in items. Use the following methods in the Document and Item classes:

Document

Item

Description

getItemValueCustomData

getValueCustomData

Gets custom data in the form of an object.

getItemValueCustomDataBytes

getValueCustomDataBytes

Gets custom data in the form of a byte array.

replaceItemValueCustomData

setValueCustomData

Writes custom data in the form of an object.

replaceItemValueCustomDataBytes

setValueCustomDataBytes

Writes custom data in the form of a byte array.

An item that contains custom data is of type Item.USERDATA (14).

If you store data using an object, do not change the defining class.

If you plan on working with custom data through another interface, such as LotusScript®, use the byte array methods.

Note: In Release 6, custom data was added for Java. In Release 6.5, custom data was added for CORBA, LotusScript®, and COM. LotusScript® and COM support only the byte array methods.

When you store data, you can specify a data type name that must be supplied when you get the data.

Domino® Objects cannot be stored as custom data.