oracle.jbo.service.upgrade

Class ServiceMBeanUtil

java.lang.Object

oracle.jbo.service.upgrade.ServiceMBeanUtil

@Concealed
public class ServiceMBeanUtil
extends java.lang.Object

Since:

12.2.1.3.0

Constructor Summary

Constructors

Constructor and Description
ServiceMBeanUtil()

Method Summary

Modifier and Type	Method and Description
static boolean	assertMappedToDefaultStore(java.lang.String absoluteName, java.lang.String handlerName) Check if the given MDS package is mapped to the default customization store.
static java.lang.String	buildFailureMessage(java.lang.String handlerName, java.util.List<java.lang.String> errlist) Construct a string value that can be used as the exception message.
static oracle.adf.share.logging.ADFLogger	getUpgradeADFMetadataLogger()
static void	logFailure(java.lang.String doc, java.lang.Throwable t) Print an informational message for failing to upgrade ADF metadata for the given MDS document.
static void	logSuccess(java.lang.String doc) Print an informational message for successfully upgrading ADF metadata for the given MDS document.
static boolean	warnAndIgnoreException(java.lang.Throwable t) Check if the thrown exception should be caught and ignored.
static boolean	warnAndIgnoreExceptionLoadingDef(java.lang.Throwable t) Check if the thrown exception should be caught and ignored.
static boolean	warnAndIgnoreExceptions() Check if exceptions related to def object loading should be caught and ignored.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceMBeanUtil

public ServiceMBeanUtil()

Method Detail

getUpgradeADFMetadataLogger

public static oracle.adf.share.logging.ADFLogger getUpgradeADFMetadataLogger()

warnAndIgnoreExceptionLoadingDef

public static boolean warnAndIgnoreExceptionLoadingDef(java.lang.Throwable t)

Check if the thrown exception should be caught and ignored. This method should be called specifically for catching exceptions thrown by ViewDefImpl.findDefObject() or its variants.

Parameters:

t - exception that was thrown during schema regeneration loading

Returns:

true if the specified exception indicates an error occurred during object loading, and this process is configured to ignore such exceptions.

warnAndIgnoreException

public static boolean warnAndIgnoreException(java.lang.Throwable t)

Check if the thrown exception should be caught and ignored.

Parameters:

t - exception that was thrown during schema regeneration

Returns:

true if the specified exception indicates an error occurred during object loading, and this process is configured to ignore such exceptions.

warnAndIgnoreExceptions

public static boolean warnAndIgnoreExceptions()

Check if exceptions related to def object loading should be caught and ignored. Default is true. To disable (i.e. to throw error), set "oracle.adf.bugfixes.disable_24394364" logger to FINEST level.

Returns:

true if this process is configured to ignore exceptions related to def object loading.

assertMappedToDefaultStore

public static boolean assertMappedToDefaultStore(java.lang.String absoluteName,
                                                 java.lang.String handlerName)

Check if the given MDS package is mapped to the default customization store. Log a warning message with the given upgrade handler name if the given MDS package is not mapped to the default customization store. Log a warning message if any exception is thrown by MDS when checking the default cust store (and return true in this case).

Parameters:

absoluteName - absolute name for the MDS package

handlerName - ADF metadata upgrade handler name

Returns:

true if the given MDS package is mapped to the default customization store.

logSuccess

public static void logSuccess(java.lang.String doc)

Print an informational message for successfully upgrading ADF metadata for the given MDS document. The message is intentionally not translated, so that someone can grep for these messages in <server>-diagnostic.log files.

Parameters:

doc - document name

logFailure

public static void logFailure(java.lang.String doc,
                              java.lang.Throwable t)

Print an informational message for failing to upgrade ADF metadata for the given MDS document. The message is intentionally not translated, so that someone can grep for these messages in <server>-diagnostic.log files.

Parameters:

doc - document name

t - failure cause

buildFailureMessage

public static java.lang.String buildFailureMessage(java.lang.String handlerName,
                                                   java.util.List<java.lang.String> errlist)

Construct a string value that can be used as the exception message. The message is intentionally not translated, so that someone can grep for these messages in log files.

Parameters:

handlerName - ADF metadata upgrade handler name

errlist - names of documents that the given handler failed to upgrade

Returns: