oracle.jbo.common

Interface JboMessage

All Known Implementing Classes:

AdapterException, AfterCommitException, AfterPostException, AfterRollbackException, AlreadyConnectedException, AlreadyLockedException, ApplicationModuleCreateException, ApplicationPoolException, AttrDependencyException, AttributeLoadException, AttributeReadXMLException, AttrNotSelectedException, AttrSetValException, AttrValException, BatchDMLException, ConfigException, ConnectionException, CreateRowPrivilegeException, CustomClassNotFoundException, DataCreationException, DeadEntityAccessException, DeadViewRowAccessException, DefinitionChangedException, DefPersistenceException, DMLConstraintException, DMLException, DomainValidationException, ExprDuplicateSignatureException, ExprResourceException, ExprScriptException, ExprSecurityException, ExprTimeoutException, GenericDomainException, GraphCycleException, HiddenDefException, InvalidAttrKindException, InvalidDefNameException, InvalidObjAccessException, InvalidObjNameException, InvalidOperException, InvalidOwnerException, InvalidParamException, InvalidSortCriteriaAttrException, JboAssert, JboException, JboExMsgCarrier, JboSecurityException, JboSerializationException, JboSQLException, JboUnexpectedException, JboWarning, JIEvalException, JIEvaluationError, JIException, JISyntaxError, KeyNotFoundException, KeyNotPopulatedException, ListBindingMismatchException, NameClashException, NoDefException, NoObjException, NotConnectedException, NoXMLFileException, PCollException, PersInconsistentException, PersistenceException, PersMergeException, PiggybackException, PrecisionScaleValidationException, ReadOnlyAttrException, ReadOnlyDefObjectException, ReadOnlyViewObjectException, ReadXMLException, RemoveRowPrivilegeException, RemoveWithDetailsException, ResourcePoolException, RowAlreadyDeletedException, RowCreateException, RowDMLException, RowFinderFetchLimitExceededException, RowIdGenerationException, RowInconsistentException, RowLimitExceededWarning, RowNotAvailableException, RowNotFoundException, RowReadXMLException, RowValException, ServiceInvocationException, ServiceJboWarning, SQLDatumException, SQLStmtException, TooManyObjectsException, TxnValException, UnknownSQLTypeException, UpdateAttrPrivilegeException, ValidationException, VariantException, ViewLinkAlreadyExistsException, ViewObjectNotPreparedException

public interface JboMessage

Defines methods for localizing exception messages for various target languages, and for message formatting.

Message-text localization occurs when the client calls getLocalizedMessage(), rather than at the time the exception occurs, because the client may need to present the message in a number of different languages.

Since:

JDeveloper 3.0

Method Summary

Methods

Modifier and Type	Method and Description
void	addToDetails(java.lang.Object obj) Adds to the list of details.
java.lang.String	getBaseMessage() Gets the message without localizing it or inserting parameters.
java.lang.String	getDetailMessage() Converts the message to text, incorporating the list of details.
java.lang.Object[]	getDetails() Gets the list of objects and exceptions that spawned this message.
java.lang.String	getErrorCode() Gets the message's error code.
java.lang.Object[]	getErrorParameters() Gets the message's parameters.
java.lang.String	getLocalizedBaseMessage(java.util.Locale l) Localizes an un-parameterized message text for a specific Locale.
java.lang.String	getLocalizedMessage(java.util.Locale l) Formats the message text for a specific Locale.
java.lang.String	getMessage() Formats the message text for the default locale.
java.lang.String	getProductCode() Gets the product code.
java.lang.Class	getResourceClass() Gets the resource bundle used to localize messages.
java.lang.String	getResourceName() Gets the name of the ResourceBundle used to localize messages.
boolean	isLocalizable() Tests this message's localizability.
void	setDetails(java.lang.Object[] details) Sets the list of details.

Method Detail

getMessage

java.lang.String getMessage()

Formats the message text for the default locale.

Returns:

the localized message.

getLocalizedMessage

java.lang.String getLocalizedMessage(java.util.Locale l)

Formats the message text for a specific Locale.

Parameters:

l - a locale.

Returns:

the localized message.

getBaseMessage

java.lang.String getBaseMessage()

Gets the message without localizing it or inserting parameters.

Returns:

the un-formatted, non-localized message.

getLocalizedBaseMessage

java.lang.String getLocalizedBaseMessage(java.util.Locale l)

Localizes an un-parameterized message text for a specific Locale.

Parameters:

l - a locale.

Returns:

the localalized but un-formatted message.

getResourceClass

java.lang.Class getResourceClass()

Gets the resource bundle used to localize messages.

Returns:

a ResourceBundle subclass.

getResourceName

java.lang.String getResourceName()

Gets the name of the ResourceBundle used to localize messages.

Returns:

a string identifying a resource bundle.

getErrorCode

java.lang.String getErrorCode()

Gets the message's error code.

Returns:

a string containing an error code.

getErrorParameters

java.lang.Object[] getErrorParameters()

Gets the message's parameters.

Returns:

an array.

getProductCode

java.lang.String getProductCode()

Gets the product code.

Returns:

this message's product code.

getDetails

java.lang.Object[] getDetails()

Gets the list of objects and exceptions that spawned this message.

Returns:

an array.

getDetailMessage

java.lang.String getDetailMessage()

Converts the message to text, incorporating the list of details.

Returns:

a text string.

setDetails

void setDetails(java.lang.Object[] details)

Sets the list of details.

Parameters:

details - an array which replaces the current list of details. array in this exception object.

addToDetails

void addToDetails(java.lang.Object obj)

Adds to the list of details.

Parameters:

obj - an object to add to the details list.

isLocalizable

boolean isLocalizable()

Tests this message's localizability.

Returns:

true if this message can be localized.