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.