com.perforce.p4java.core
Interface ILabel

All Superinterfaces:

ILabelSummary, IServerResource

All Known Implementing Classes:

Label

public interface ILabel
extends ILabelSummary

Defines and describes a Perforce label. See the main Perforce documentation for label usage and semantics.

ILabel objects are complete and updateable only if they come from the IServer.getLabel() method (or are hand-crafted); label objects from other sources are not complete or completable, and nor are they refreshable. Setter methods defined below affect only local values unless a suitable update is done.

getViewMapping

ViewMap<ILabelMapping> getViewMapping()

Get the view mapping for this label. Note that only the left hand side (the depot path) of a mapping is used for labels and will be valid here.

Note also that this method will only return the actual view mapping a label if the label object was returned from the IServer's getLabel() method (this is due to limitations in the underlying implementation).

Returns:

non-null but possibly empty list of IClientViewMapping mappings for this label.

setViewMapping

void setViewMapping(ViewMap<ILabelMapping> viewMapping)

Set the view mapping for this label. Note that only the left hand side (the depot path) of a mapping is used for labels and will be valid here.

Parameters:

viewMapping - list of IClientViewMapping mappings for this label.

updateOnServer

String updateOnServer()
                      throws ConnectionException,
                             RequestException,
                             AccessException

Deprecated. use update() instead.

Update (or even create) this label on the associated Perforce server, if that server has been set for this label. Will throw a suitable RequestException if the label is not associated with a server, either as the result of being returned from a server earlier, or as the result of an explicit call on the underlying implementation object.

Note that you should only call this method on "full" labels, i.e. those returned from an explicit single call to IServer.getLabel() or those created by hand; calling this on a label returned from the getLabelList() method may cause the associated in-server label to lose its view mapping.

Returns:

the string message resulting from the update

Throws:

ConnectionException - if the Perforce server is unreachable or is not connected.

RequestException - if the Perforce server encounters an error during its processing of the request

AccessException - if the Perforce server denies access to the caller

update

void update()
            throws ConnectionException,
                   RequestException,
                   AccessException

Update (or even create) this label on the associated Perforce server, if that server has been set for this label. Will throw a suitable RequestException if the label is not associated with a server, either as the result of being returned from a server earlier, or as the result of an explicit call on the underlying implementation object.

Note that you should only call this method on complete labels, i.e. those returned from an explicit single call to IServer.getLabel() or those created by hand; calling this on a label returned from the getLabelList() method will result in a UnimplementedError being thrown.

Specified by:

update in interface IServerResource

Throws:

ConnectionException - if the Perforce server is unreachable or is not connected.

RequestException - if the Perforce server encounters an error during its processing of the request

AccessException - if the Perforce server denies access to the caller

getServer

IServer getServer()

Get the Perforce server object associated with this label.

Returns:

possibly-null IServer object associated with this label.

setServer

void setServer(IServer server)

Set the Perforce server object associated with this label.

Specified by:

setServer in interface IServerResource

Parameters:

server - possibly-null IServer object to be associated with this label.