Package com.perforce.p4java.impl.generic.core.file

Class ExtendedFileSpec

java.lang.Object

com.perforce.p4java.impl.generic.core.ServerResource

com.perforce.p4java.impl.generic.core.file.FileSpec

com.perforce.p4java.impl.generic.core.file.ExtendedFileSpec

All Implemented Interfaces:

IExtendedFileSpec, IFileOperationResult, IFileSpec, IServerResource

public class ExtendedFileSpec
extends FileSpec
implements IExtendedFileSpec

Useful generic implementation class for the IExtendedFileSpec interface. Fields below generally correspond exactly with the similarly-named Perforce fstat call fields, and will not be documented in detail here.

Field Summary

Fields inherited from class com.perforce.p4java.impl.generic.core.file.FileSpec

action, baseFile, baseName, baseRev, blobSha, branch, changeListId, client, clientName, clientPath, commitSha, date, depotPath, endRevision, fileType, genericCode, label, localPath, opStatus, originalPath, rawCode, repoName, severityCode, sha, startRevision, statusMessage, subCode, subSystem, treeSha, uniqueCode, unmap, userName

Fields inherited from class com.perforce.p4java.impl.generic.core.ServerResource

refreshable, server, updateable

Fields inherited from interface com.perforce.p4java.core.file.IFileSpec

HAVE_REVISION, HAVE_REVISION_STRING, HEAD_REVISION, HEAD_REVISION_STRING, NO_FILE_REVISION, NO_REVISION_STRING, NONE_REVISION, NONE_REVISION_STRING

Constructor Summary

Constructors

Constructor	Description
ExtendedFileSpec()	Default constructor.
ExtendedFileSpec(FileSpecOpStatus status, String errStr)	Construct an ExtendedFileSpec object from a status, message string pair.
ExtendedFileSpec(FileSpecOpStatus status, String errStr, int rawCode)
ExtendedFileSpec(FileSpecOpStatus status, String errStr, int genericCode, int severityCode)	Construct an ExtendedFileSpec object from a status, message string, generic code, severity code tuple.
ExtendedFileSpec(FileSpecOpStatus status, String errStr, String errCodeStr)
ExtendedFileSpec(String pathStr)	Given a candidate path string (which may include version and changelist annotations, at least), try to construct a corresponding extended file spec.
ExtendedFileSpec(Map<String,Object> map, IServer server)	Construct an ExtendedFileSpec object from the passed-in map.

Method Summary

Modifier and Type	Method	Description
String	getActionOwner()
Map<String,byte[]>	getAttributes()	Get the file attributes of this file, if they're available.
Map<String,byte[]>	getAttributeTypes()
String	getCharset()
String	getDesc()
String	getDigest()
long	getFileSize()
int	getHaveRev()
FileAction	getHeadAction()
int	getHeadChange()
String	getHeadCharset()
Date	getHeadModTime()
int	getHeadRev()
Date	getHeadTime()
String	getHeadType()
String	getMovedFile()
FileAction	getOpenAction()
String	getOpenActionOwner()
int	getOpenChangelistId()
String	getOpenType()
List<String>	getOtherActionList()
List<String>	getOtherChangelist()
List<String>	getOtherOpenList()
Map<String,byte[]>	getPropagatingAttributes()
List<IResolveRecord>	getResolveRecords()
String	getVerifyStatus()
boolean	isMapped()
boolean	isOtherLocked()
boolean	isReresolvable()
boolean	isResolved()
boolean	isShelved()
boolean	isUnresolved()
void	setActionOwner(String actionOwner)
void	setCharset(String charset)
void	setDesc(String desc)
void	setDigest(String digest)
void	setEntry(String tag, String value)
void	setFileSize(long fileSize)
void	setHaveRev(int haveRev)
void	setHeadAction(FileAction headAction)
void	setHeadChange(int headChange)
void	setHeadCharset(String headCharset)
void	setHeadModTime(Date headModTime)
void	setHeadRev(int headRev)
void	setHeadTime(Date headTime)
void	setHeadType(String headType)
void	setMapped(boolean mapped)
void	setMovedFile(String movedFile)
void	setOpenAction(FileAction openAction)
void	setOpenActionOwner(String openActionOwner)
void	setOpenChangelistId(int openChangelistId)
void	setOpenType(String openType)
void	setOtherActionList(List<String> otherActionList)
void	setOtherChangelist(List<String> otherChangelist)
void	setOtherLocked(boolean otherLocked)
void	setOtherOpenList(List<String> otherOpenList)
void	setReresolvable(boolean reresolvable)
void	setResolved(boolean resolved)
void	setResolveRecords(List<IResolveRecord> resolveRecords)
void	setUnresolved(boolean unresolved)
void	setVerifyStatus(String verifyStatus)

