Ilog.webui.dhtml

Classe IlxWController

java.lang.Object

Javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

Ilog.webui.dhtml.IlxWController

Toutes les interfaces implémentées:

IlxWConstants, java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

Sous-classes connues directes:

Contrôleur IlxWDefaultController

Public abstract class Contrôleur IlxWController
étend javax.servlet.http.HttpServlet
implémente IlxWConstants

Servlet du contrôleur pour les composants Web. Ce servlet gère la communication entre le côté client et le côté serveur des composants Web.

Lors de la création d'une application Web à l'aide des composants Web, vous devez fournir un servlet de contrôleur et indiquer son chemin dans le paramètre de contexte ilog.webui.dhtml.controller_path . Vous fournissez généralement ces informations dans le descripteur de déploiement WEB-INF/web.xml de votre application Web (voir Spécification Servlet 2.2 pour plus de détails sur les applications Web et les descripteurs de déploiement). Le contrôleur que vous fournissez doit être une sous-classe de IlxWController, à savoir la classe IlxWDefaultController ou votre propre sous-classe.
Voici un exemple de sous-classe de servlet de contrôleur :

 Public de classe MyController étend IlxWController {
   Public void handleError (HttpRequest req,
                           Resp HttpResponse,
                           Erreur IlxWControllerError,
                           Chaîne updateRequest) {
     Resp.sendError (HttpResponse.SC_INTERNAL_SERVER_ERROR,
                    Error.getMessage ()) ;
   }
 }
 

... et généralement, vous référencez ce servlet dans votre fichier WEB-INF/web.xml comme suit:

 ...
 <context-param>
   < param-name>ilog.webui.dhtml.controller_path < /param-name>
   < valeur_paramème> /servlet/myservlets.MyController < /param-value>
 </context-param>
 <servlet>
   < servlet-name> MonController < /servlet-name>
   < servlet-class>myservlets.MyController < /servlet-class>
 </servlet>
 <servlet-mapping>
   < servlet-name> MonController < /servlet-name>
   < url-pattern> /servlet/myservlets.MonController < /url-pattern>
 </servlet-mapping>
 ...
 

Pour comprendre comment la communication entre le côté client et le côté serveur d'un composant Web est gérée, regardons un scénario d'interaction utilisateur. Supposons qu'un utilisateur effectue une action sur un navigateur Web, par exemple, en cliquant sur un lien de l'éditeur Syntactique. Lorsque cette action est effectuée, une méthode de proxy JavaScript est appelée. Cette méthode enregistre d'abord les données représentant la modification appliquée au composant dans une file d'attente stockée dans l'environnement JavaScript du client. Nous appelons cette file d'attente File d'attente de composants modifiés. La prochaine fois qu'une demande est envoyée à Servlet de contrôleur, les données de la file d'attente de composants modifiées seront ajoutées à la demande et l'objet de composant côté serveur sera mis à jour en conséquence. De cette façon, les composants sont synchronisés côté client et côté serveur.

Le principal problème du côté client est de savoir s'il faut ou non réafficher la page HTML. Le proxy JavaScript applique des modifications à la page HTML en évaluant l'action de l'utilisateur. Il y a trois conditions possibles qui peuvent se présenter:

• Il n'est pas nécessaire de réafficher la page (par exemple, une zone de texte a été modifiée) ;
• Réafficher la page par client: le proxy JavaScript peut effectuer cette fonction localement ;
• Réafficher la page par serveur: le proxy JavaScript envoie une demande au
serveur.

Lorsqu'une modification de l'état du composant est placée dans la file d'attente, la méthode de proxy JavaScript évalue la modification. Si le composant doit être réaffiché via le serveur, le proxy JavaScript envoie une demande à Servlet de contrôleur. Les demandes d'envoi peuvent être envoyées au serveur de deux manières différentes, selon le navigateur Web:

• Sur Internet Explorer 5 ou version ultérieure, les données sont envoyées et reçues via un objet XMLHttpRequest ActiveX. Cela nous permet d'implémenter un mécanisme de réaffichage intelligent, car seules les parties modifiées du composant
Doit être réaffichée.
• Sur d'autres navigateurs Web, par exemple Netscape 3.x et 4.x, les données sont envoyées via un formulaire avec _self comme cible. Après avoir traité la file d'attente de composant modifiée, le servlet contrôleur transmet la demande au servlet ou à la page JSP qui a affiché le composant qui a déclenché l'action.

Dans cette classe, la méthode service() gère toutes les demandes quel que soit leur type. Le remplacement de doGet, doPost, doPut, etc. n'a aucun effet.

Voir aussi :

IlxWComponent, IlxWPort, IlxWManager, Formulaire sérialisé

Récapitulatif du constructeur

Constructeurs

Constructeur et description
IlxWController()

Récapitulatif de la méthode

Modificateur et type	Méthode et description
protected abstract void	handleError(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, IlxWControllerError error, java.lang.String requestPath) Gère les erreurs générées par la méthode service de ce servlet.
protected void	service(javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse resp) Redéfinit HttpServlet.service().

Méthodes héritées de la classe javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service

Méthodes héritées de la classe javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Méthodes héritées de la classe java.lang.Object

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

Détail du constructeur

Contrôleur IlxWController

Public IlxWController ()

Détail de la méthode

service

Service void protégée (javax.servlet.http.HttpServletRequest req,
                       Javax.servlet.http.HttpServletResponse resp)
                Throws javax.servlet.ServletException,
                       Java.io.IOException

Redéfinit HttpServlet.service(). Vous ne devriez pas avoir à redéfinir cette méthode.

Substitutions:

service dans la classe javax.servlet.http.HttpServlet

Throws :

javax.servlet.ServletException

java.io.IOException

HandleError

Protected abstract void handleError (javax.servlet.http.HttpServletRequest request,
                                    Réponse javax.servlet.http.HttpServletResponse,
                                    Erreur IlxWControllerError ,
                                    Java.lang.String requestPath)
                             Génère java.io.IOException,
                                    Javax.servlet.ServletException

Gère les erreurs générées par la méthode service de ce servlet.

Throws :

java.io.IOException

javax.servlet.ServletException

Paramètres:

error -Objet d'erreur du contrôleur.

request -Demande en cours.

response -Réponse en cours.

requestPath -Chemin de la demande qui a été appelée juste avant le contrôleur de servlet.