com.starbase.starteam
Class CheckinEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--com.starbase.starteam.CheckinEvent

All Implemented Interfaces:

java.io.Serializable

public class CheckinEvent

extends java.util.EventObject

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

See Also:

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

Method Summary

boolean	equals(java.lang.Object source) returns true if this object instance is equal to the source
CheckinManager	getCheckinManager() Gets the CheckinManager that triggered this CheckinEvent.
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.
java.lang.Object	getSource() The object on which the Event initially occurred.
int	hashCode() returns a unique hash for all instances of this type
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() Gets a short description of this Event.

Methods inherited from class java.lang.Object

getClass, 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.onStartFile(com.starbase.starteam.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.onStartFile(com.starbase.starteam.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 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:

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()

getSource

public java.lang.Object getSource()

The object on which the Event initially occurred.

Overrides:

getSource in class java.util.EventObject

Returns:

The object on which the Event initially occurred.

toString

public java.lang.String toString()

Gets a short description of this Event.

Overrides:

toString in class java.util.EventObject

Returns:

A short description of this Event.

equals

public boolean equals(java.lang.Object source)

returns true if this object instance is equal to the source

Overrides:

equals in class java.lang.Object

Parameters:

source - Object the source to comapre with

Returns:

boolean true if this object is equal to the source

hashCode

public int hashCode()

returns a unique hash for all instances of this type

Overrides:

hashCode in class java.lang.Object

Returns:

int a unique hash for all instances of this type