com.vmware.content.library

Class ItemModel.Builder

java.lang.Object

com.vmware.content.library.ItemModel.Builder

Enclosing class:

ItemModel

public static final class ItemModel.Builder
extends java.lang.Object

Builder class for ItemModel.

Constructor Summary

Constructors

Constructor and Description
Builder() Constructor with parameters for the required properties of ItemModel.

Method Summary

Modifier and Type	Method and Description
ItemModel	build()
ItemModel.Builder	setCached(java.lang.Boolean cached) The status that indicates whether the library item is on disk or not.
ItemModel.Builder	setContentVersion(java.lang.String contentVersion) The latest version of the file content list of this library item.
ItemModel.Builder	setCreationTime(java.util.Calendar creationTime) The date and time when this library item was created.
ItemModel.Builder	setDescription(java.lang.String description) A human-readable description for this library item.
ItemModel.Builder	setId(java.lang.String id) A unique identifier for this library item.
ItemModel.Builder	setLastModifiedTime(java.util.Calendar lastModifiedTime) The date and time when the metadata for this library item was last changed.
ItemModel.Builder	setLastSyncTime(java.util.Calendar lastSyncTime) The date and time when this library item was last synchronized.
ItemModel.Builder	setLibraryId(java.lang.String libraryId) The identifier of the LibraryModel to which this item belongs.
ItemModel.Builder	setMetadataVersion(java.lang.String metadataVersion) A version number for the metadata of this library item.
ItemModel.Builder	setName(java.lang.String name) A human-readable name for this library item.
ItemModel.Builder	setSize(java.lang.Long size) The library item size, in bytes.
ItemModel.Builder	setSourceId(java.lang.String sourceId) The identifier of the ItemModel to which this item is synchronized to if the item belongs to a subscribed library.
ItemModel.Builder	setType(java.lang.String type) An optional type identifier which indicates the type adapter plugin to use.
ItemModel.Builder	setVersion(java.lang.String version) A version number that is updated on metadata changes.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Constructor with parameters for the required properties of ItemModel.

Method Detail

setId

public ItemModel.Builder setId(java.lang.String id)

A unique identifier for this library item. This property is not used for the create method. It will not be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

id - New value for the property. When clients pass a value of this class as a parameter, the property must be an identifier for the resource type: com.vmware.content.library.Item. When methods return a value of this class as a return value, the property will be an identifier for the resource type: com.vmware.content.library.Item.

setLibraryId

public ItemModel.Builder setLibraryId(java.lang.String libraryId)

The identifier of the LibraryModel to which this item belongs. This property must be provided for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

libraryId - New value for the property. When clients pass a value of this class as a parameter, the property must be an identifier for the resource type: com.vmware.content.Library. When methods return a value of this class as a return value, the property will be an identifier for the resource type: com.vmware.content.Library.

setContentVersion

public ItemModel.Builder setContentVersion(java.lang.String contentVersion)

The latest version of the file content list of this library item. This property is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

contentVersion - New value for the property. When clients pass a value of this class as a parameter, the property must be an identifier for the resource type: com.vmware.content.library.item.Version. When methods return a value of this class as a return value, the property will be an identifier for the resource type: com.vmware.content.library.item.Version.

setCreationTime

public ItemModel.Builder setCreationTime(java.util.Calendar creationTime)

The date and time when this library item was created. This property is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

creationTime - New value for the property.

setDescription

public ItemModel.Builder setDescription(java.lang.String description)

A human-readable description for this library item. This property is optional for the create method. Leaving it null during creation will result in an empty string value. It will always be present in the result of a get or list method. It is optional for the update method. Leaving it null during update indicates that the description remains unchanged.

Parameters:

description - New value for the property.

setLastModifiedTime

public ItemModel.Builder setLastModifiedTime(java.util.Calendar lastModifiedTime)

The date and time when the metadata for this library item was last changed.

This property is affected by changes to the properties or file content of this item. It is not modified by changes to the tags of the item, or by changes to the library which owns this item.

This property is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

lastModifiedTime - New value for the property.

setLastSyncTime

public ItemModel.Builder setLastSyncTime(java.util.Calendar lastSyncTime)

The date and time when this library item was last synchronized.

This property is updated every time a synchronization is triggered on the library item, including when a synchronization is triggered on the library to which this item belongs. The value is null for a library item that belongs to a local library.

This property is not used for the create method. It is optional in the return value of the get or list methods. It is not used for the update method.

Parameters:

lastSyncTime - New value for the property.

setMetadataVersion

public ItemModel.Builder setMetadataVersion(java.lang.String metadataVersion)

A version number for the metadata of this library item.

This value is incremented with each change to the metadata of this item. Changes to name, description, and so on will increment this value. The value is not incremented by changes to the content or tags of the item or the library which owns it.

This property is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

metadataVersion - New value for the property.

setName

public ItemModel.Builder setName(java.lang.String name)

A human-readable name for this library item.

The name may not be null or an empty string. The name does not have to be unique, even within the same library.

This property must be provided for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

Parameters:

name - New value for the property.

setCached

public ItemModel.Builder setCached(java.lang.Boolean cached)

The status that indicates whether the library item is on disk or not. The library item is cached when all its files are on disk. This property is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

Parameters:

cached - New value for the property.

setSize

public ItemModel.Builder setSize(java.lang.Long size)

The library item size, in bytes. The size is the sum of the size used on the storage backing for all the files in the item. When the library item is not cached, the size is 0. This property is not used for the create method. It is optional in the return value of the get or list methods. It is not used for the update method.

Parameters:

size - New value for the property.

setType

public ItemModel.Builder setType(java.lang.String type)

An optional type identifier which indicates the type adapter plugin to use.

This property may be set to a non-empty string value that corresponds to an identifier supported by a type adapter plugin present in the Content Library Service. A type adapter plugin, if present for the specified type, can provide additional information and services around the item content. A type adapter can guide the upload process by creating file entries that are in need of being uploaded to complete an item.

The types and plugins supported by the Content Library Service can be queried using the Type interface.

This property is optional for the create and update methods. During creation, if the type is left unspecified, or if the type is specified but does not have a corresponding type support plugin, then the type of the library item is considered to be generic and all data is treated as generic files. During update, if the type is not specified, then it is not updated.

Parameters:

type - New value for the property.

setVersion

public ItemModel.Builder setVersion(java.lang.String version)

A version number that is updated on metadata changes. This value is used to validate update requests to provide optimistic concurrency of changes.

This value represents a number that is incremented every time library item properties, such as name or description, are changed. It is not incremented by changes to the file content of the library item, including adding or removing files. It is also not affected by tagging the library item.

This property is not used for the create method. It will always be present in the result of a get or list method. It is optional for the update method. Leaving it null during update indicates that you do not need to detect concurrent updates.

Parameters:

version - New value for the property.

setSourceId

public ItemModel.Builder setSourceId(java.lang.String sourceId)

The identifier of the ItemModel to which this item is synchronized to if the item belongs to a subscribed library. The value is null for a library item that belongs to a local library. This property is not used for the create method. It is optional in the return value of the get or list methods. It is not used for the update method.

Parameters:

sourceId - New value for the property. When clients pass a value of this class as a parameter, the property must be an identifier for the resource type: com.vmware.content.library.Item. When methods return a value of this class as a return value, the property will be an identifier for the resource type: com.vmware.content.library.Item.

build

public ItemModel build()