com.perforce.p4java.impl.mapbased.server.cmd

Class ClientDelegator

java.lang.Object

com.perforce.p4java.impl.mapbased.server.cmd.BaseDelegator

com.perforce.p4java.impl.mapbased.server.cmd.ClientDelegator

All Implemented Interfaces:

IClientDelegator

public class ClientDelegator
extends BaseDelegator
implements IClientDelegator

Since:

15/09/2016

Author:

Sean Shou

Field Summary

Fields inherited from class com.perforce.p4java.impl.mapbased.server.cmd.BaseDelegator

MAX_LIMIT_SUPPORTED_MIN_VERSION, QUERY_EXPRESSIONS_SUPPORTED_MIN_VERSION, USER_RESTRICTIONS_SUPPORTED_MIN_VERSION

Constructor Summary

Constructors

Constructor and Description
ClientDelegator(IOptionsServer server)

Method Summary

Modifier and Type	Method and Description
String	createClient(IClient newClient)
String	deleteClient(String clientName, boolean force)
String	deleteClient(String clientName, DeleteClientOptions opts) Delete a Perforce client from a Perforce server.
IClient	getClient(IClientSummary clientSummary)
IClient	getClient(String clientName)
IClient	getClientTemplate(String clientName)
IClient	getClientTemplate(String clientName, boolean allowExistent)
IClient	getClientTemplate(String clientName, GetClientTemplateOptions getClientTemplateOptions) Get a template of a non-existent named Perforce client.
String	switchClientView(String templateClientName, String targetClientName, SwitchClientViewOptions opts) Switch the target client spec's view without invoking the editor.
String	switchStreamView(String streamPath, String targetClientName, SwitchClientViewOptions opts) Switch the target client spec's view without invoking the editor.
String	updateClient(IClient client)
String	updateClient(IClient client, boolean force) Update an existing Perforce client on the current Perforce server.
String	updateClient(IClient client, UpdateClientOptions opts) Update an existing Perforce client on the current Perforce server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClientDelegator

public ClientDelegator(IOptionsServer server)

Method Detail

getClient

public IClient getClient(String clientName)
                  throws ConnectionException,
                         RequestException,
                         AccessException

Specified by:

getClient in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

getClient

public IClient getClient(@Nonnull
                         IClientSummary clientSummary)
                  throws ConnectionException,
                         RequestException,
                         AccessException

Specified by:

getClient in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

getClientTemplate

public IClient getClientTemplate(String clientName)
                          throws ConnectionException,
                                 RequestException,
                                 AccessException

Specified by:

getClientTemplate in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

getClientTemplate

public IClient getClientTemplate(String clientName,
                                 boolean allowExistent)
                          throws ConnectionException,
                                 RequestException,
                                 AccessException

Specified by:

getClientTemplate in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

getClientTemplate

public IClient getClientTemplate(@Nonnull
                                 String clientName,
                                 GetClientTemplateOptions getClientTemplateOptions)
                          throws P4JavaException

Get a template of a non-existent named Perforce client. This will only return an IClient for clients that don't exist unless the allowExistent parameter is set to true. This method is designed to be able to get the server returned default values it uses when a non-existent client is requested.

Specified by:

getClientTemplate in interface IClientDelegator

Parameters:

clientName - Not blank Perforce client name.

getClientTemplateOptions - GetClientTemplateOptions object describing optional parameters; if null, no options are set.

Returns:

IClient representing the specified Perforce client template, or null if no such client template.

Throws:

P4JavaException - if any error occurs in the processing of this method.

createClient

public String createClient(@Nonnull
                           IClient newClient)
                    throws ConnectionException,
                           RequestException,
                           AccessException

Specified by:

createClient in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

updateClient

public String updateClient(@Nonnull
                           IClient client)
                    throws ConnectionException,
                           RequestException,
                           AccessException

Specified by:

updateClient in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

updateClient

public String updateClient(@Nonnull
                           IClient client,
                           boolean force)
                    throws ConnectionException,
                           RequestException,
                           AccessException

