add more info on delegate classloader on IsolatedScriptingContainer

[skip ci]
jruby · Apr 8, 2016 · f4a2944 · f4a2944
1 parent 1910a86
commit f4a2944
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/core/src/main/java/org/jruby/embed/IsolatedScriptingContainer.java b/core/src/main/java/org/jruby/embed/IsolatedScriptingContainer.java
@@ -24,6 +24,14 @@
  * This container also sets option classloader.delegate to false, i.e. the JRubyClassloader 
  * for each runtime will lookup classes first on itself before looking into the parent 
  * classloader.
+ *
+ * WARNING: this can give problems when joda-time is used inside the 
+ *   JRubyClassloader or with current version of nokogiri (1.6.7.2) as it uses 
+ *   (sun-)jdk classes which conflicts with classes nokogiri loaded into the 
+ *   JRubyClassloader.
+ *
+ * With any classloader related problem the first thing is to try
+ * <code>container.getProvider().getRubyInstanceConfig().setClassloaderDelegate(true);</code> to solve it.
  */
 public class IsolatedScriptingContainer extends ScriptingContainer {