com.versionone.om

Class BaseAsset

java.lang.Object

com.versionone.om.Entity

com.versionone.om.BaseAsset

Direct Known Subclasses:

BuildProject, BuildRun, ChangeSet, Iteration, Member, Message, Project, ProjectAsset, RegressionSuite, Retrospective, Schedule, Team, TestSuite

public abstract class BaseAsset
extends Entity

Represents the base type of members, projects, teams, etc in the VersionOne system.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	STATE_ACTIVE
protected static int	STATE_CLOSED

Fields inherited from class com.versionone.om.Entity

ASSET_STATE_VALUE, ASSET_VALUE, CHANGE_DATE_UTC, CONTENT_TYPE_VALUE, CONTENT_VALUE, CREATE_DATE_UTC, DELETE_OPERATION, DESCRIPTION_VALUE, FILENAME_VALUE, NAME_VALUE

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canClose()
boolean	canDelete()
boolean	canReactivate()
void	close() Closes or Inactivates the item
Attachment	createAttachment(String name, String fileName, InputStream stream) Create an attachment that belongs to this asset.
Attachment	createAttachment(String name, String fileName, InputStream stream, Map<String,Object> attributes) Create an attachment that belongs to this asset.
Conversation	createConversation(Member author, String content) Creates conversation with an expression which mentioned this asset.
Conversation	createConversation(Member author, String content, Map<String,Object> attributes) Creates conversation with an expression which mentioned this asset.
Link	createLink(String name, String url, boolean onMenu) Create a link that belongs to this asset.
Link	createLink(String name, String url, boolean onMenu, Map<String,Object> attributes) Create a link that belongs to this asset.
Note	createNote(String name, String content, boolean personal) Create a note that belongs to this asset.
Note	createNote(String name, String content, boolean personal, Map<String,Object> attributes) Create a note that belongs to this asset.
void	delete() Deletes the Item
Collection<Attachment>	getAttachments(AttachmentFilter filter)
ICustomDropdownDictionary	getCustomDropdown()
ICustomAttributeDictionary	getCustomField()
String	getDescription()
Collection<Link>	getLinks(LinkFilter filter)
Collection<Expression>	getMentionedInExpressions()
String	getName()
Collection<Note>	getNotes(NoteFilter filter)
String	getURL()
boolean	isActive()
boolean	isClosed()
void	reactivate() Reactivates the item.
void	setDescription(String value)
void	setName(String name)

Methods inherited from class com.versionone.om.Entity

equals, get, getChangeComment, getChangeDate, getChangedBy, getCreateComment, getCreateDate, getCreatedBy, getID, getInstance, hashCode, save, save, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

STATE_CLOSED

protected static final int STATE_CLOSED

See Also:

Constant Field Values

STATE_ACTIVE

protected static final int STATE_ACTIVE

See Also:

Constant Field Values

Method Detail

getURL

public String getURL()

Returns:

URL to VersionOne Detail Page for this BaseAsset.

getName

public String getName()

Returns:

Name of the base asset.

setName

public void setName(String name)

Parameters:

name - Name of the base asset.

getDescription

public String getDescription()

Returns:

description of the base asset.

setDescription

public void setDescription(String value)

Parameters:

value - description of the base asset.

getMentionedInExpressions

public Collection<Expression> getMentionedInExpressions()

Returns:

Expressions that referenced to current item.

getAttachments

public Collection<Attachment> getAttachments(AttachmentFilter filter)

Parameters:

filter - filter for getting a collection of attachments (If null, then all items returned).

Returns:

A collection attachments that belong to this base asset filtered by the passed in filter.

getNotes

public Collection<Note> getNotes(NoteFilter filter)

Parameters:

filter - filter for getting a collection of notes (If null, then all items returned).

Returns:

A collection notes that belong to this base asset filtered by the passed in filter.

getLinks

public Collection<Link> getLinks(LinkFilter filter)

Parameters:

filter - Limit the link returned. If null, then all items returned.

Returns:

A collection links that belong to this base asset filtered by the passed in filter.

isActive

