Page 304 -
P. 304

300                                                        M. Adams
                            <context-param>
                              <param-name>Repository</param-name>
                              <param-value>
                                ${catalina.base}\webapps\workletService\repository\
                              </param-value>
                              <description>
                                 The path where the worklet repository is installed.
                              </description>
                            </context-param>
                            <context-param>
                              <param-name>EnablePersistence</param-name>
                              <param-value>true</param-value>
                              <description>
                                ’true’ to enable persistence and logging
                                ’false’ to disable
                              </description>
                            </context-param>
                           Listing 11.2 The Worklet Service configuration file (detail)

                            <!-- PARAMS FOR EXCEPTION SERVICE -->
                            <context-param>
                              <param-name>EnableExceptionService</param-name>
                              <param-value>false</param-value>
                              <description>
                                 Set this value to ’true’ to enable monitoring by an Exception Service
                                 (specified by the URI param below).
                                 Set it to ’false’ to disable the Exception Service.
                              </description>
                            </context-param>
                            <context-param>
                              <param-name>ExceptionObserverURI</param-name>
                              <param-value>http://localhost:8080/workletService/ix</param-value>
                              <description>
                                 This value provides the URI of an Exception Service that monitors
                                 for process exceptions through Interface X.
                              </description>
                            </context-param>
                           Listing 11.3 The Engine configuration file (detail)



                           The second parameter enables or disables the service (Listing 11.3); when the
                           parameter is set to true, the engine notifies the service at various points when excep-
                           tions have (or may have) occurred throughout the life-cycle of every case launched
                           in the engine.
                              In addition to the parameter settings in the engine’s configuration file, the Excep-
                           tion Service makes use of extensions (or “hooks”) built into the Resource Service’s
                           worklist handler (cf. Chap. 10) to provide methods for users to interact with the ser-
                           vice (e.g., allowing the raising of an external exception); so, if the Exception Service
                           is enabled via the engine’s configuration file, then the extensions to the worklist must
                           also be enabled via its configuration file. The Resource Service has been deployed
                           as a discrete service also, and so has its own configuration file.
                              Within that file, a parameter is supplied to specify the URL of the Exception Ser-
                           vice; by default it is set to a URL of the service relative to the same servlet container
   299   300   301   302   303   304   305   306   307   308   309