Package se.conciliate.extensions.store

Class MTRemoteChangeException

java.lang.Object

java.lang.Throwable

java.lang.Exception

se.conciliate.extensions.store.MTRemoteChangeException

All Implemented Interfaces:

Serializable

public class MTRemoteChangeException
extends Exception

Thrown when a direct update request (save(), remove()) fails because the object is out of date or because the object to update is currently being updated by someone else.

Author:

Per-Erik

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final int	ALREADY_CHANGING	Error code that idicates that a change failed due to someone else making changes to the object.
static final int	OUT_OF_DATE	Error code that indicates that a change failed due to the changed object being out of date.

Constructor Summary

Constructors

Constructor	Description
MTRemoteChangeException(int cause, String user, String userFullName, String dataObjectName, long dataObjectID, boolean isModel)

Method Summary

Modifier and Type	Method	Description
int	getChangeCause()	Returns either OUT_OF_DATE or ALREADY_CHANGING depending on the reported cause of the exception.
long	getDataObjectID()	Returns the id of the data object that is locked/out of date.
String	getDataObjectName()	Returns the name/title of the data object that is locked/out of date.
String	getUserFullName()
String	getUserName()	Returns the user name that is holding the lock or the last known user that made changes to the data object rendering the data object to be out of date.
boolean	isModel()	Returns true if this MTRemoteChangeException was raised because of an attempt to change a model, false otherwise (if symbol).

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Details

OUT_OF_DATE

public static final int OUT_OF_DATE

Error code that indicates that a change failed due to the changed object being out of date. Re-query the object, make the changes and try again.

See Also:

• Constant Field Values

ALREADY_CHANGING

public static final int ALREADY_CHANGING

Error code that idicates that a change failed due to someone else making changes to the object.

See Also:

• Constant Field Values

Constructor Details

MTRemoteChangeException

public MTRemoteChangeException(int cause,
 String user,
 String userFullName,
 String dataObjectName,
 long dataObjectID,
 boolean isModel)

Method Details

getUserName

public String getUserName()

Returns the user name that is holding the lock or the last known user that made changes to the data object rendering the data object to be out of date.

Returns:

the user that is holding the lock or the last known user that made changes to the data object rendering the data object to be out of date.

getUserFullName

public String getUserFullName()

getDataObjectName

public String getDataObjectName()

Returns the name/title of the data object that is locked/out of date.

Returns:

the data object that is locked/out of date.

getDataObjectID

public long getDataObjectID()

Returns the id of the data object that is locked/out of date.

Returns:

the id of the data object that is locked/out of date.

isModel

public boolean isModel()

Returns true if this MTRemoteChangeException was raised because of an attempt to change a model, false otherwise (if symbol).

Returns:

true if this MTRemoteChangeException was raised because of an attempt to change a model, false otherwise (if symbol).

getChangeCause

public int getChangeCause()

Returns either OUT_OF_DATE or ALREADY_CHANGING depending on the reported cause of the exception.

Returns: