org.quartz.ee.servlet.QuartzInitializerServlet Maven / Gradle / Ivy
Go to download
SDK for dev_appserver (local development) with some of the dependencies shaded (repackaged)
/*
* Copyright 2004-2005 OpenSymphony
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy
* of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
*/
/*
* Previously Copyright (c) 2001-2004 James House
*/
package org.quartz.ee.servlet;
import java.io.IOException;
import javax.servlet.ServletConfig;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.quartz.Scheduler;
import org.quartz.impl.StdSchedulerFactory;
/**
*
* A Servlet that can be used to initialize Quartz, if configured as a
* load-on-startup servlet in a web application.
*
*
*
* You'll want to add something like this to your WEB-INF/web.xml file:
*
*
* <servlet>
* <servlet-name>
* QuartzInitializer
* </servlet-name>
* <display-name>
* Quartz Initializer Servlet
* </display-name>
* <servlet-class>
* org.quartz.ee.servlet.QuartzInitializerServlet
* </servlet-class>
* <load-on-startup>
* 1
* </load-on-startup>
* <init-param>
* <param-name>config-file</param-name>
* <param-value>/some/path/my_quartz.properties</param-value>
* </init-param>
* <init-param>
* <param-name>shutdown-on-unload</param-name>
* <param-value>true</param-value>
* </init-param>
*
* <init-param>
* <param-name>start-scheduler-on-load</param-name>
* <param-value>true</param-value>
* </init-param>
*
* </servlet>
*
*
*
*
* The init parameter 'config-file' can be used to specify the path (and
* filename) of your Quartz properties file. If you leave out this parameter,
* the default ("quartz.properties") will be used.
*
*
*
* The init parameter 'shutdown-on-unload' can be used to specify whether you
* want scheduler.shutdown() called when the servlet is unloaded (usually when
* the application server is being shutdown). Possible values are "true" or
* "false". The default is "true".
*
*
*
* The init parameter 'start-scheduler-on-load' can be used to specify whether
* you want the scheduler.start() method called when the servlet is first loaded.
* If set to false, your application will need to call the start() method before
* teh scheduler begins to run and process jobs. Possible values are "true" or
* "false". The default is "true", which means the scheduler is started.
*
*
* A StdSchedulerFactory instance is stored into the ServletContext. You can gain access
* to the factory from a ServletContext instance like this:
*
*
* StdSchedulerFactory factory = (StdSchedulerFactory) ctx
* .getAttribute(QuartzFactoryServlet.QUARTZ_FACTORY_KEY);
*
*
* Once you have the factory instance, you can retrieve the Scheduler instance by calling
* getScheduler() on the factory.
*
* @author James House
* @author Chuck Cavaness
*/
public class QuartzInitializerServlet extends HttpServlet {
public static final String QUARTZ_FACTORY_KEY = "org.quartz.impl.StdSchedulerFactory.KEY";
private boolean performShutdown = true;
private Scheduler scheduler = null;
/*
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*
* Interface.
*
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*/
public void init(ServletConfig cfg) throws javax.servlet.ServletException {
super.init(cfg);
log("Quartz Initializer Servlet loaded, initializing Scheduler...");
StdSchedulerFactory factory;
try {
String configFile = cfg.getInitParameter("config-file");
String shutdownPref = cfg.getInitParameter("shutdown-on-unload");
if (shutdownPref != null)
performShutdown = Boolean.valueOf(shutdownPref).booleanValue();
// get Properties
if (configFile != null) {
factory = new StdSchedulerFactory(configFile);
} else {
factory = new StdSchedulerFactory();
}
// Should the Scheduler being started now or later
String startOnLoad = cfg
.getInitParameter("start-scheduler-on-load");
/*
* If the "start-scheduler-on-load" init-parameter is not specified,
* the scheduler will be started. This is to maintain backwards
* compatability.
*/
if (startOnLoad == null || (Boolean.valueOf(startOnLoad).booleanValue())) {
// Start now
scheduler = factory.getScheduler();
scheduler.start();
log("Scheduler has been started...");
} else {
log("Scheduler has not been started. Use scheduler.start()");
}
log("Storing the Quartz Scheduler Factory in the servlet context at key: "
+ QUARTZ_FACTORY_KEY);
cfg.getServletContext().setAttribute(QUARTZ_FACTORY_KEY, factory);
} catch (Exception e) {
log("Quartz Scheduler failed to initialize: " + e.toString());
throw new ServletException(e);
}
}
public void destroy() {
if (!performShutdown)
return;
try {
if (scheduler != null)
scheduler.shutdown();
} catch (Exception e) {
log("Quartz Scheduler failed to shutdown cleanly: " + e.toString());
e.printStackTrace();
}
log("Quartz Scheduler successful shutdown.");
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.sendError(HttpServletResponse.SC_FORBIDDEN);
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.sendError(HttpServletResponse.SC_FORBIDDEN);
}
}