org.gcube.common.homelibrary.home.workspace

Interface WorkspaceItem

All Known Subinterfaces:

ExternalFile, ExternalImage, ExternalPDFFile, ExternalUrl, FolderItem, GCubeItem, Query, Report, ReportTemplate, TimeSeries, WorkflowReport, WorkflowTemplate, WorkspaceCatalogue, WorkspaceCatalogueItem, WorkspaceFolder, WorkspaceSharedFolder, WorkspaceTrashFolder, WorkspaceTrashItem, WorkspaceVREFolder

public interface WorkspaceItem

Define a Workspace item like folder or folder-item.

Author:

Federico De Faveri defaveri@isti.cnr.it

Method Summary

Methods

Modifier and Type	Method and Description
WorkspaceItem	cloneItem(String cloneName) Clone this item.
void	deleteACL(List<String> users) Delete ACL for a list of users
List<AccountingEntry>	getAccounting()
Map<ACLType,List<String>>	getACLOwner() Get a map of ACL of a WorkspaceSharedFolder
ACLType	getACLUser() Get the ACL of a WorkspaceSharedFolder
List<? extends WorkspaceItem>	getChildren() Return this item children.
Calendar	getCreationTime() This item creation time.
String	getDescription() This item description.
String	getId() This item id.
String	getIdSharedFolder() Get the id of the parent shared folder
org.gcube.common.homelibary.model.util.WorkspaceItemAction	getLastAction() Return the last action on this Item.
Calendar	getLastModificationTime() This item last modification time.
String	getLastUpdatedBy() Return last updated by
String	getName() This item name.
User	getOwner() This item owner.
WorkspaceFolder	getParent() Return this item parent.
String	getPath() Return the current item path.
Properties	getProperties() The item properties.
String	getPublicLink(boolean shortUrl) Get a public link for the item
List<AccountingEntryRead>	getReaders() Get a list of item readers.
String	getRemotePath() Get the remote path of the element
String	getSecurePublicLink(boolean shortenUrl) Get a secure (i.e.
String	getStorageID() Get a storageId
org.gcube.common.homelibary.model.items.type.WorkspaceItemType	getType() Return this item type.
boolean	hasAccessRight(String user, String absPath) Return true if the user has the right to read the resource at abspath
boolean	isFolder() Check if the item is a folder
boolean	isHidden() Return a flag indicating whether the element is hidden
boolean	isMarkedAsRead() Return a flag indicating whether the element marked as read
boolean	isRoot() Says if this item is a root element.
boolean	isShared() Return a flag indicating whether the element is shared
boolean	isTrashed() Check if the item is in the trash
void	markAsRead(boolean read) Mark as read a shared item
void	move(WorkspaceFolder destination) Move this item to a new folder.
void	remove() Remove this item from the workspace.
void	removeChild(WorkspaceItem child) Remove a child from this item.
void	rename(String name) Change this item name.
void	setDescription(String description) Set a new item description.
void	setHidden(boolean flag) Mark items as hidden
void	updateItem(InputStream fileData) Update item

Method Detail

getId

String getId()
             throws InternalErrorException

This item id.

Returns:

the id.

Throws:

InternalErrorException - if an internal error occurs.

getName

String getName()
               throws InternalErrorException

This item name.

Returns:

the name.

Throws:

InternalErrorException - if an internal error occurs.

getDescription

String getDescription()
                      throws InternalErrorException

This item description.

Returns:

the description.

Throws:

InternalErrorException - if an internal error occurs.

setDescription

void setDescription(String description)
                    throws InternalErrorException

Set a new item description.

Parameters:

description - the new description.

Throws:

InternalErrorException - if an internal error occurs.

rename

void rename(String name)
            throws InternalErrorException,
                   InsufficientPrivilegesException,
                   ItemAlreadyExistException

Change this item name.

Parameters:

name - the new name.

Throws:

InternalErrorException - if an internal error occurs.

InsufficientPrivilegesException - if the user don't have sufficient privileges to perform this operation.

ItemAlreadyExistException - if an item with this name already exists in the containing folder.

getCreationTime

Calendar getCreationTime()
                         throws InternalErrorException

This item creation time.

Returns:

the creation time.

Throws:

InternalErrorException - if an internal error occurs.

getLastModificationTime

Calendar getLastModificationTime()
                                 throws InternalErrorException

This item last modification time.

Returns:

the last modification time.

Throws:

InternalErrorException - if an internal error occurs.

getLastUpdatedBy

String getLastUpdatedBy()
                        throws InternalErrorException

Return last updated by

Returns:

Throws:

InternalErrorException

getLastAction

org.gcube.common.homelibary.model.util.WorkspaceItemAction getLastAction()
                                                                         throws InternalErrorException

Return the last action on this Item.

Returns:

the last action.

Throws:

InternalErrorException - if an internal error occurs.

getOwner

User getOwner()
              throws InternalErrorException

This item owner.

Returns:

the owner.

Throws:

InternalErrorException - if an internal error occurs.

getProperties

Properties getProperties()
                         throws InternalErrorException

The item properties.

Returns:

the properties.

Throws:

InternalErrorException - if an internal error occurs.

getAccounting

List<AccountingEntry> getAccounting()

Returns:

the list of {link

getType

org.gcube.common.homelibary.model.items.type.WorkspaceItemType getType()

Return this item type.

Returns:

the type.

getParent

WorkspaceFolder getParent()
                          throws InternalErrorException

Return this item parent.

Returns:

the parent.

Throws:

InternalErrorException - if an internal error occurs.

getPath

String getPath()
               throws InternalErrorException

Return the current item path.

Returns:

the path.

Throws:

InternalErrorException - if an internal error occurs.

isRoot

boolean isRoot()
               throws InternalErrorException

Says if this item is a root element.

Returns:

true if this element is a root, false otherwise.

Throws:

InternalErrorException - if an internal error occurs.

getChildren

List<? extends WorkspaceItem> getChildren()
                                          throws InternalErrorException

Return this item children.

Returns:

the children.

Throws:

InternalErrorException - if an internal error occurs.

removeChild

void removeChild(WorkspaceItem child)
                 throws InternalErrorException,
                        InsufficientPrivilegesException

Remove a child from this item.

Parameters:

child - the child to remove.

Throws:

InternalErrorException - if an internal error occurs.

InsufficientPrivilegesException - if the user don't have sufficient privileges to perform this operation.

remove

void remove()
            throws InternalErrorException,
                   InsufficientPrivilegesException

Remove this item from the workspace.

Throws:

InternalErrorException - if an internal error occurs.

InsufficientPrivilegesException - if the user don't have sufficient privileges to perform this operation.

move

void move(WorkspaceFolder destination)
          throws InternalErrorException,
                 WrongDestinationException,
                 InsufficientPrivilegesException,
                 ItemAlreadyExistException

Move this item to a new folder.

Parameters:

destination - the destination folder.

Throws:

InternalErrorException - if an internal error occurs.

WrongDestinationException - if the destination folder have a wrong type.

InsufficientPrivilegesException - if the user don't have sufficient privileges to perform this operation.

ItemAlreadyExistException - if an item with the new name already exist in the destination folder.

cloneItem

WorkspaceItem cloneItem(String cloneName)
                        throws InternalErrorException,
                               InsufficientPrivilegesException,
                               ItemAlreadyExistException

Clone this item.

Parameters:

cloneName - the new clone name.

Returns:

the clone.

Throws:

InternalErrorException - if an internal error occurs.

InsufficientPrivilegesException - if the user don't have sufficient privileges to perform this operation.

ItemAlreadyExistException - if an item with the new name already exist.

setHidden

void setHidden(boolean flag)
               throws InternalErrorException

Mark items as hidden

Parameters:

flag - true if the element is hidden, false if the element is visible.

Throws:

InternalErrorException

isHidden

boolean isHidden()
                 throws InternalErrorException

Return a flag indicating whether the element is hidden

Returns:

true if the element is hidden, false if the element is visible.

Throws:

InternalErrorException

isShared

boolean isShared()
                 throws InternalErrorException

Return a flag indicating whether the element is shared

Returns:

true if the element is shared, false otherwise.

Throws:

InternalErrorException

isMarkedAsRead

boolean isMarkedAsRead()
                       throws InternalErrorException

Return a flag indicating whether the element marked as read

Returns:

true if the element is marked as read, false otherwise.

Throws:

InternalErrorException

getReaders

List<AccountingEntryRead> getReaders()
                                     throws InternalErrorException

Get a list of item readers.

Returns:

the list of item readers.

Throws:

InternalErrorException

markAsRead

void markAsRead(boolean read)
                throws InternalErrorException

Mark as read a shared item

Throws:

InternalErrorException

getIdSharedFolder

String getIdSharedFolder()
                         throws InternalErrorException

Get the id of the parent shared folder

Returns:

the id of the parent shared folder if the item is shared, null otherwise.

Throws:

InternalErrorException

getRemotePath

String getRemotePath()
                     throws InternalErrorException

Get the remote path of the element

Returns:

the remote path of the element

Throws:

InternalErrorException

isTrashed

boolean isTrashed()
                  throws InternalErrorException

Check if the item is in the trash

Returns:

true if the item has been trashed

Throws:

InternalErrorException

isFolder

boolean isFolder()
                 throws InternalErrorException

Check if the item is a folder

Returns:

true if the item is a folder

Throws:

InternalErrorException

getPublicLink

String getPublicLink(boolean shortUrl)
                     throws InternalErrorException

Get a public link for the item

Parameters:

shortenUrl -

Returns:

an http link for the item

Throws:

InternalErrorException

getSecurePublicLink

String getSecurePublicLink(boolean shortenUrl)
                           throws InternalErrorException

Get a secure (i.e. https) public link for the item

Parameters:

shortenUrl -

Returns:

a secure https link for the item

Throws:

InternalErrorException

getStorageID

String getStorageID()
                    throws InternalErrorException

Get a storageId

Returns:

storageId

Throws:

InternalErrorException

hasAccessRight

boolean hasAccessRight(String user,
                     String absPath)
                       throws InternalErrorException

Return true if the user has the right to read the resource at abspath

Parameters:

user -

absPath: - absolute path of a node

Returns:

true if the user has the right to read the resource at abspath

Throws:

javax.jcr.RepositoryException

InternalErrorException

deleteACL

void deleteACL(List<String> users)
               throws InternalErrorException

Delete ACL for a list of users

Parameters:

users -

Throws:

InternalErrorException

getACLUser

ACLType getACLUser()
                   throws InternalErrorException

Get the ACL of a WorkspaceSharedFolder

Returns:

Throws:

InternalErrorException

getACLOwner

Map<ACLType,List<String>> getACLOwner()
                                      throws InternalErrorException

Get a map of ACL of a WorkspaceSharedFolder

Returns:

Throws:

InternalErrorException

updateItem

void updateItem(InputStream fileData)
                throws InternalErrorException,
                       InsufficientPrivilegesException,
                       ItemNotFoundException

Update item

Parameters:

fileData -

Throws:

InternalErrorException

InsufficientPrivilegesException

ItemNotFoundException