KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > tanukisoftware > wrapper > jmx > WrapperManagerTestingMBean


1 package org.tanukisoftware.wrapper.jmx;
2
3 /*
4  * Copyright (c) 1999, 2006 Tanuki Software Inc.
5  *
6  * Permission is hereby granted, free of charge, to any person
7  * obtaining a copy of the Java Service Wrapper and associated
8  * documentation files (the "Software"), to deal in the Software
9  * without restriction, including without limitation the rights
10  * to use, copy, modify, merge, publish, distribute, sub-license,
11  * and/or sell copies of the Software, and to permit persons to
12  * whom the Software is furnished to do so, subject to the
13  * following conditions:
14  *
15  * The above copyright notice and this permission notice shall be
16  * included in all copies or substantial portions of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
20  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21  * NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
22  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
23  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25  * OTHER DEALINGS IN THE SOFTWARE.
26  */
27
28 /**
29  * This MBean interface provides access to a number of actions which can be
30  * useful for testing how well an application responds to JVM crashes. It
31  * has been broken out frtom the WrapperManagerMBean interface so system
32  * administrators can easily disable the testing functions.
33  *
34  * @author Leif Mortenson <leif@tanukisoftware.com>
35  */
36 public interface WrapperManagerTestingMBean
37 {
38     /**
39      * Causes the WrapperManager to go into a state which makes the JVM appear
40      * to be hung when viewed from the native Wrapper code. Does not have
41      * any effect when the JVM is not being controlled from the native
42      * Wrapper.
43      */
44     void appearHung();
45     
46     /**
47      * Cause an access violation within native JNI code. This currently causes
48      * the access violation by attempting to write to a null pointer.
49      */
50     void accessViolationNative();
51     
52     /**
53      * Tells the native wrapper that the JVM wants to shut down and then
54      * promptly halts. Be careful when using this method as an application
55      * will not be given a chance to shutdown cleanly.
56      *
57      * @param exitCode The exit code that the Wrapper will return when it exits.
58      */
59     void stopImmediate( int exitCode );
60 }
61
Popular Tags