index.html #6

<HTML>
<HEAD>
<TITLE>P4Package - Java API Project</TITLE>
</HEAD>

<BODY BGCOLOR="#FFFFFF"><CENTER>
<P>
<A NAME="toc"></A>
<h2>
<sub><a href="http://public.perforce.com/public/index.html">Perforce Public Depot</a></sub><br>
P4Package - Java API Project<br>
<sub>com.perforce.api.*</sub>
</H2>
<P>

<TABLE BORDER=0><TR><TD>
<B><UL>
<LI><A HREF="#about">About This Project</A>
<LI><A href="http://public.perforce.com:8080/@ra=s@/public/perforce/api/java/p4package/">Source Files</A>
<LI><A href="http://public.perforce.com/public/perforce/api/java/p4package/dist/p4.jar">JAR File</A>
<LI><A HREF="http://public.perforce.com/public/perforce/api/java/p4package/docs/index.html">API Documentation</A>
</UL></B></TD>
<TD><B><UL>
<LI><A HREF="http://public.perforce.com/public/perforce/api/java/p4package/examples/index.html">Examples</A>
<LI><A HREF="http://public.perforce.com/public/perforce/api/java/p4package/README.TXT">README.TXT</A>
<LI><A HREF="http://public.perforce.com/public/perforce/api/java/p4package/LICENSE.TXT">LICENSE.TXT</A>
<LI><A HREF="#updates">Project Updates</A>
</UL></B>
</TABLE>
</CENTER>

<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>

<A NAME="about"></A>
<H2>About This Project
</H2>

<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>
<p>
<table cellpadding=5%>
<tr><td align="right" valign=top><b>Content</b></td>
<td valign=top>
<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>
<A href="http://www.perforce.com/perforce/conf2000/bios2000.html#money">$cott Money</A> and <A href="http://www.perforce.com/perforce/conf2000/bios2000.html#markley">I</A> presented a paper that discussed some of the tools built on these classes during the <A href="http://www.perforce.com/perforce/conference.html">2000 Perforce User Conference</A>. It only took a year to make these available. Sorry for the wait. I promise to ensure any contributions are incorporated quickly.
</td></tr>
<tr><td align="right" valign=top><b>Curator</b></td>
<td valign=top>
David Markley. Please email <a href="mailto:david@markley.cc">david@markley.cc</a> if you have submitted contributions you'd like published, if you have ideas for enhancement, or if you have preferences among the potential enhancements listed below.
</td></tr>
<tr><td align="right" valign=top nowrap><b>Getting Started</b></td>
<td valign=top>
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:
<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></td></tr>
<tr><td align="right" valign=top nowrap><b>Related Projects</b></td><td>
These projects are built upon this Java API.
<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></td></tr>

</table>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%><TR><TD BGCOLOR=FFCC66>
<A NAME="updates"></A>
<H2>Project Updates</H2>

<TD WIDTH=5% BGCOLOR=FFCC66 ALIGN=RIGHT><FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</TABLE>
<!------------------------------------------------------------------>
<table cellpadding=5%>
<thead><tr><th valign=top>Date</th><th valign=top>Update</th></tr></thead>
<tbody>
<tr><td valign=top><b>November 5, 2001</b></td><td valign=top>
Initial publication of P4Package.
</td></tr>
<tr><td valign=top><b>December 4, 2001</b></td><td valign=top>
<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><td valign=top><b>January 15, 2002</b></td><td valign=top>
<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>
<tr><td valign=top><b>August 5, 2002</b></td><td valign=top>
<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>
</tbody></table>
<br><br>
<!------------------------------------------------------------------>
<P>
<TABLE CELLSPACING=0 BORDER=0 WIDTH=100%>
<TR>

<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=LEFT VALIGN=CENTER>
<FONT SIZE="-2">
Copyright &copy;<br>
2001<br>
<a href="http://www.perforce.com">Perforce Software</a><br>
</FONT>
</TD>

<TD WIDTH=70% BGCOLOR=FFCC66 ALIGN=CENTER>
<FONT SIZE="-2">
You're browsing a file stored as<br> 
<code>$Id: //public/perforce/api/index.html#6 $</code><br> 
in the 
<A HREF=http://public.perforce.com/public/index.html>Perforce Public Depot</A>.
</FONT>
</TD>

<TD WIDTH=15% BGCOLOR=FFCC66 ALIGN=RIGHT>
<FONT SIZE="-2"><A HREF="#toc">
Back to<BR>Table of<BR>Contents</A></TD></TR>
</FONT>
</TD>

</TR>
</TABLE>
<!------------------------------------------------------------------>
</BODY>
#	Change	User	Description
#6	2001	David Markley	Updated package documentation.
#5	1997	David Markley	Improved ability to sort results and fixed Label class.
#4	1335	David Markley	Corrected the documentation.
#3	1332	David Markley	Added more example code. Added the Counter class. Corrected the filelog methods for the FileEntry class.
#2	1151	David Markley	Added the exampes web page.
#1	1044	David Markley	Added index file for the public website.