| Bonobo API Reference Manual | |||
|---|---|---|---|
| <<< Previous Page | Home | Up | Next Page >>> |
#define BONOBO_EX (ev) #define BONOBO_USER_EX (ev,id) #define BONOBO_RET_EX (ev) #define BONOBO_RET_VAL_EX (ev,v) char* (*BonoboExceptionFn) ( |
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:
Example 1. 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;
}
...
}
|
#define BONOBO_EX(ev) ((ev) && (ev)->_major != CORBA_NO_EXCEPTION) |
This macro returns TRUE if ev flags an exception.
#define BONOBO_USER_EX(ev,id) |
This macro returns TRUE if ev contains a user exception of type id.
char* (*BonoboExceptionFn) ( |
The prototype for user registerable exception decoders.
#define bonobo_return_if_fail(expr,opt_ev) |
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.
#define bonobo_return_val_if_fail(expr,val,opt_ev) |
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.
#define bonobo_exception_set(opt_ev,repo_id) |
This macro sets the stateless user exception with repo_id on opt_ev or warns if opt_ev == NULL
char* bonobo_exception_get_text ( |
Returns a user readable description of the exception. First checks ev against builtin Bonobo exceptions, then falls back to exception names added through bonobo_exception_add_handler_str or bonobo_exception_add_handler_fn.
void bonobo_exception_add_handler_str
(const char *repo_id,
const char *str); |
This routine adds a simple string mapping for an exception with repository id repo_id, such that when we call bonobo_exception_get_text on an exception of id repo_id we get str back.
void bonobo_exception_add_handler_fn (const char *repo_id,
BonoboExceptionFn fn,
|
This routine adds a method mapping for an exception with repository id repo_id, such that when we call bonobo_exception_get_text on an exception of id repo_id the fn is called and passed user_data. When the handler is removed the destroy_fn is called on its user_data.