DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Newsletter
Log In / Join
Refcards Trend Reports
Events Video Library
Refcards
Trend Reports

Events

View Events Video Library

Related

  • Java 27 Makes G1 the Default Everywhere: How to Test Your Small Containers Before You Upgrade
  • Stop Writing Database Migration Scripts: Declarative Schema Sync for Java
  • Searching Kafka Without an Index: Lessons From Building Message Search for Kafdrop
  • ScyllaDB in Enterprise Java: High-Performance NoSQL With Eclipse JNoSQL

Trending

  • Why AI Agents Need a Shared Enterprise Ontology
  • Share Delta Lake Tables Between Databricks and Snowflake
  • Deploying Small Language Models on Sovereign Cloud
  • Replay, Scheduling, and Throttling: Engineering a Self-Service Kafka Streaming Tool at Scale

Draft This article hasn't been published, so readers can't see it.

In moderation This article is waiting for review, so readers can't see it yet.

Deleted This article has been deleted, so readers can't see it.

  1. DZone
  2. Coding
  3. Java
  4. Java JMX Shutdown Gracefully with ShutdownHook example

Java JMX Shutdown Gracefully with ShutdownHook example

By 
Bosco Ferrao
·
Jul. 30, 14 · Code Snippet
Post on X (opens in a new tab) Share on LinkedIn (opens in a new tab)
7.7K Views

Join the DZone community Save articles, join the discussion, and download Refcards and Trend Reports with a free account.

Join for free Already a member? Log in

For JMX you need an interface:

package com.bos.jmx;

public interface ShutdownMBean {
	/**
		 * Shutdown operation
		 */	
	public void shutdown() throws Exception;
}

The implementation is Shutdown java class above.

Include this code on server startup used in my Main.java:

public void initServerJMX() throws MalformedObjectNameException,
       InstanceAlreadyExistsException, MBeanRegistrationException,
       NotCompliantMBeanException {
     // Initialise JMX
     // Get the Platform MBean Server
     MBeanServer mbs = ManagementFactory.getPlatformMBeanServer();

     // Construct the ObjectName for the Shutdown MBean we will register
     ObjectName mbeanName = new ObjectName("com.bos.jmx:type=Shutdown");

     // Create the Shutdown MBean
     final Shutdown mbean = new Shutdown();

     // Register the Hello World MBean
     mbs.registerMBean(mbean, mbeanName);
     
     Runtime.getRuntime().addShutdownHook(new Thread() {
       public void run() {
         try {
           mbean.shutdown();
         } catch (Exception e) {
           e.printStackTrace();
         }
       }
     });
   }

public void useArg0(String arg) {

//sample code using arg

}

Include this code in client used to shutdown the server used in my Main.java:

public void clientExecuteShutdown(int port) throws Exception {
	JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://:"
						+ port + "/jmxrmi");
			JMXConnector jmxc = JMXConnectorFactory.connect(url, null);
			MBeanServerConnection mbsc = jmxc.getMBeanServerConnection();
		
	// Construct the ObjectName for the Shutdown MBean
        //
        ObjectName mbeanName = new ObjectName("com.bos.jmx:type=Shutdown");

        // Create a dedicated proxy for the MBean instead of
        // going directly through the MBean server connection
        //
        ShutdownMBean mbeanProxy =
            JMX.newMBeanProxy(mbsc, mbeanName, ShutdownMBean.class, true);
        
        logger.info("Executing shutdown...");
        mbeanProxy.shutdown();
        logger.info("Shutdown done.");
	}

My sample start/shutdown code with main used in my Main.java:

public static void main(String args[]) throws NumberFormatException, Exception {

			if (args.length < 1) {
						throw new RuntimeException(
		"1. Please specify 1st argument."
									+ "\n2. Please specify 1st argument as shutdown and 2nd argument as port of JMX.");
			}
			if ("shutdown".equalsIgnoreCase(args[0])) {
					if (args.length < 2) {
							throw new RuntimeException(
									"Please specify 1st argument as shutdown and 2nd argument as port of JMX.");
					}
					clientExecuteShutdown(Integer.valueOf(args[1]));
			} else {
			useArg0(args[0]);
					initServerJMX();
	}	
	}

This code attached also has Runtime.getRuntime().addShutdownHook()

The code startup line is for server:

java -Dcom.sun.management.jmxremote.port=9999 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -classpath . com.bos.jmx.Main arg0

The code for shutdown of server is:

java -classpath . com.bos.jmx.Main shutdown 9999
package com.bos.jmx;

public class Shutdown implements ShutdownMBean {
	private static volatile boolean flagRunOne = false;

	@Override
	public void shutdown() throws Exception {
		if (!flagRunOne) {
			System.out.println("Server shutting down...");
			//Sample shutdown code here
			Main.shutdown();
			System.out.println("Server shutdown.");
			flagRunOne = true;
		}
	}
}
Java (programming language)

Opinions expressed by DZone contributors are their own.

Related

  • Java 27 Makes G1 the Default Everywhere: How to Test Your Small Containers Before You Upgrade
  • Stop Writing Database Migration Scripts: Declarative Schema Sync for Java
  • Searching Kafka Without an Index: Lessons From Building Message Search for Kafdrop
  • ScyllaDB in Enterprise Java: High-Performance NoSQL With Eclipse JNoSQL

Partner Resources

×

Comments

Loading comments

The comments didn't load

Please try again in a moment.

Likes

Loading

The next likes didn't load. Please try again.

The likes didn't load

Please try again in a moment.

See who liked this

Log in or join DZone for free to see who liked this article.

Log in Join for free
  • RSS
  • X
  • Facebook

ABOUT US

  • About DZone
  • Support and feedback
  • Community research

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Core Program
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 3343 Perimeter Hill Drive
  • Suite 215
  • Nashville, TN 37211
  • [email protected]

Let's be friends:

  • RSS
  • X
  • Facebook