01: // Copyright (c) 2004-2005 Sun Microsystems Inc., All Rights Reserved.
02:
03: /*
04: * SequencingEngineBootstrap.java
05: *
06: * SUN PROPRIETARY/CONFIDENTIAL.
07: * This software is the proprietary information of Sun Microsystems, Inc.
08: * Use is subject to license terms.
09: *
10: */
11: package com.sun.jbi.engine.sequencing;
12:
13: import java.util.logging.Logger;
14:
15: import javax.jbi.component.Bootstrap;
16: import javax.jbi.component.InstallationContext;
17:
18: /**
19: * Implemented by a SE to provide any special processing required at
20: * install/uninstall time. Things such as creation/deletion of directories,
21: * files, database tables could be done by the onInstall() and onUninstall()
22: * methods, respectively. Also allows the BPE to terminate the installation or
23: * uninstallation in the event of an error.
24: *
25: * @author Sun Microsystems, Inc.
26: */
27: public class SequencingEngineBootstrap implements Bootstrap {
28: /**
29: * Creates a new instance of StockQuoteEngineBootstrap.
30: */
31: public SequencingEngineBootstrap() {
32: }
33:
34: /**
35: * Get the JMX ObjectName for the optional installation configuration MBean
36: * for this BPE. If there is none, the value is null.
37: *
38: * @return ObjectName the JMX object name of the installation configuration
39: * MBean or null if there is no MBean.
40: */
41: public javax.management.ObjectName getExtensionMBeanName() {
42: return null;
43: }
44:
45: /**
46: * Cleans up any resources allocated by the bootstrap implementation,
47: * including deregistration of the extension MBean, if applicable. This
48: * method will be called after the onInstall() or onUninstall() method is
49: * called, whether it succeeds or fails.
50: *
51: * @throws javax.jbi.JBIException when cleanup processing fails to complete
52: * successfully.
53: */
54: public void cleanUp() throws javax.jbi.JBIException {
55: }
56:
57: /**
58: * Called to initialize the BPE bootstrap.
59: *
60: * @param installContext is the context containing information from the
61: * install command and from the BPE jar file.
62: *
63: * @throws javax.jbi.JBIException when there is an error requiring that the
64: * installation be terminated.
65: */
66: public void init(InstallationContext installContext)
67: throws javax.jbi.JBIException {
68: return;
69: }
70:
71: /**
72: * Called at the beginning of installation of StockQuoteEngine. For this
73: * sample engine, all the required installation tasks have been taken care
74: * by the InstallationService.
75: *
76: * @throws javax.jbi.JBIException when there is an error requiring that the
77: * installation be terminated.
78: */
79: public void onInstall() throws javax.jbi.JBIException {
80: }
81:
82: /**
83: * Called at the beginning of uninstallation of StockQuoteEngine. For this
84: * sample engine, all the required uninstallation tasks have been taken
85: * care of by the InstallationService
86: *
87: * @throws javax.jbi.JBIException when there is an error requiring that the
88: * uninstallation be terminated.
89: */
90: public void onUninstall() throws javax.jbi.JBIException {
91: }
92: }
|