<html> <head> <title>Service InteractionHandler</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimainnone">Use</td> <td class="navimainnone">Devguide</td> <td class="navimain"><a href="../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub">Constructors' Summary</td> <td class="navisub">Constructors' Details</td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../module-ix.html" class="namechain">::</a> <a href="../../../module-ix.html" class="namechain">com</a> :: <a href="../../module-ix.html" class="namechain">sun</a> :: <a href="../module-ix.html" class="namechain">star</a> :: <a href="module-ix.html" class="namechain">sdb</a> :: </p> </td> </tr> <tr> <td class="title">service InteractionHandler</td> </tr> <tr> <td><dl> <dt><b>Supported Interface</b></dt> <dd>::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionHandler.html">XInteractionHandler</a></dd> </dl> </td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>is a service for user interaction for databases. </dd> <dd><p> interaction requests that the handler can provide are: <ul> <li><b>database related errors</b><br/> The general structure to transport such errors is the ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> , and if your ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a> supplies such a ::com::sun::star::<a href="../sdbc/module-ix.html">sdbc</a>::<a href="../sdbc/SQLException.html">SQLException</a> (or an instance of any derived class), the handler will display a generic error dialog, which is able to travel the object chain which may be contained in the exception. </li> <li><b>authentication</b><br/> If your ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a> (see ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionHandler.html">XInteractionHandler</a>::<a href="../task/XInteractionHandler.html#handle">handle()</a> ) supplies a ::com::sun::star::<a href="../ucb/module-ix.html">ucb</a>::<a href="../ucb/AuthenticationRequest.html">AuthenticationRequest</a> , the handler will open a standard login dialog to allow user authentication. <br/> Besides the using the members of the AuthenticationRequest in the usual manner, the member <em>Server</em> (if not empty) is interpreted as datasource name, thus leading to a slightly different message when requesting the user to enter it's login data. <br/> In the case you want to use this authentication feature, you should supply a special authentication continuation ( ::com::sun::star::<a href="../ucb/module-ix.html">ucb</a>::<a href="../ucb/XInteractionSupplyAuthentication.html">XInteractionSupplyAuthentication</a> ) as well, so the handler can return to you, the entered information. </li> <li><b>parameter requests</b><br/> If your ::com::sun::star::<a href="../task/module-ix.html">task</a>::<a href="../task/XInteractionRequest.html">XInteractionRequest</a> supplies an <a href="ParametersRequest.html">ParametersRequest</a> , the handler will open a standard dialog asking the user to fill in parameter values. <br/> In the case you want to use this feature of the handler, you should supply a special continuation ( <a href="XInteractionSupplyParameters.html">XInteractionSupplyParameters</a> ) as well, so the handler can return to you, the entered information. </li> </ul> </p> </dd> </dl> </td> </tr> </table> <hr> <hr> <br> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.</p> </div> <!-- id="adc-idlref" --> </body> </html>