Update an existing Perforce client on the current Perforce server. This client does not need to be the current client, and no association with the passed-in client is made by the server (i.e. it's not made the current client).

Specified by:

updateClient in interface IClientDelegator

Parameters:

client - non-null IClient defining the Perforce client to be updated

force - if true, tell the server to attempt to force the update regardless of the consequences. You're on your own with this one...

Returns:

possibly-null operation result message string from the Perforce server

Throws:

RequestException - if any error occurs in the processing of this method.

ConnectionException

AccessException

updateClient

public String updateClient(@Nonnull
                           IClient client,
                           UpdateClientOptions opts)
                    throws P4JavaException

Update an existing Perforce client on the current Perforce server. This client does not need to be the current client, and no association with the passed-in client is made by the server (i.e. it's not made the current client).

Specified by:

updateClient in interface IClientDelegator

Parameters:

client - non-null IClient defining the Perforce client to be updated

opts - UpdateClientOptions object describing optional parameters; if null, no options are set.

Returns:

possibly-null operation result message string from the Perforce server

Throws:

P4JavaException - if any error occurs in the processing of this method.

deleteClient

public String deleteClient(String clientName,
                           boolean force)
                    throws ConnectionException,
                           RequestException,
                           AccessException

Specified by:

deleteClient in interface IClientDelegator

Throws:

ConnectionException

RequestException

AccessException

deleteClient

public String deleteClient(String clientName,
                           DeleteClientOptions opts)
                    throws P4JavaException

Delete a Perforce client from a Perforce server. The effects this has on the client and the server are not well-defined here, and you should probably consult the relevant Perforce documentation for your specific case. In any event, you can cause quite a lot of inconvenience (and maybe even damage) doing a forced delete without preparing properly for it, especially if the client is the server object's current client.

Specified by:

deleteClient in interface IClientDelegator

Parameters:

clientName - non-null name of the client to be deleted from the server.

opts - DeleteClientOptions object describing optional parameters; if null, no options are set.

Returns:

possibly-null operation result message string from the Perforce server.

Throws:

P4JavaException - if any error occurs in the processing of this method.

switchClientView

public String switchClientView(String templateClientName,
                               String targetClientName,
                               SwitchClientViewOptions opts)
                        throws P4JavaException

Switch the target client spec's view without invoking the editor. With -t to switch to a view defined in another client spec. Switching views is not allowed in a client that has opened files. The -f flag can be used with -s to force switching with opened files. View switching has no effect on files in a client workspace until 'p4 sync' is run.

Specified by:

switchClientView in interface IClientDelegator

Parameters:

templateClientName - non-null name of the template client who's view will be used for the target (or current) client to switched to.

targetClientName - possibly-null name of the target client whose view will be changed to the template client's view. If null, the current client will be used.

opts - SwitchClientViewOptions object describing optional parameters; if null, no options are set.

Returns:

possibly-null operation result message string from the Perforce server

Throws:

P4JavaException - if any error occurs in the processing of this method.

switchStreamView

public String switchStreamView(String streamPath,
                               String targetClientName,
                               SwitchClientViewOptions opts)
                        throws P4JavaException

Switch the target client spec's view without invoking the editor. With -S to switch to the specified stream's view. Switching views is not allowed in a client that has opened files. The -f flag can be used with -s to force switching with opened files. View switching has no effect on files in a client workspace until 'p4 sync' is run.

Specified by:

switchStreamView in interface IClientDelegator

Parameters:

streamPath - non-null stream's path in a stream depot, of the form //depotname/streamname who's view will be used for the target (or current) client to switched to.

targetClientName - possibly-null name of the target client whose view will be changed to the stream's view. If null, the current client will be used.

opts - SwitchClientViewOptions object describing optional parameters; if null, no options are set.

Returns:

possibly-null operation result message string from the Perforce server

Throws:

P4JavaException - if any error occurs in the processing of this method.