Methods inherited from class com.perforce.p4java.impl.generic.core.file.FileSpec

getAction, getAnnotatedPathString, getAnnotatedPreferredPathString, getAnnotations, getAnnotations, getBaseFile, getBaseName, getBaseRev, getBlobSha, getBranch, getChangelistId, getClientName, getClientPath, getClientPathString, getCommitSha, getContentResolveType, getContents, getContents, getDate, getDepotPath, getDepotPathString, getDiffStatus, getEndFromRev, getEndRevision, getEndToRev, getFileType, getFromFile, getGenericCode, getHowResolved, getLabel, getLocalPath, getLocalPathString, getOpStatus, getOriginalPath, getOriginalPathString, getOtherAction, getPath, getPathString, getPreferredPath, getPreferredPathString, getRawCode, getRepoName, getResolveType, getResolveTypes, getRevFromString, getRevisionHistory, getRevisionHistory, getSeverityCode, getSha, getShelvedChange, getStartFromRev, getStartRevision, getStartToRev, getStatusMessage, getSubCode, getSubSystem, getSyncTime, getToFile, getTreeSha, getUniqueCode, getUserName, getWorkRev, isLocked, isUnmap, move, move, setAction, setBaseFile, setBaseName, setBaseRev, setBlobSha, setBranch, setChangelistId, setClient, setClientName, setClientPath, setClientPath, setCodes, setCommitSha, setContentResolveType, setDate, setDepotPath, setDepotPath, setDiffStatus, setEndFromRev, setEndRevision, setEndToRev, setFileType, setFromFile, setHowResolved, setLabel, setLocalPath, setLocalPath, setLocked, setOpStatus, setOriginalPath, setOriginalPath, setOtherAction, setPath, setPathFromString, setRepoName, setResolveType, setResolveTypes, setSha, setShelvedChange, setStartFromRev, setStartRevision, setStartToRev, setStatusMessage, setSyncTime, setToFile, setTreeSha, setUnmap, setUserName, setWorkRev, toString

Methods inherited from class com.perforce.p4java.impl.generic.core.ServerResource

canRefresh, canUpdate, clearRawFields, complete, getRawField, getRawFields, hasRawField, parseDate, refresh, setRawField, setRawFields, setRefreshable, setServer, toDateString, update, update, update

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.perforce.p4java.core.file.IFileOperationResult

getGenericCode, getOpStatus, getRawCode, getSeverityCode, getStatusMessage, getSubCode, getSubSystem, getUniqueCode

Methods inherited from interface com.perforce.p4java.core.file.IFileSpec

getAction, getAnnotatedPathString, getAnnotatedPreferredPathString, getAnnotations, getAnnotations, getBaseFile, getBaseName, getBaseRev, getBlobSha, getBranch, getChangelistId, getClientName, getClientPath, getClientPathString, getCommitSha, getContentResolveType, getContents, getContents, getDate, getDepotPath, getDepotPathString, getDiffStatus, getEndFromRev, getEndRevision, getEndToRev, getFileType, getFromFile, getHowResolved, getLabel, getLocalPath, getLocalPathString, getOriginalPath, getOriginalPathString, getOtherAction, getPath, getPathString, getPreferredPath, getPreferredPathString, getRepoName, getResolveType, getResolveTypes, getRevisionHistory, getRevisionHistory, getSha, getShelvedChange, getStartFromRev, getStartRevision, getStartToRev, getSyncTime, getToFile, getTreeSha, getUserName, getWorkRev, isLocked, isUnmap, move, move, setAction, setBaseFile, setBaseName, setBaseRev, setBlobSha, setBranch, setChangelistId, setClientName, setClientPath, setCommitSha, setContentResolveType, setDate, setDepotPath, setDiffStatus, setEndFromRev, setEndRevision, setEndToRev, setFileType, setFromFile, setHowResolved, setLabel, setLocalPath, setLocked, setOriginalPath, setOtherAction, setPath, setPathFromString, setRepoName, setResolveType, setResolveTypes, setSha, setShelvedChange, setStartFromRev, setStartRevision, setStartToRev, setSyncTime, setToFile, setTreeSha, setUnmap, setUserName, setWorkRev, toString

Methods inherited from interface com.perforce.p4java.core.IServerResource

canRefresh, canUpdate, clearRawFields, complete, getRawField, getRawFields, hasRawField, refresh, setRawField, setRawFields, setServer, update, update, update

Constructor Details

ExtendedFileSpec

public ExtendedFileSpec()

Default constructor. Sets all boolean fields to false, object fields to null, integers to zero.

ExtendedFileSpec

public ExtendedFileSpec(String pathStr)

Given a candidate path string (which may include version and changelist annotations, at least), try to construct a corresponding extended file spec.

