bonobo-exception
maps CORBA exceptions to user readable text, + helper macros
This module contains some useful helper functions
that can be used to set various exceptions inside your
CORBA methods. It also contains code to map between
complex CORBA_Environment exceptions and helpful
strings suitable for display to the user.
Typically to test for exceptions the BONOBO_EX macro
is used thus:
Bonobo exception trapping and reporting
int
do_something (CORBA_Environment *ev)
{
...
retval = Foo_Baa_method (object, ev);
if (BONOBO_EX (ev)) {
if (BONOBO_USER_EX (ev, ex_CosNaming_NamingContext_NotFound)) {
g_warning ("Not found");
} else {
char *str;
g_warning ("Exception '%s' occured",
(str = bonobo_exception_get_text (ev)));
g_free (str);
}
return -1;
}
...
}
This macro sets the stateless user exception with @repo_id on
@opt_ev or warns if @opt_ev == NULL
@opt_ev: an optional corba exception environment.
@repo_id: repoid of the exception to set.
this macro is used for bonobo preconditons on argument types,
usualy inside skels if @expr is FALSE a warning is printed and
@opt_ev is set to ex_Bonobo_BadArg.
@expr: an expression that should be true
@opt_ev: an optional corba exception environment.
this macro is used for bonobo preconditons on argument types,
usualy inside skels if @expr is FALSE a warning is printed and
@opt_ev is set to ex_Bonobo_BadArg.
@expr: an expression that should be true
@val: a value to return on failure.
@opt_ev: an optional corba exception environment.
This macro returns TRUE if @ev flags an exception.
@ev: the exception environment
This macro returns TRUE if @ev contains a user exception
of type @id.
@ev: the exception environment
@id: the repo_id of the exception
Returns the repoid string of exception @ev.
@ev: a CORBA exception
returns if there is an exception flagged in @ev.
@ev: the exception environment
returns @v if there is an exception flagged in @ev
@ev: the exception environment
@v: the value to return
The prototype for user registerable exception decoders.
@ev: the exception environment
@user_data: user data to be passed to the function
@Returns: a g_malloc'd copy of a translated user readable error string.
@ev:
@Returns:
@repo_id:
@Returns:
@repo_id:
@str:
@repo_id:
@fn:
@user_data:
@destroy_fn:
@ev:
@opt_deriv:
@format:
@Varargs:
@ev:
@Returns: