The Perforce tasks implement Perforce commands using the Perforce Java API. These tasks are intended for build automation with Ant. Note: These tasks are known to work with P4Java 2010.1, JDK 6 and Ant 1.7.0.

The Perforce tasks also served as examples on how to use the Perforce Java API. P4Java is a Java-native API for accessing Perforce SCM services from within Java applications, servlets, plugins, and other Java contexts.

The Perforce task base class takes care of retrieving the required settings for all Perforce tasks. For example, it retrieves the Perforce port, client, user and password from the environment, properties and attributes respectively. The base class also frames the task execution and logs the execution output.

The Perforce server specific base class uses the P4Java ServerFactory class to obtain a IServer interface onto a specific Perforce server at a known network address and port, and connects to this Perforce server through the IServer interface that is returned from the factory. It also logs in to the Perforce server through the IServer's login and associated methods using the specified Perforce user and password. To disconnect from a Perforce server, call the disconnect method on the IServer interface.

The Perforce client specific base class obtains a suitable IClient interface into a Perforce client workspace through the IServer interface's "get client" method.

The following are some of the capabilities of the Perforce tasks:

Get and process lists of depot, client, and local files in the Perforce client workspace, through the IServer and IClient interfaces.
Add, edit, or delete files in the local Perforce client workspace using the IClient interface. These files are added to the default or a numbered Perforce changelist represented by one or more IChangeList interfaces, which are obtained through the IClient or IServer interfaces.
Submit a specific changelist using the associated IChangeList interface. This submission can be linked with one or more Perforce jobs, represented by the IJob interface.
Browse Perforce jobs and changelists, server side diffs of files, create labels, create tags, set counters, grep and revert files using the relevant IServer or IClient interfaces.
Dump detail file info.
Lock and unlock files.
Shelve and unshelve files to and from the Perforce server.

Please see the individual tasks for details. @see com.perforce.ant.tasks.PerforceTask @see com.perforce.ant.tasks.ServerTask @see com.perforce.ant.tasks.ClientTask @see com.perforce.ant.tasks.SyncTask @see com.perforce.ant.tasks.ChangeTask @see com.perforce.ant.tasks.EditTask @see com.perforce.ant.tasks.SubmitTask @see com.perforce.ant.tasks.HaveTask @see com.perforce.ant.tasks.LabelTask @see com.perforce.ant.tasks.LabelsyncTask @see com.perforce.ant.tasks.CounterTask @see com.perforce.ant.tasks.ReopenTask @see com.perforce.ant.tasks.RevertTask @see com.perforce.ant.tasks.AddTask @see com.perforce.ant.tasks.DeleteTask @see com.perforce.ant.tasks.IntegrateTask @see com.perforce.ant.tasks.ResolveTask @see com.perforce.ant.tasks.FstatTask @see com.perforce.ant.tasks.ChangesTask @see com.perforce.ant.tasks.Diff2Task @see com.perforce.ant.tasks.FilesTask @see com.perforce.ant.tasks.FixTask @see com.perforce.ant.tasks.GrepTask @see com.perforce.ant.tasks.JobTask @see com.perforce.ant.tasks.JobsTask @see com.perforce.ant.tasks.LockTask @see com.perforce.ant.tasks.UnlockTask @see com.perforce.ant.tasks.MoveTask @see com.perforce.ant.tasks.ShelveTask @see com.perforce.ant.tasks.UnshelveTask @see com.perforce.ant.tasks.TagTask

@author Perforce Open Source Community