techwhizbang-jruby-quartz 0.1

data/LICENSE

@@ -0,0 +1,11 @@
+Copyright (c) 2009 Nick Zalabak
+
+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.

data/README

@@ -0,0 +1,79 @@
+= jruby-quartz
+
+== Instructions
+
+Requires the following jars in your application container
+
+commons-collections-3.2.x.jar
+commons-logging.jar
+log4j.jar
+quartz-1.6.x.jar
+
+If you are running a current version of JBoss you already have these!
+If you are running an alternative container you will need to check it's lib
+directory for the presence of these jars.
+
+If you need these jars you can find them within the apache commons project and
+the quartz jar on opensymphony
+
+== Installation
+
+  gem install git://github.com/techwhizbang/jruby-quartz.git
+
+== Usage
+
+The best way to leverage jruby-quartz is to simply extend the BaseScheduler and
+implement any number of jobs you need to run.
+
+For example all you need to do is specify some basic attributes including the
+cron expression representing the frequency of the job(s) you want to with it:
+
+class IntegrationScheduler < BaseScheduler
+
+  private
+
+  def initialize
+    super
+    @base_jobs_group = "IntegrationJobs"
+    @base_triggers_group = "IntegrationTriggers"
+    @cron_expression = "0 0/1 * * * ?"
+  end
+end
+
+Then just extend the base job by putting all of the work you want to perform inside the
+perform_job method.
+
+class IntegrationJob < Jobs::BaseJob
+
+  def perform_job
+    worker_one = mock('worker class one', :whatever => "123")
+    worker_two = mock('worker class two', :whatever => '123')
+  end
+end
+
+If you are running Rails you can throw the schedule! method into a custom initializer.
+An example of this would be like so:
+Notice the Rails.env /container/, I defined custom environments that only run when
+inside a Java container so that the schedule! method doesn't get fired off during
+testing. 
+
+****If you don't do this the schedule! method is fired off a Quartz thread pool
+is spun up.****
+
+if RUBY_PLATFORM =~ /java/ && Rails.env =~ /container/
+
+  CustomerLoadScheduler.instance.schedule!(Jobs::CustomerLoadJob)
+  LoggerOneScheduler.instance.schedule!(Jobs::LoggerOneJob)
+  LoggerTwoScheduler.instance.schedule!(Jobs::LoggerTwoJob)
+
+end
+
+If you are planning on using this with a Rails stack, I would recommend using this
+only with Rails 2.2 or higher because thread safety == 1 runtime
+
+1 runtime means your schedule initializer is only called once.
+
+=== Other
+
+Problems, comments, and suggestions all welcome. nick@controlaltcreate.com or visit my blog
+http://techwhizbang.com

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+
+task :default => :test
+
+task :test do
+  require File.dirname(__FILE__) + '/test/all_tests.rb'
+end
+
+desc 'Generate RDoc'
+Rake::RDocTask.new do |task|
+  task.main = 'README'
+  task.title = 'jruby-quartz'
+  task.rdoc_dir = 'doc'
+  task.options << "--line-numbers" << "--inline-source"
+  task.rdoc_files.include('README', 'lib/**/*.rb')
+end
+
+specification = Gem::Specification.new do |s|
+	s.name   = "jruby-quartz"
+  s.summary = "Jruby-Quartz is a wrapper library for the Java based Quartz scheduling framework."
+	s.version = "0.1"
+	s.author = 'Nick Zalabak'
+	s.description = "Jruby-Quartz is a wrapper library for the Java based Quartz scheduling framework."
+	s.email = 'nick@controlaltcreate.com'
+  s.homepage = 'http://techwhizbang.com'
+  s.rubyforge_project = 'Jruby-Quartz'
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README']
+  s.rdoc_options << '--title' << 'Jruby-Quartz' << '--main' << 'README' << '--line-numbers'
+
+  s.autorequire = 'jruby-quartz'
+  s.files = FileList['{lib,test}/**/*.rb', 'LICENSE', 'README', 'Rakefile'].to_a
+	s.test_file = "test/all_tests.rb"
+end
+
+Rake::GemPackageTask.new(specification) do |package|
+  package.need_zip = false
+  package.need_tar = false
+end

data/test/all_tests.rb

@@ -0,0 +1 @@
+Dir['**/*_test.rb'].each { |test_case| require test_case }

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification 
+name: techwhizbang-jruby-quartz
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Nick Zalabak
+autorequire: jruby-quartz
+bindir: bin
+cert_chain: []
+
+date: 2009-02-05 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Jruby-Quartz is a wrapper library for the Java based Quartz scheduling framework.
+email: nick@controlaltcreate.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- "{lib,test}/**/*.rb"
+- LICENSE
+- README
+- Rakefile
+has_rdoc: true
+homepage: http://techwhizbang.com
+post_install_message: 
+rdoc_options: 
+- --title
+- Jruby-Quartz
+- --main
+- README
+- --line-numbers
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A JRuby implementation of the Quartz scheduling framework that makes it easy to integrate into Ruby and Rails based projects.
+test_files: 
+- test/all_tests.rb