com.starteam.events

Class CheckinEvent

java.lang.Object

java.util.EventObject

com.starteam.events.CheckinEvent

All Implemented Interfaces:

java.io.Serializable

public final class CheckinEvent
extends java.util.EventObject

An event triggered whenever a file is checked in through CheckinManager.

See Also:

CheckinListener, CheckinManager.addCheckinListener(com.starteam.events.CheckinListener), Serialized Form

Method Summary

Modifier and Type	Method and Description
CheckinManager	getCheckinManager() Gets the CheckinManager that triggered this CheckinEvent.
File.CheckInResult	getCheckinResult() Gets details describing the result of this checkin.
File	getCurrentFile() Gets the StarTeam File being checked in.
java.io.File	getCurrentWorkingFile() Gets the working file on disk where this file is being checked in from.
java.lang.Throwable	getError() The error that occurred during the checkin of this file.
java.lang.String	getErrorMessage() The error message for the error that occurred during the checkin of this file.
CheckinOptions	getOptions() Gets the checkin options that apply to the current file.
boolean	isCanceled() Indicates whether or not the overall checkin operation has been canceled.
boolean	isFinished() Indicates whether or not the checkin operation for this file is finished.
boolean	isSuccessful() Indicates whether or not the checkin operation for this file has finished successfully.
void	setCurrentWorkingFile(java.io.File workingFile) Sets the working file on disk where this file is being checked in from.
java.lang.String	toString() Returns a String representation of this CheckinEvent (useful for debugging).

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getCheckinManager

public CheckinManager getCheckinManager()

Gets the CheckinManager that triggered this CheckinEvent.

Returns:

The CheckinManager that triggered this CheckinEvent.

See Also:

CheckinManager

getOptions

public CheckinOptions getOptions()

Gets the checkin options that apply to the current file.

To override any of the options for the current file, change them in the onStartFile event handler.

Returns:

The checkin options that apply to the current file.

See Also:

CheckinOptions, CheckinListener.startFile(com.starteam.events.CheckinEvent)

getCurrentFile

public File getCurrentFile()

Gets the StarTeam File being checked in.

Returns:

The StarTeam File being checked in.

See Also:

File

getCurrentWorkingFile

public java.io.File getCurrentWorkingFile()

Gets the working file on disk where this file is being checked in from.

Returns:

The working file on disk where this file is being checked in from, or null if this file is being checked in from a the default path.

setCurrentWorkingFile

public void setCurrentWorkingFile(java.io.File workingFile)

Sets the working file on disk where this file is being checked in from.

Parameters:

workingFile - The working file on disk where this file is being checked in from. The working file may be changed in the onStartFile event handler.

See Also:

CheckinListener.startFile(com.starteam.events.CheckinEvent)

isFinished

public boolean isFinished()

Indicates whether or not the checkin operation for this file is finished.

Returns:

true if the checkin operation for this file is finished; false if it is still in progress. Note that the checkin may have finished, but unsuccessfully.

See Also:

CheckinEvent.isSuccessful()

isCanceled

public boolean isCanceled()

Indicates whether or not the overall checkin operation has been canceled.

Returns:

true if the checkin operation has been canceled (for all remaining files), and false otherwise.

isSuccessful

public boolean isSuccessful()

Indicates whether or not the checkin operation for this file has finished successfully.

Returns:

true if the checkin operation for this file has finished successfully; false if the checkin is still in progress, or if it finished with an error.

See Also:

CheckinEvent.isFinished(), CheckinEvent.getError(), CheckinEvent.getCheckinResult()

getCheckinResult

public File.CheckInResult getCheckinResult()

Gets details describing the result of this checkin.

Returns:

Details describing the result of this checkin, or null if the checkin of this file is still in progress or finished with an error.

See Also:

File.CheckInResult, CheckinEvent.isFinished(), CheckinEvent.isSuccessful()

getError

public java.lang.Throwable getError()

The error that occurred during the checkin of this file.

Returns:

The error describing the reason for failure of this checkin, if the checkin finished with an error, or null otherwise.

See Also:

CheckinEvent.isFinished(), CheckinEvent.isSuccessful()

getErrorMessage

public java.lang.String getErrorMessage()

The error message for the error that occurred during the checkin of this file.

Returns:

The error message for the error describing the reason for failure of this checkin, if the checkin finished with an error, or empty string otherwise.

See Also:

CheckinEvent.isFinished(), CheckinEvent.isSuccessful()

toString

public java.lang.String toString()

Returns a String representation of this CheckinEvent (useful for debugging).

Overrides:

toString in class java.util.EventObject

Returns:

a String representation of this CheckinEvent.