See the corresponding FileSpec constructor for details -- this constructor does not add any ExtendedFileSpec-specific semantics.

Parameters:

pathStr - candidate path string

ExtendedFileSpec

public ExtendedFileSpec(FileSpecOpStatus status,
 String errStr)

Construct an ExtendedFileSpec object from a status, message string pair. See the corresponding FileSpec constructor for details -- this constructor does not add any ExtendedFileSpec-specific semantics.

Parameters:

status - FileSpecOpStatus status.

errStr - error / info message string.

ExtendedFileSpec

public ExtendedFileSpec(Map<String,Object> map,
 IServer server)

Construct an ExtendedFileSpec object from the passed-in map. The map must be (or have the same keys and semantics as) a map as returned from a suitable Perforce server call; the semantics and format of this map are not spelled out here.

Parameters:

map - suitable field map from Perforce server; if null, this constructor has the same semantics as the default constructor.

server - non-null server object

ExtendedFileSpec

public ExtendedFileSpec(FileSpecOpStatus status,
 String errStr,
 String errCodeStr)

ExtendedFileSpec

public ExtendedFileSpec(FileSpecOpStatus status,
 String errStr,
 int rawCode)

ExtendedFileSpec

public ExtendedFileSpec(FileSpecOpStatus status,
 String errStr,
 int genericCode,
 int severityCode)

Construct an ExtendedFileSpec object from a status, message string, generic code, severity code tuple. See the corresponding FileSpec constructor for details -- this constructor does not add any ExtendedFileSpec-specific semantics.

Parameters:

status - FileSpecOpStatus status.

errStr - error / info message string.

genericCode - Perforce generic code to use

severityCode - Perforce severity code to use.

Method Details

getActionOwner

public String getActionOwner()

Specified by:

getActionOwner in interface IExtendedFileSpec

setActionOwner

public void setActionOwner(String actionOwner)

Specified by:

setActionOwner in interface IExtendedFileSpec

getAttributeTypes

public Map<String,byte[]> getAttributeTypes()

getAttributes

public Map<String,byte[]> getAttributes()

Description copied from interface: IExtendedFileSpec

Get the file attributes of this file, if they're available. Attributes will only be available if getExtendedFiles was called with the correct FileStatAncilliaryOptions settings; see the main Perforce file attribute documentation. Attributes are treated by the Perforce server as bytes (they're commonly used to store raw data such as thumbnails); it is up to the consumer to determine the "real" type and convert as appropriate.

Specified by:

getAttributes in interface IExtendedFileSpec

Returns:

non-null but possibly-empty map of file attributes keyed by attribute name. Individual attribute values may be null.

getCharset

public String getCharset()

Specified by:

getCharset in interface IExtendedFileSpec

setCharset

public void setCharset(String charset)

Specified by:

setCharset in interface IExtendedFileSpec

getDesc

public String getDesc()

Specified by:

getDesc in interface IExtendedFileSpec

setDesc

public void setDesc(String desc)

Specified by:

setDesc in interface IExtendedFileSpec

getDigest

public String getDigest()

Specified by:

getDigest in interface IExtendedFileSpec

setDigest

public void setDigest(String digest)

Specified by:

setDigest in interface IExtendedFileSpec

getFileSize

public long getFileSize()

Specified by:

getFileSize in interface IExtendedFileSpec

setFileSize

public void setFileSize(long fileSize)

Specified by:

setFileSize in interface IExtendedFileSpec

getHaveRev

public int getHaveRev()

Specified by:

getHaveRev in interface IExtendedFileSpec

setHaveRev

public void setHaveRev(int haveRev)

Specified by:

setHaveRev in interface IExtendedFileSpec

getHeadAction

public FileAction getHeadAction()

Specified by:

getHeadAction in interface IExtendedFileSpec

setHeadAction

public void setHeadAction(FileAction headAction)

Specified by:

setHeadAction in interface IExtendedFileSpec

getHeadChange

public int getHeadChange()

Specified by:

getHeadChange in interface IExtendedFileSpec

setHeadChange

public void setHeadChange(int headChange)

Specified by:

setHeadChange in interface IExtendedFileSpec

getHeadCharset

public String getHeadCharset()

Specified by:

getHeadCharset in interface IExtendedFileSpec

setHeadCharset

public void setHeadCharset(String headCharset)

Specified by:

setHeadCharset in interface IExtendedFileSpec

getHeadModTime

public Date getHeadModTime()

Specified by:

getHeadModTime in interface IExtendedFileSpec

setHeadModTime

public void setHeadModTime(Date headModTime)

Specified by:

setHeadModTime in interface IExtendedFileSpec

getHeadRev

public int getHeadRev()