public boolean isActive()

Returns:

Indicates if the entity is open or active.

isClosed

public boolean isClosed()

Returns:

Indicates if the entity is closed or inactive.

canDelete

public boolean canDelete()

Returns:

True if the item can be deleted

delete

public void delete()
            throws UnsupportedOperationException

Deletes the Item

Throws:

UnsupportedOperationException - if the item is an invalid state for the Operation.

getCustomField

public ICustomAttributeDictionary getCustomField()

Returns:

Simple Custom Fields.

getCustomDropdown

public ICustomDropdownDictionary getCustomDropdown()

Returns:

Custom List-Type Fields.

createLink

public Link createLink(String name,
              String url,
              boolean onMenu)

Create a link that belongs to this asset.

Parameters:

name - The name of the link.

url - The url of the link.

onMenu - True if the link is visible on this asset's detail page menu.

Returns:

created Link.

createLink

public Link createLink(String name,
              String url,
              boolean onMenu,
              Map<String,Object> attributes)

Create a link that belongs to this asset.

Parameters:

name - The name of the link.

url - The url of the link.

onMenu - True if the link is visible on this asset's detail page menu.

attributes - additional attributes for the Link.

Returns:

created Link.

createNote

public Note createNote(String name,
              String content,
              boolean personal)

Create a note that belongs to this asset.

Parameters:

name - The name of the note.

content - The content of the note.

personal - True if the note is only visible to the currently logged in user.

Returns:

created Note.

createNote

public Note createNote(String name,
              String content,
              boolean personal,
              Map<String,Object> attributes)

Create a note that belongs to this asset.

Parameters:

name - The name of the note.

content - The content of the note.

personal - True if the note is only visible to the currently logged in user.

attributes - additional attributes for the Note.

Returns:

created Note.

createAttachment

public Attachment createAttachment(String name,
                          String fileName,
                          InputStream stream)
                            throws AttachmentLengthExceededException,
                                   ApplicationUnavailableException

Create an attachment that belongs to this asset.

Parameters:

name - The name of the attachment.

fileName - The name of the original attachment file.

stream - The read-enabled stream that contains the attachment. content to upload.

Returns:

Attachment object with corresponding parameters.

Throws:

AttachmentLengthExceededException - if attachment is too long.

ApplicationUnavailableException - if any problem appears during connection to the server.

createAttachment

public Attachment createAttachment(String name,
                          String fileName,
                          InputStream stream,
                          Map<String,Object> attributes)
                            throws AttachmentLengthExceededException,
                                   ApplicationUnavailableException

Create an attachment that belongs to this asset.

Parameters:

name - The name of the attachment.

fileName - The name of the original attachment file.

stream - The read-enabled stream that contains the attachment. content to upload.

attributes - additional attributes for the Attachment.

Returns:

Attachment object with corresponding parameters.

Throws:

AttachmentLengthExceededException - if attachment is too long.

ApplicationUnavailableException - if any problem appears during connection to the server.

createConversation

public Conversation createConversation(Member author,
                              String content)

Creates conversation with an expression which mentioned this asset.

Parameters:

author - Author of conversation expression.

content - Content of conversation expression.

Returns:

Created conversation

createConversation

public Conversation createConversation(Member author,
                              String content,
                              Map<String,Object> attributes)

Creates conversation with an expression which mentioned this asset.

Parameters:

author - Author of conversation expression.

content - Content of conversation expression.

attributes - additional attributes for the Expression in the Conversation.

Returns:

Created conversation

canClose

public boolean canClose()

Returns:

True if the item can be closed.

close

public void close()
           throws UnsupportedOperationException

Closes or Inactivates the item

Throws:

UnsupportedOperationException - if the item is an invalid state for the Operation, e.g. it is already closed or inactive.

canReactivate

public boolean canReactivate()

Returns:

True if item can be Reactivated.

reactivate

public void reactivate()
                throws UnsupportedOperationException

Reactivates the item.

Throws:

UnsupportedOperationException - if the item is an invalid state for the Operation, e.g. it is already open or active.