<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>Perforce Public Depot: Utilities Project</title>
<!-- no htdig-keywords tag in this file -->
<!-- no keywords tag in this file -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="../../../../css/pure.css" type="text/css">
<link rel="stylesheet" href="../../../../css/depot.css" type="text/css">
</head>
<body>
<!-- div for entire page -->
<div id="outer">
<div id="page-top"><!-- frames the logo and search -->
<!-- logo -->
<div id="logo">
<a href="http://www.perforce.com"><img src="../../../../images/site_logo.gif" alt="Perforce Public Depot" width="219" height="50"></a>
</div>
<div id="search"><!-- search section -->
<form method="get" action="http://www.google.com/search">
<div><!-- needed so invisible field will validate -->
<input type="hidden" name="sitesearch" value="public.perforce.com">
</div><!-- silly invisible field div -->
<ul class="search-box">
<li class="left"><input type="text" size="40" name="q" value="" class="search-form"></li>
<li class="middle"><input type="submit" value="Search" class="search-button"></li>
<li class="right" style="color: black;">Powered by Google</li>
</ul>
</form><!-- top navbar search form -->
</div><!-- end search section -->
</div> <!-- end div id page-top -->
<!-- start site content -->
<div id="main-body">
<!-- navbars -->
<div id="navbar-outer">
<ul class="navbar">
<li class="nav-top"><a href="../../../../index.html" title="Home">Public Depot Home</a></li>
<li><a href="../../../../sitemap.html" title="Project Tree">Project Tree</a></li>
<!-- li><a href="search.html" title="Search">Search</a></li -->
<li><a href="../../../../browse.html" title="How to Browse" >Browse</a></li>
<li><a href="../../../../contribute.html" title="How to Contribute">Contribute</a></li>
<!-- li><a href="review.html" title="Change Review Email">Change Review Email</a></li -->
</ul>
</div>
<!-- end id.navbars -->
<div id="content">
<!-- Content starts here -->
<h1>Perforce Utilities Project</h1>
<p>
[<i>This project page is deprecated. Please use the
<a href="http://public.perforce.com/wiki/Perforce_Java_API">Public Depot Wiki version</a>.</i>]</p>
<!-- ABOUT THIS PROJECT -->
<a name="about"></a>
<h3>About This Project</h3>
<dl class="project">
<dt>Content
</dt>
<dd>
<p><a href="http://public.perforce.com:8080/@ra=s@/public/perforce/api/java/p4package/">Source</a>, <a href="http://public.perforce.com/public/perforce/api/java/p4package/docs/index.html">documentation</a>, and <a href="http://public.perforce.com/public/perforce/api/java/p4package/dist/p4.jar">JAR</a> for P4Package, a high-level Java API for Perforce. These classes provide a way to encapsulate source control objects like branches, files, users, etc. I've had a lot of success building tools and scripts based on these classes. Because of the encapsulation, maintenance is much simpler. When perforce changes, only these underlying classes need to be updated.
</p>
</dd>
<dt>Curators</dt>
<dd>
<p>David Markley and Sivananda Poreddy. Please email <a href="mailto:[email protected]">[email protected]</a> and <a href="mailto:[email protected]">[email protected]</a> if you have submitted contributions you'd like published, have ideas for enhancement, or have preferences among the potential enhancements listed below.
</p>
</dd>
<dt>Getting Started</dt>
<dd>
<p>
Take a look at the <a href="http://public.perforce.com/public/perforce/api/java/p4package/examples/index.html">examples</a> and <a href="http://public.perforce.com/public/perforce/api/java/p4package/docs/index.html">API documentation</a>. These should help you get an idea of how to use the package. To build the examples, you must:</p>
<ul>
<li>Download the latest <a href="http://public.perforce.com/public/perforce/api/java/p4package/dist/p4.jar">JAR</a> file and put it on your CLASSPATH.</li>
<li>Download all the .java files and the p4.properties file.</li>
<li>Modify the p4.properties file to fit your environment.</li>
<li>Modify the example .java files to fit your needs.</li>
<li>Compile all the .java files using 'javac *.java'</li>
<li>Execute an example with something like 'java ListUsers'</li>
</ul>
</dd>
<dt>Related Projects</dt>
<dd>
<p>
These projects are built upon this Java API.
</p>
<ul>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4jsp/index.html">p4jsp</a> - a JSP based web application for browsing and interacting with Perforce.</li>
<li><a href="http://public.perforce.com/public/perforce/utils/reviewd/reviewer/index.html">Java Reviewer</a> - an extensible Java based Perforce reviewer.</li>
</ul>
</dd>
</dl>
<div class="hr-dotted"></div>
<!-- QUICKLINKS -->
<div class="quickLinks">
<ul>
<li><a href="http://public.perforce.com:8080/@ra=s@/public/perforce/api/java/p4package/">Source<br>Files</a></li>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4package/dist/p4.jar">JAR<br>File</a></li>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4package/docs/index.html">API<br>Documentation</a></li>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4package/examples/index.html">Examples</a></li>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4package/README.TXT">README.TXT</a></li>
<li><a href="http://public.perforce.com/public/perforce/api/java/p4package/LICENSE.TXT">LICENSE.TXT</a></li>
<li><a href="#updates">Project<br>Updates</a></li>
</ul>
</div>
<!-- PROJECT UPDATES-->
<a name="updates"></a>
<h3>Project Updates</h3>
<table class="project updates" cellspacing="0">
<tr>
<th>Date</th>
<th>Update</th>
</tr>
<tr class="zebra">
<td>
November 5, 2001
</td>
<td>
Initial publication of P4Package.
</td>
</tr>
<tr>
<td>
December 4, 2001
</td>
<td>
<ul>
<li>Added some <a href="http://public.perforce.com/public/perforce/api/java/p4package/examples/index.html">example code</a>.</li>
<li>Added a server timeout threshold to the P4Process and Env classes.</li>
</ul>
</td>
</tr>
<tr class="zebra">
<td>
January 15, 2002
</td>
<td>
<ul>
<li>Added more <a href="http://public.perforce.com/public/perforce/api/java/p4package/examples/index.html">example code</a>.</li>
<li>Added the Counter class.</li>
<li>Corrected the filelog methods for the FileEntry class.</li>
</ul>
</td>
<tr>
<td>
August 5, 2002
</td>
<td>
<ul>
<li>Fixed the Label class to report all labels properly.</li>
<li>Fixed the JobField class to load field information correctly.</li>
<li>Fixed the Job class to list all jobs, and to correctly identify fixes.</li>
</ul>
</td>
<tr class="zebra">
<td>
January 28, 2008
</td>
<td>
<ul>
<li>Added ability to return the files in a label, given a label name.</li>
<li>Added the ability to check for the possibility of integration on
a given branch/project. The checks include permission, no destination, etc.</li>
<li>Fixed the method signature problem in comments for java doc purpose.</li>
<li>Changed the integration options syntax to comply with recent versions
of Perforce server.</li>
<li>Added the Group class to map the group concept in Perforce.</li>
</ul>
</td>
</table>
<div class="hr-dotted"></div>
<!-- Content ends here -->
</div><!-- id content -->
</div><!-- id main-body -->
<!-- Copyright and bottom bar -->
<div id="copyright">
Copyright © 1996, 2006 Perforce
</div>
</div> <!-- id outer -->
</body>
</html>
| # | Change | User | Description | Committed | |
|---|---|---|---|---|---|
| #5 | 6474 | Sivananda Poreddy | Removing some old information | ||
| #4 | 6432 | Sivananda Poreddy | Checkin right copy based on public version | ||
| #3 | 6431 | Sivananda Poreddy | Few touches | ||
| #2 | 6430 | Sivananda Poreddy | Change the references to email, fix obsolete/redundant information | ||
| #1 | 5992 | Sivananda Poreddy | Creating my own branch from original base | ||
| //public/perforce/api/java/p4package/index.html | |||||
| #6 | 2002 | David Markley | Integrated the latest changes for p4package to the public depot. | ||
| #5 | 1808 | David Markley |
Updated Env class and fixed fstat issues. Published new Javadocs. |
||
| #4 | 1336 | David Markley | Corrected web page documentation. | ||
| #3 | 1334 | David Markley |
Added more example code. Added the Counter class. Corrected the filelog methods for the FileEntry class. |
||
| #2 | 1152 | David Markley | Added the examples page. | ||
| #1 | 1045 | David Markley | Integrated the index page to the public site. | ||
| //guest/david_markley/p4package/index.html | |||||
| #1 | 1044 | David Markley | Added index file for the public website. | ||