com.perforce.api
Class FileEntry

java.lang.Object
  com.perforce.api.SourceControlObject
      com.perforce.api.FileEntry

All Implemented Interfaces:

Cacheable

public final class FileEntry
extends SourceControlObject

Representation of a source control file.

Version:

$Date: 2002/06/05 $ $Revision: #8 $

Author:

David Markley

See Also:

Hashtable

Constructor Summary

FileEntry()
Default no-argument constructor.

FileEntry(Env env)
Constructs a file entry using the environment.

FileEntry(Env env, java.lang.String p)
Constructs a file entry using the environment and path.

FileEntry(java.lang.String p)
Constructs a file entry using the path.

Method Summary

static FileEntry	checkIn(Env env, java.lang.String path, java.lang.String description) Checks in a file that has already been opened on the client using the description given.
void	commit() No-op.
static java.lang.String	customizePath(java.lang.String str, char from_char, char to_char) Returns the path after converting characters.
static java.lang.String	depotizePath(java.lang.String path) Returns the path in depot format.
HashDecay	getCache() Returns the HashDecay instance for this class
java.lang.String	getClientPath() Returns the client path for this file.
java.lang.String	getDepotPath() Returns the depot path for this file.
java.lang.String	getDescription() Returns the decription for this file
static FileEntry	getFile(java.lang.String p) Gets the file information for the specified path.
java.lang.String	getFileContents() Returns a String that contains this file's contents.
java.lang.String	getFileContents(Env env, java.lang.String path) Returns a String that contains this file's contents.
static java.util.Vector	getFileLog(Env env, java.lang.String path) Returns a list of FileEntry objects that represent the history of the specified file.
static java.util.Vector	getFiles(Env env, java.lang.String path) Returns the list of files for the path.
int	getHaveRev() Returns the revision number the client has for this file.
java.lang.String	getHeadAction() Returns the head revision action for this file.
int	getHeadChange() Returns the head revision change number for this file.
java.lang.String	getHeadDate() Returns a String representation of date for the head revsision of the file.
int	getHeadRev() Returns the head revision number for this file.
long	getHeadTime() Returns the head revision time for this file.
java.lang.String	getHeadTimeString() Returns the head revision time as a String for this file.
java.lang.String	getHeadType() Returns the head revision type for this file.
java.lang.String	getName() Returns the file name.
static java.util.Vector	getOpened() Returns a list of files that are open for edit or add.
static java.util.Vector	getOpened(Env env, boolean stat) Returns a list of files that are open for edit or add.
static java.util.Vector	getOpened(Env env, boolean stat, boolean all, int changelist, java.util.Vector files) Returns a list of files that are open for edit or add.
java.lang.String	getOwner() Returns the owner for this file
FileEntry	getSource() Returns the source file entry associated with this file.
static java.lang.String	HTMLEncode(java.lang.String str) Deprecated. Don't use this anymore.
static java.lang.String	localizePath(java.lang.String path) Returns the path in local format.
void	obtainLock() Obtains the lock for this file.
void	openForAdd() Opens this file for addition.
void	openForAdd(Change chng) Opens this file for addition.
static FileEntry	openForAdd(Env env, java.lang.String path, Change chng) Opens the file on the path for add under the change.
void	openForEdit() Opens this file for edit.
void	openForEdit(boolean force, boolean lock) Opens this file for edit.
void	openForEdit(boolean force, boolean lock, Change chng) Opens this file for edit.
static FileEntry	openForEdit(Env env, java.lang.String path, boolean sync, boolean force, boolean lock, Change chng) Opens the file on the path for edit under the change.
void	reopen(java.lang.String type, Change chng) Reopens the file with the new type or in the new change list.
java.lang.String	resolve(boolean force) Resolves this file.
static java.lang.String	resolveAll(Env env, java.lang.String flags, java.lang.String path) Resolves all the files in the path.
static java.lang.String	resolveAT(Env env, java.util.Enumeration en) Forces a resolve on a set of files.
boolean	revert() Reverts this file.
void	setClientPath(java.lang.String p) Sets the client path for this file.
void	setDepotPath(java.lang.String p) Sets the depot path for this file.
void	setDescription(java.lang.String d) Sets the decription for this file
void	setHaveRev(int rev) Sets the revision number the client has for this file.
void	setHeadAction(java.lang.String action) Sets the head revision action for this file.
void	setHeadChange(int change) Sets the head revision change number for this file.
void	setHeadDate(java.lang.String date) Sets the head date for this file.
void	setHeadRev(int rev) Sets the head revision number for this file.
void	setHeadTime(long time) Sets the head revision time for this file.
void	setHeadType(java.lang.String type) Sets the head revision type for this file.
void	setOwner(java.lang.String o) Sets the owner for this file
void	setSource(FileEntry fent) Sets the source file entry associated with this file.
void	setTimeFormat(java.lang.String format) Sets the format used by the getHeadTimeString method.
void	sync() Brings this object back into sync with Perforce.
static java.util.Vector	synchronizeWorkspace(Env env, java.lang.String path) Returns a Vector of FileEntry objects that reflect what files were changed by the sync process.
java.lang.String	syncMySpace(Env env, java.lang.String path) Deprecated.
static java.lang.String	syncWorkspace(Env env, java.lang.String path) Synchronizes the workspace.
java.lang.String	toString()
java.lang.String	toXML() Returns a string containing the object in XML form.

Methods inherited from class com.perforce.api.SourceControlObject

clearCache, getEnv, getSyncTime, getUpdateTime, inSync, invalidate, outOfSync, refreshUpdateTime, setEnv

Methods inherited from class java.lang.Object

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

Constructor Detail

FileEntry

public FileEntry()

Default no-argument constructor.

FileEntry

public FileEntry(Env env)

Constructs a file entry using the environment.

Parameters:

env - Source control environement to use.

FileEntry

public FileEntry(Env env,
                 java.lang.String p)

Constructs a file entry using the environment and path.

Parameters:

env - Source control environement to use.

p - Path to the file.

FileEntry

public FileEntry(java.lang.String p)

Constructs a file entry using the path.

Parameters:

p - Path to the file.

Method Detail

getCache

public HashDecay getCache()

Description copied from class: SourceControlObject

Returns the HashDecay instance for this class

Specified by:

getCache in interface Cacheable

Specified by:

getCache in class SourceControlObject

setDescription

public void setDescription(java.lang.String d)

Sets the decription for this file

getDescription

public java.lang.String getDescription()

Returns the decription for this file

setOwner

public void setOwner(java.lang.String o)

Sets the owner for this file

getOwner

public java.lang.String getOwner()

Returns the owner for this file

setSource

public void setSource(FileEntry fent)

Sets the source file entry associated with this file.

getSource

public FileEntry getSource()

Returns the source file entry associated with this file.

setHeadType

public void setHeadType(java.lang.String type)

Sets the head revision type for this file.

getHeadType

public java.lang.String getHeadType()

Returns the head revision type for this file.

setHeadDate

public void setHeadDate(java.lang.String date)

Sets the head date for this file. The expected format for the date is yyyy/MM/dd. The time will default to 12:00:00 AM.

getHeadDate

public java.lang.String getHeadDate()

Returns a String representation of date for the head revsision of the file. The format is yyyy/MM/dd.

setHeadTime

public void setHeadTime(long time)

Sets the head revision time for this file.

getHeadTime

public long getHeadTime()

Returns the head revision time for this file.

setTimeFormat

public void setTimeFormat(java.lang.String format)

Sets the format used by the getHeadTimeString method. The format of this string is that of the SimpleDateFormat class.

An example format would be setTimeFormat("MM/dd HH:mm:ss");

See Also:

SimpleDateFormat

getHeadTimeString

public java.lang.String getHeadTimeString()

Returns the head revision time as a String for this file.

setHeadAction

public void setHeadAction(java.lang.String action)

Sets the head revision action for this file.

getHeadAction

public java.lang.String getHeadAction()

Returns the head revision action for this file.

setHeadChange

public void setHeadChange(int change)

Sets the head revision change number for this file.

getHeadChange

public int getHeadChange()

Returns the head revision change number for this file.

setHeadRev

public void setHeadRev(int rev)

Sets the head revision number for this file.

getHeadRev

public int getHeadRev()

Returns the head revision number for this file.

setHaveRev

public void setHaveRev(int rev)

Sets the revision number the client has for this file.

getHaveRev

public int getHaveRev()

Returns the revision number the client has for this file.

setDepotPath

public void setDepotPath(java.lang.String p)

Sets the depot path for this file.

Parameters:

p - path for this file in the depot.

getDepotPath

public java.lang.String getDepotPath()

Returns the depot path for this file.

localizePath

public static java.lang.String localizePath(java.lang.String path)

Returns the path in local format. Uses the local path delimeter.

depotizePath

public static java.lang.String depotizePath(java.lang.String path)

Returns the path in depot format. Uses the depot delimeter: '/'.

customizePath

public static java.lang.String customizePath(java.lang.String str,
                                             char from_char,
                                             char to_char)

Returns the path after converting characters.

Parameters:

str - String to convert.

from_char - Character to be changed from.

to_char - Character to be changed to.

resolve

public java.lang.String resolve(boolean force)
                         throws java.io.IOException

Resolves this file. If the force flag is false, and auto-resolve is attempted (p4 resolve -am). If the force flag is true, an "accept theirs" resolve is completed (p4 resolve -at).

Parameters:

force - Indicates whether the resolve should be forced.

Throws:

java.io.IOException

resolveAT

public static java.lang.String resolveAT(Env env,
                                         java.util.Enumeration en)
                                  throws java.io.IOException

Forces a resolve on a set of files. The Enumeration contains the set of FileEntry objects that need resolved.

Parameters:

env - Source control environment to use.

en - Enumeration of FileEntry.

Throws:

java.io.IOException

resolveAll

public static java.lang.String resolveAll(Env env,
                                          java.lang.String flags,
                                          java.lang.String path)
                                   throws java.io.IOException

Resolves all the files in the path. The flags are used by the 'p4 resolve' command to resolve any files in the path. This is just a simple way to execute the 'p4 resolve' command.

Parameters:

env - Source control environment to use.

flags - 'p4 resolve' command flags.

path - Path over which to resolve. May include wildcards.

Throws:

java.io.IOException

HTMLEncode

public static java.lang.String HTMLEncode(java.lang.String str)

Deprecated. Don't use this anymore.

getName

public java.lang.String getName()

Returns the file name.

setClientPath

public void setClientPath(java.lang.String p)

Sets the client path for this file.

Parameters:

p - path for this file on the client system.

getClientPath

public java.lang.String getClientPath()

Returns the client path for this file.

getFile

public static FileEntry getFile(java.lang.String p)

Gets the file information for the specified path.

Parameters:

p - Path of the file to gather information about.

getFiles

public static java.util.Vector getFiles(Env env,
                                        java.lang.String path)

Returns the list of files for the path. The path may include wildcards.

Parameters:

env - Source control environment to use.

path - Path for set of files.

getFileLog

public static java.util.Vector getFileLog(Env env,
                                          java.lang.String path)

Returns a list of FileEntry objects that represent the history of the specified file.

Parameters:

env - Source control environment to use.

path - Path to the file. Must be specific. No wildcards.

openForEdit

public static FileEntry openForEdit(Env env,
                                    java.lang.String path,
                                    boolean sync,
                                    boolean force,
                                    boolean lock,
                                    Change chng)
                             throws java.lang.Exception

Opens the file on the path for edit under the change. If the change is null, the file is opened under the default changelist.

Parameters:

env - P4 Environment

path - Depot or client path to the file being opened for edit.

sync - If true, the file will be sync'd before opened for edit.

force - If true, the file will be opened for edit even if it isn't the most recent version.

lock - If true, the file will be locked once opened.

chng - The change that the file will be opened for edit in.

Throws:

java.lang.Exception

openForEdit

public void openForEdit()
                 throws java.lang.Exception

Opens this file for edit.

Throws:

java.lang.Exception

See Also:

openForEdit(Env, String, boolean, boolean, boolean, Change)

openForEdit

public void openForEdit(boolean force,
                        boolean lock)
                 throws java.lang.Exception

Opens this file for edit.

Throws:

java.lang.Exception

See Also:

openForEdit(Env, String, boolean, boolean, boolean, Change)

openForEdit

public void openForEdit(boolean force,
                        boolean lock,
                        Change chng)
                 throws java.lang.Exception

Opens this file for edit.

Throws:

java.lang.Exception

See Also:

openForEdit(Env, String, boolean, boolean, boolean, Change)

obtainLock

public void obtainLock()
                throws java.lang.Exception

Obtains the lock for this file. The file must have been opened for edit prior to this method being called.

Throws:

java.lang.Exception

openForAdd

