= Springy -- Configure Spring contexts with JRuby

Springy lets you use a simple Domain Specific Language (DSL) based on JRuby to wire up your Spring context. See {Wiring up Spring with JRuby}[http://www.trampolinesystems.com/weblog/wiring-up-spring-with-jruby] for an introduction.

== Dependencies

Springy requires {JRuby}[http://jruby.codehaus.org] (1.0), {Spring 2.0}[http://www.springframework.org] and the {Bean Scripting Framework}[http://jakarta.apache.org/bsf/].

== Usage

You need to add springy.jar, bsf.jar and jruby-1.0.jar to your classpath. Create your context definition and put it somewhere in your classpath. To actually create the context do:

import org.springframework.core.io.Resource; import springy.context.BSFSpringyContext;

// ... Resource r = new ClassPathResource("/path/to/context_definition.rb"); ApplicationContext ctxt = new SpringyContext(r);

Object myBean = ctxt.getBean("myBean");

=== Serializing context to XML

String serialized = new SpringyContext(r).getContextAsXml();

=== Advanced usage with existing JRuby runtime

import org.springframework.core.io.Resource; import springy.context.RuntimeSpringyContext; import org.jruby.Ruby;

// ... Resource r = new ClassPathResource("/path/to/context_definition.rb"); Ruby runtime = Ruby.getDefaultInstance();

ApplicationContext ctxt = new RuntimeSpringyContext(runtime, r);

=== Examples

See the {test cases}[http://svn.trampolinesystems.com/springy/trunk/testsrc/springy/], especially the Ruby context {context.rb}[http://svn.trampolinesystems.com/springy/trunk/testsrc/springy/context.rb] and its XML equivalent {context.xml}[http://svn.trampolinesystems.com/springy/trunk/testsrc/springy/context.xml].

== Building

To build Springy from the source, you need need {Maven}[http://maven.apache.org/]. Alternatively you can use Rake plus the {Jerbil}[http://code.trampolinesystems.com/jerbil] extensions. Once everything is installed, do

% m2 package (maven)
% rake dist  (jerbil)

in the toplevel directory.

== Stuff

FAQ[http://code.trampolinesystems.com/springy/wiki/FAQ].

Contact: mailto:[email protected]

Homepage: http://code.trampolinesystems.com/springy

== License

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.