com.starteam
Class Trace.WebCacheTrace

java.lang.Object
  com.starteam.LiveObject.WebCacheLiveObject
      com.starteam.TrackedObject.WebCacheTrackedObject
          com.starteam.VersionedObject.WebCacheVersionedObject
              com.starteam.ViewMember.WebCacheViewMember
                  com.starteam.Trace.WebCacheTrace

All Implemented Interfaces:

ArtifactCacheManager.Securable

Enclosing class:

Trace

public static class Trace.WebCacheTrace
extends ViewMember.WebCacheViewMember

Trace accessor for cached SDK Traces contained objects are obtained from the artifact cache

Method Summary

static Trace.WebCacheTrace	create(ArtifactCacheManager.Context cntxt, View.WebCacheView parent) Creates a Trace on the server.
java.lang.String	getDescription() Gets the description of this trace.
ViewMember.WebCacheViewMember	getSource() Gets the source endpoint of this trace or NULL if the endpoint viewmember is not cached in this ArtifactCache
LinkValue.WebCacheLinkValue	getSourceLink() Gets the source endpoint of this trace.
Trace.Status	getStatus() Gets the Status of this Trace.
ViewMember.WebCacheViewMember	getTarget() Gets the target endpoint of this trace or NULL if the endpoint viewmember is not cached in this ArtifactCache
LinkValue.WebCacheLinkValue	getTargetLink() Gets the target endpoint of this trace.
Trace.TraceType	getTraceType() Gets the TraceType of this Trace.
boolean	isSuspect() Determines whether the trace is suspect
void	pinSource() Set the source end-point of this trace to pinned.
void	pinTarget() Set the target end-point of this trace to pinned.
void	setDescription(java.lang.String description) Sets the description of this trace.
void	setSource(LinkValue.WebCacheLinkValue source) Sets the source endpoint of this trace.
void	setSource(ViewMember.WebCacheViewMember source) Sets the source endpoint of this trace.
void	setStatus(Trace.Status status) Set the status of the trace
void	setSuspect(boolean isSuspect) Mark the trace as suspect
void	setTarget(LinkValue.WebCacheLinkValue target) Sets the target endpoint of this trace.
void	setTarget(ViewMember.WebCacheViewMember target) Sets the target endpoint of this trace.
void	setTraceType(Trace.TraceType type) Set the trace type of the trace
void	unpinSource() Set the source end-point of this trace to float.
void	unpinTarget() Set the target end-point of this trace to float.

Methods inherited from class com.starteam.ViewMember.WebCacheViewMember

getAttachments, getComment, getDisplayValue, getDotNotation, getExternalID, getExternalURL, getHistory, getLocker, getPresentationID, getRights, getShareTree, getTraces, getView, isDeleted, isFloating, isPinned, isUnread, lock, lock, modifyReadStatus, pinTo, setAttachments, setExternalID, setExternalURL, setRights, unlock, unpin, updateRevisionComment

Methods inherited from class com.starteam.VersionedObject.WebCacheVersionedObject

getRevisionNumber, getRootObjectID, getViewVersion, isFromHistory

Methods inherited from class com.starteam.TrackedObject.WebCacheTrackedObject

getModifiedBy, getModifiedTime

Methods inherited from class com.starteam.LiveObject.WebCacheLiveObject

addTo, equals, getContext, getCreatedBy, getCreatedTime, getDisplayName, getID, getObjectID, getServer, getType, getValue, getValue, hashCode, hasValue, isDirty, isNew, refresh, remove, removeFrom, setValue, setValue, toStarTeamURL, update

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static Trace.WebCacheTrace create(ArtifactCacheManager.Context cntxt,
                                         View.WebCacheView parent)

Creates a Trace on the server. This trace may be saved by assigning the various properties and then calling update() on the WebCacheTrace object, or it may be added to a WebCacheViewMemberCollection, which is then saved in a transacted context.

Parameters:

cntxt - the ArtifactCacheManager User Session Context

parent - the parent view in which this new trace will be created. The parent view should be from the artifact cache

Returns:

the newly created Trace.WebCacheTrace, wrapping a new Trace

getSource

public ViewMember.WebCacheViewMember getSource()

Gets the source endpoint of this trace or NULL if the endpoint viewmember is not cached in this ArtifactCache

Returns:

The source endpoint of this trace.

getSourceLink

public LinkValue.WebCacheLinkValue getSourceLink()

Gets the source endpoint of this trace.

Returns:

The source endpoint of this trace.

setSource

public void setSource(ViewMember.WebCacheViewMember source)

Sets the source endpoint of this trace.

Parameters:

source - The source view member of this trace. May be from this server or any other; the resulting source LinkValue will be an internal link or an external link as appropriate.

Throws:

java.lang.IllegalArgumentException - () if the source ViewMember is itself a Trace

setSource

public void setSource(LinkValue.WebCacheLinkValue source)

Sets the source endpoint of this trace.

Parameters:

source - The source linkvalue of this trace. May be from this server or any other; or may be a URL. the resulting source LinkValue will be an internal or external link as appropriate.

Throws:

java.lang.IllegalArgumentException - () if the source is null

getTarget

public ViewMember.WebCacheViewMember getTarget()

Gets the target endpoint of this trace or NULL if the endpoint viewmember is not cached in this ArtifactCache

Returns:

The target endpoint of this trace.

getTargetLink

public LinkValue.WebCacheLinkValue getTargetLink()

Gets the target endpoint of this trace.

Returns:

The target endpoint of this trace.

setTarget

public void setTarget(ViewMember.WebCacheViewMember target)

Sets the target endpoint of this trace.

Parameters:

target - The target view member of this trace. May be from this server or any other; the resulting source LinkValue will be an internal link or an external link as appropriate.

Throws:

java.lang.IllegalArgumentException - () if the target ViewMember is itself a Trace

setTarget

public void setTarget(LinkValue.WebCacheLinkValue target)

Sets the target endpoint of this trace.

Parameters:

target - The target linkvalue of this trace. May be from this server or any other; or may be a URL. the resulting source LinkValue will be an internal or external link as appropriate.

Throws:

java.lang.IllegalArgumentException - () if the source is null

getDescription

public java.lang.String getDescription()

Gets the description of this trace.

Returns:

The description of this trace.

setDescription

public void setDescription(java.lang.String description)

Sets the description of this trace.

Parameters:

description - The description of this trace.

isSuspect

public boolean isSuspect()

Determines whether the trace is suspect

Returns:

true if the trace is suspect

setSuspect

public void setSuspect(boolean isSuspect)

Mark the trace as suspect

Parameters:

isSuspect - the suspect flag

getTraceType

public Trace.TraceType getTraceType()

Gets the TraceType of this Trace.

Returns:

Trace.TraceType

setTraceType

public void setTraceType(Trace.TraceType type)

Set the trace type of the trace

Parameters:

type - the trace type to set

getStatus

public Trace.Status getStatus()

Gets the Status of this Trace.

Returns:

Status

setStatus

public void setStatus(Trace.Status status)

Set the status of the trace

Parameters:

status - the status to set

unpinSource

public void unpinSource()

Set the source end-point of this trace to float. i.e. the source will always match the tip ViewMember of the configuration

pinSource

public void pinSource()

Set the source end-point of this trace to pinned. i.e. the source will match the specified revision of the ViewMember

unpinTarget

public void unpinTarget()

Set the target end-point of this trace to float. i.e. the target will always match the tip ViewMember of the configuration

pinTarget

public void pinTarget()

Set the target end-point of this trace to pinned. i.e. the target will match the specified revision of the ViewMember