Specified by:

getHeadRev in interface IExtendedFileSpec

setHeadRev

public void setHeadRev(int headRev)

Specified by:

setHeadRev in interface IExtendedFileSpec

getHeadTime

public Date getHeadTime()

Specified by:

getHeadTime in interface IExtendedFileSpec

setHeadTime

public void setHeadTime(Date headTime)

Specified by:

setHeadTime in interface IExtendedFileSpec

getHeadType

public String getHeadType()

Specified by:

getHeadType in interface IExtendedFileSpec

setHeadType

public void setHeadType(String headType)

Specified by:

setHeadType in interface IExtendedFileSpec

getMovedFile

public String getMovedFile()

Specified by:

getMovedFile in interface IExtendedFileSpec

setMovedFile

public void setMovedFile(String movedFile)

Specified by:

setMovedFile in interface IExtendedFileSpec

getOpenAction

public FileAction getOpenAction()

Specified by:

getOpenAction in interface IExtendedFileSpec

setOpenAction

public void setOpenAction(FileAction openAction)

Specified by:

setOpenAction in interface IExtendedFileSpec

getOpenActionOwner

public String getOpenActionOwner()

Specified by:

getOpenActionOwner in interface IExtendedFileSpec

setOpenActionOwner

public void setOpenActionOwner(String openActionOwner)

Specified by:

setOpenActionOwner in interface IExtendedFileSpec

getOpenChangelistId

public int getOpenChangelistId()

Specified by:

getOpenChangelistId in interface IExtendedFileSpec

setOpenChangelistId

public void setOpenChangelistId(int openChangelistId)

Specified by:

setOpenChangelistId in interface IExtendedFileSpec

getOpenType

public String getOpenType()

Specified by:

getOpenType in interface IExtendedFileSpec

setOpenType

public void setOpenType(String openType)

Specified by:

setOpenType in interface IExtendedFileSpec

getOtherActionList

public List<String> getOtherActionList()

Specified by:

getOtherActionList in interface IExtendedFileSpec

setOtherActionList

public void setOtherActionList(List<String> otherActionList)

Specified by:

setOtherActionList in interface IExtendedFileSpec

getOtherChangelist

public List<String> getOtherChangelist()

Specified by:

getOtherChangelist in interface IExtendedFileSpec

setOtherChangelist

public void setOtherChangelist(List<String> otherChangelist)

Specified by:

setOtherChangelist in interface IExtendedFileSpec

getOtherOpenList

public List<String> getOtherOpenList()

Specified by:

getOtherOpenList in interface IExtendedFileSpec

setOtherOpenList

public void setOtherOpenList(List<String> otherOpenList)

Specified by:

setOtherOpenList in interface IExtendedFileSpec

getPropagatingAttributes

public Map<String,byte[]> getPropagatingAttributes()

getResolveRecords

public List<IResolveRecord> getResolveRecords()

Specified by:

getResolveRecords in interface IExtendedFileSpec

setResolveRecords

public void setResolveRecords(List<IResolveRecord> resolveRecords)

Specified by:

setResolveRecords in interface IExtendedFileSpec

getVerifyStatus

public String getVerifyStatus()

Specified by:

getVerifyStatus in interface IExtendedFileSpec

setVerifyStatus

public void setVerifyStatus(String verifyStatus)

Specified by:

setVerifyStatus in interface IExtendedFileSpec

isMapped

public boolean isMapped()

Specified by:

isMapped in interface IExtendedFileSpec

setMapped

public void setMapped(boolean mapped)

Specified by:

setMapped in interface IExtendedFileSpec

isOtherLocked

public boolean isOtherLocked()

Specified by:

isOtherLocked in interface IExtendedFileSpec

setOtherLocked

public void setOtherLocked(boolean otherLocked)

Specified by:

setOtherLocked in interface IExtendedFileSpec

isReresolvable

public boolean isReresolvable()

Specified by:

isReresolvable in interface IExtendedFileSpec

setReresolvable

public void setReresolvable(boolean reresolvable)

Specified by:

setReresolvable in interface IExtendedFileSpec

isResolved

public boolean isResolved()

Specified by:

isResolved in interface IExtendedFileSpec

setResolved

public void setResolved(boolean resolved)

Specified by:

setResolved in interface IExtendedFileSpec

isShelved

public boolean isShelved()

Specified by:

isShelved in interface IExtendedFileSpec

isUnresolved

public boolean isUnresolved()

Specified by:

isUnresolved in interface IExtendedFileSpec

setUnresolved

public void setUnresolved(boolean unresolved)

Specified by:

setUnresolved in interface IExtendedFileSpec

setEntry

public void setEntry(String tag,
 String value)

Specified by:

setEntry in interface IExtendedFileSpec