com.thomsonreuters.ema.access.OmmProviderErrorClient Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ema Show documentation

Enterprise Message API (EMA) Java Edition

There is a newer version: 3.5.1.0

/*|-----------------------------------------------------------------------------
 *|            This source code is provided under the Apache 2.0 license      --
 *|  and is provided AS IS with no warranty or guarantee of fit for purpose.  --
 *|                See the project's LICENSE.md for details.                  --
 *|           Copyright (C) 2019 Refinitiv. All rights reserved.            --
 *|-----------------------------------------------------------------------------
 */

package com.thomsonreuters.ema.access;

/**
 * OmmProviderErrorclient class provides callback mechanism used in place of exceptions.
 * 
 * By default OmmProvider class throws exceptions if a usage error occurs.
 * 
Specifying OmmProviderErrorClient on the constructor of OmmProvider overwrites this behavior.
 * 
Instead of throwing exceptions, respective callback method on OmmProviderErrorClient will be invoked.
 * 
 * @see OmmProvider
 * @see OmmException
 * @see OmmInvalidUsageException
 * @see OmmInvalidHandleException
 */

public interface OmmProviderErrorClient
{
	/**
	 * Invoked upon receiving an invalid handle.
	 * 
Requires OmmProvider constructor to have an OmmProviderErrorClient.
	 * 
	 * @param handle value of the handle that is invalid
	 * @param text specifies associated error text
	 */
	public void onInvalidHandle(long handle, String text);

	/**
	 * Invoked in the case of invalid usage.
	 * 
Requires OmmProvider constructor to have an OmmProviderErrorClient.
	 * 
	 * @param text specifies associated error text
	 */ 
	public default void onInvalidUsage(String text) {}

	/**
	 * Invoked in the case of invalid usage.
	 * 
Requires OmmProvider constructor to have an OmmProviderErrorClient.
	 * This method provides an additional error code for applications to check and handle the error appropriately.
	 * 
The applications should override only one of the onInvalidUsage() method to avoid receiving two callback calls for an invalid usage error.
	 * 
	 * @param text specifies associated error text
	 * @param errorCode specifies associated error code
	 */ 
	public default void onInvalidUsage(String text, int errorCode) {}
}