Perforce

com.perforce.api
Class Client

java.lang.Object
  |
  +--com.perforce.api.SourceControlObject
        |
        +--com.perforce.api.Mapping
              |
              +--com.perforce.api.Client
All Implemented Interfaces:
Cacheable

public final class Client
extends Mapping

Representation of a source control client. This class can be used to retrieve and hold p4 client information. It's class methods can be used to list all loaded clients or list those beginning with a particular prefix. Before these class methods are called, the class method loadClients() must be called to ensure the client list is up to date.

Version:
$Date: 2001/11/02 $ $Revision: #1 $
Author:
David Markley

Constructor Summary
Client()
          Default no-argument constructor.
Client(String name)
          Constructor that is passed the client name.
 
Method Summary
 void commit()
          Stores this object back into Perforce, creating it if it didn't already exist.
 HashDecay getCache()
           
static Client getClient(Env env, String name)
          Returns a Client with the specified name, or null if not found.
static Client getClient(String name)
           
static Enumeration getClients(Env env)
          Returns a list of all the clients currently loaded.
 String getOptions()
          Returns the Client options.
 String getRoot()
          Returns the Client root.
static void loadClients()
          Loads a list of all the clients into an internal class Hashtable.
static void loadClients(Env env)
           
static Enumeration lookupClient(Env env, String prefix)
          Returns a list of clients that begin with the specified prefix.
static Enumeration lookupClient(String prefix)
          Returns a list of clients that begin with the specified prefix.
static void main(String[] argv)
           
 void setOptions(String options)
          Sets the options for the Client.
 void setRoot(String root)
          Sets the root for the Client.
 void store()
          Stores the client information back into p4, creating the client if it didn't already exist.
 void sync()
          Brings this object back into sync with Perforce.
 void sync(String name)
          Synchronizes the Client with the latest information from P4.
 
Methods inherited from class com.perforce.api.Mapping
addView, addView, getDescription, getName, getOwner, getView, getViews, lookupMappings, setDescription, setName, setOwner, toString, toXML
 
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

Client

public Client()
Default no-argument constructor.

Client

public Client(String name)
Constructor that is passed the client name.
Method Detail

commit

public void commit()
            throws CommitException
Description copied from class: SourceControlObject
Stores this object back into Perforce, creating it if it didn't already exist.
Overrides:
commit in class Mapping

getCache

public HashDecay getCache()
Overrides:
getCache in class SourceControlObject

getClient

public static Client getClient(Env env,
                               String name)
Returns a Client with the specified name, or null if not found. It is important to keep in mind that the Client returned may not hold valid information, other than its name. To ensure the Client has valid information, the sync() method must be called.
Parameters:
name - Name of the client to find.

getClient

public static Client getClient(String name)

getClients

public static Enumeration getClients(Env env)
Returns a list of all the clients currently loaded.
Returns:
List of all clients currently loaded.

getOptions

public String getOptions()
Returns the Client options.

getRoot

public String getRoot()
Returns the Client root.

loadClients

public static void loadClients()
Loads a list of all the clients into an internal class Hashtable. This method will only be called by the class itself if the Hashtable is empty. Users should call this method if they believe the p4 client information needs to be brought up to date.
See Also:
Hashtable

loadClients

public static void loadClients(Env env)

lookupClient

public static Enumeration lookupClient(Env env,
                                       String prefix)
Returns a list of clients that begin with the specified prefix.
Parameters:
env - P4 environment to use.
prefix - Prefix for all clients to be returned.
Returns:
List of clients matching the prefix.

lookupClient

public static Enumeration lookupClient(String prefix)
Returns a list of clients that begin with the specified prefix.
Parameters:
prefix - Prefix for all clients to be returned
Returns:
List of clients matching the prefix.

main

public static void main(String[] argv)

setOptions

public void setOptions(String options)
Sets the options for the Client.
Parameters:
options - Options of the client.

setRoot

public void setRoot(String root)
Sets the root for the Client.
Parameters:
root - Root of the client.

store

public void store()
           throws CommitException
Stores the client information back into p4, creating the client if it didn't already exist.

sync

public void sync()
Description copied from class: SourceControlObject
Brings this object back into sync with Perforce.
Overrides:
sync in class SourceControlObject

sync

public void sync(String name)
Synchronizes the Client with the latest information from P4. This method forces the Client to contain the latest, correct information if it didn't already.
Overrides:
sync in class Mapping
Parameters:
name - Name of the Client to synchronize.

Perforce

Copyright © 2001, Perforce Software, All rights reserved.