public static FileEntry openForAdd(Env env,
                                   java.lang.String path,
                                   Change chng)
                            throws java.lang.Exception

Opens the file on the path for add under the change. If the change is null, the file is opened under the default changelist.

Parameters:

env - P4 Environment

path - Depot or client path to the file being opened for add.

chng - The change that the file will be opened for add in.

Throws:

java.lang.Exception

openForAdd

public void openForAdd()
                throws java.lang.Exception

Opens this file for addition.

Throws:

java.lang.Exception

See Also:

openForAdd(Env, String, Change)

openForAdd

public void openForAdd(Change chng)
                throws java.lang.Exception

Opens this file for addition.

Throws:

java.lang.Exception

See Also:

openForAdd(Env, String, Change)

checkIn

public static FileEntry checkIn(Env env,
                                java.lang.String path,
                                java.lang.String description)
                         throws PerforceException

Checks in a file that has already been opened on the client using the description given. A new changelist is created and used for this submission. The returned FileEntry contains the latest information for the checked-in file.

Throws:

PerforceException

reopen

public void reopen(java.lang.String type,
                   Change chng)
            throws PerforceException

Reopens the file with the new type or in the new change list.

Throws:

PerforceException

revert

public boolean revert()

Reverts this file.

getOpened

public static java.util.Vector getOpened()

Returns a list of files that are open for edit or add. The list is a Vectore of FileEntry objects. The only information that is valid for the object will be the path, until the sync method is called.

getOpened

public static java.util.Vector getOpened(Env env,
                                         boolean stat)

Returns a list of files that are open for edit or add. The list is a Vectore of FileEntry objects.

Getting the stats for each FileEntry is a more expensive operation. By default, this is not done. What this means is that the only information that is valid for the object will be the path, until the sync method is called.

Parameters:

env - Source control environment to use.

stat - Indicates that file statistics should be gathered.

getOpened

public static java.util.Vector getOpened(Env env,
                                         boolean stat,
                                         boolean all,
                                         int changelist,
                                         java.util.Vector files)

Returns a list of files that are open for edit or add. The list is a Vector of FileEntry objects.

Getting the stats for each FileEntry is a more expensive operation. By default, this is not done. What this means is that the only information that is valid for the object will be the path, until the sync method is called.

If changelist is 0, all the changes in the default changelist are returned. If it is less than 0, all opened files are returned.

Parameters:

env - Source control environment to use.

stat - Indicates that file statistics should be gathered.

all - Indicates that all open files should be returned.

changelist - If non-zero, show files open in this changelist.

files - If non-null, show files open in this Vector of FileEntry objects.

commit

public void commit()

No-op. This makes no sense for a FileEntry.

Specified by:

commit in interface Cacheable

Specified by:

commit in class SourceControlObject

syncMySpace

public java.lang.String syncMySpace(Env env,
                                    java.lang.String path)
                             throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

See Also:

syncWorkspace(Env, String)

synchronizeWorkspace

public static java.util.Vector synchronizeWorkspace(Env env,
                                                    java.lang.String path)
                                             throws java.io.IOException

Returns a Vector of FileEntry objects that reflect what files were changed by the sync process. If path is null, the entire workspace is synchronized to the head revision. The path may contain wildcard characters, as with the command line 'p4 sync' command.

Parameters:

env - Source control environment.

path - Path to synchronize. May include wildcards.

Throws:

java.io.IOException

syncWorkspace

public static java.lang.String syncWorkspace(Env env,
                                             java.lang.String path)
                                      throws java.io.IOException

Synchronizes the workspace.

Parameters:

env - Source control environment.

path - Path to synchronize. May include wildcards.

Throws:

java.io.IOException

getFileContents

public java.lang.String getFileContents()

Returns a String that contains this file's contents. This only works well for text files.

getFileContents

public java.lang.String getFileContents(Env env,
                                        java.lang.String path)

Returns a String that contains this file's contents. This only works well for text files.

Parameters:

env - Source control environment.

path - Path to the file. Must be specific. No wildcards.

sync

public void sync()

Description copied from class: SourceControlObject

Brings this object back into sync with Perforce. This also sets the sets the update and sync time for this object.

Specified by:

sync in interface Cacheable

Specified by:

sync in class SourceControlObject

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toXML

public java.lang.String toXML()

Description copied from class: SourceControlObject

Returns a string containing the object in XML form.

Specified by:

toXML in class SourceControlObject