===About This Project=== ==Content== {{DepotPath|//public/perforce/api/java/p4package/|Source}}, {{DepotFile|//public/perforce/api/java/p4package/docs/index.html|documentation}}, and {{DepotFile|//public/perforce/api/java/p4package/dist/p4.jar|JAR}} for P4Package, a high-level Java API wrapper 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. ==Curator== Sivananda Poreddy and David Markley. Please email [mailto:srporeddy@yahoo.com srporeddy@yahoo.com] or [mailto:plusdavid@yahoo.com plusdavid@yahoo.com] if you have submitted contributions you'd like published, have ideas for enhancement, or have preferences among the potential enhancements listed below. ==Important status update (11/11/2010)== This project no longer has active development. Most of the recent changes are bug fixes, and addition of new examples. Although this project is simple and easy to use, we recommend the new users to try the new official perforce Java API located at http://www.perforce.com/perforce/doc.current/manuals/p4java/index.html. This has the active development and support from perforce ==Getting Started== Take a look at the {{DepotFile|//public/perforce/api/java/p4package/examples/index.html|examples}} and {{DepotFile|//public/perforce/api/java/p4package/docs/index.html|API documentation}}. These should help you get an idea of how to use the package. To build the examples, you must: * Download the latest {{DepotFile|//public/perforce/api/java/p4package/dist/p4.jar|JAR}} file and put it on your CLASSPATH. * Download all the .java files and the p4.properties file. * Modify the p4.properties file to fit your environment. * Modify the example .java files to fit your needs. * Compile all the .java files using 'javac *.java' * Execute an example with something like 'java ListUsers' ==Related Projects== These projects are built upon this Java API (Not tested with the latest jar though, and the code base is old. Use with caution) * [[Perforce JSP|p4jsp]] - a JSP based web application for browsing and interacting with Perforce. * [[Perforce Java Reviewer|Java Reviewer]] - an extensible Java based Perforce reviewer. ==Project Updates== {| cellspacing=0 |- | '''Date''' | '''Update''' |- class=zebra | November 5, 2001 | * Initial publication of P4Package. |- | December 4, 2001 | * Added some {{DepotFile|//public/perforce/api/java/p4package/examples/index.html|example code}}. * Added a server timeout threshold to the P4Process and Env classes. |- class=zebra | January 15, 2002 | *Added more {{DepotFile|//public/perforce/api/java/p4package/examples/index.html|example code}}. *Added the Counter class. *Corrected the filelog methods for the FileEntry class. |- | August 5, 2002 | * Fixed the Label class to report all labels properly. * Fixed the JobField class to load field information correctly. * Fixed the Job class to list all jobs, and to correctly identify fixes. |- class=zebra | January 28, 2008 | * Added ability to return the files in a label, given a label name. * Added the ability to check for the possibility of integration on a given branch/project. The checks include permission, no destination, etc. * Fixed the method signature problem in comments for java doc purpose. * Changed the integration options syntax to comply with recent versions of Perforce server. * Added the Group class to map the group concept in Perforce. |- class=zebra | February 21, 2010 | * Added support for ticket based authentication. * Fixed a small bug with DirEntry class. |- class=zebra | November 11, 2010 | * Added few more useful exmaples. * This might be the last change on this project. Users are encouraged to use the new official perforce Java API available at http://www.perforce.com/perforce/doc.current/manuals/p4java/index.html |} __NOTOC__ [[Category:Perforce Java APIs]] [[Category: Java]]