Cactus 1.5 for J2EE API 1.2

Clover coverage report - Cactus 1.5 for J2EE API 1.2

Coverage timestamp: Wed Feb 18 2004 09:04:33 EST

FRAMES NO FRAMES

file stats:	LOC:	181		Methods:	4
	NCLOC:	58		Classes:	1

Source file

Conditionals

Statements

Methods

TOTAL

ClassLoaderUtils.java

 /*
  * ====================================================================
  *
  * The Apache Software License, Version 1.1
  *
  * Copyright (c) 2001-2003 The Apache Software Foundation.  All rights
  * reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  *
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  *
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in
  *    the documentation and/or other materials provided with the
  *    distribution.
  *
  * 3. The end-user documentation included with the redistribution, if
  *    any, must include the following acknowlegement:
  *       "This product includes software developed by the
  *        Apache Software Foundation (http://www.apache.org/)."
  *    Alternately, this acknowlegement may appear in the software itself,
  *    if and wherever such third-party acknowlegements normally appear.
  *
  * 4. The names "The Jakarta Project", "Cactus" and "Apache Software
  *    Foundation" must not be used to endorse or promote products
  *    derived from this software without prior written permission. For
  *    written permission, please contact apache@apache.org.
  *
  * 5. Products derived from this software may not be called "Apache"
  *    nor may "Apache" appear in their names without prior written
  *    permission of the Apache Group.
  *
  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  * SUCH DAMAGE.
  * ====================================================================
  *
  * This software consists of voluntary contributions made by many
  * individuals on behalf of the Apache Software Foundation.  For more
  * information on the Apache Software Foundation, please see
  * <http://www.apache.org/>.
  *
  */
 package org.apache.cactus.util;
 
 import java.util.Locale;
 import java.util.MissingResourceException;
 import java.util.PropertyResourceBundle;
 import java.util.ResourceBundle;
 
 /**
  * Utiliy methods related to class loading in a webapp environment.
  *
  * @author <a href="mailto:vmassol@apache.org">Vincent Massol</a>
  *
  * @version $Id: ClassLoaderUtils.java,v 1.7 2003/05/26 11:45:22 cmlenz Exp $
  */
 public class ClassLoaderUtils
 {
     /**
      * Try loading a class first by using the context class loader or by using
      * the classloader of the referrer class if the context classloader failed
      * to load the class.
      *
      * @param theClassName the name of the test class
      * @param theReferrer the class will be loaded using the classloader which
      *        has loaded this referrer class
      * @return the class object the test class to call
      * @exception ClassNotFoundException if the class cannot be loaded through
      *            either classloader
      */
     public static Class loadClass(String theClassName, Class theReferrer)
         throws ClassNotFoundException
     {
         // Get the class to call and build an instance of it.
         Class clazz = null;
 
         try
         {
             // try loading from webapp classloader first
             clazz = loadClassFromWebappClassLoader(theClassName, theReferrer);
         }
         catch (Throwable internalException)
         {
             // Then try first from Context class loader so that we can put the
             // Cactus jar as an external library.
             clazz = loadClassFromContextClassLoader(theClassName);
         }
 
         return clazz;
     }
 
     /**
      * Try loading class using the Context class loader.
      *
      * @param theClassName the class to load
      * @return the <code>Class</code> object for the class to load
      * @exception ClassNotFoundException if the class cannot be loaded through
      *            this class loader
      */
     public static Class loadClassFromContextClassLoader(String theClassName)
         throws ClassNotFoundException
     {
         return Class.forName(theClassName, true, 
             Thread.currentThread().getContextClassLoader());
     }
 
     /**
      * Try loading class using the Webapp class loader.
      *
      * @param theClassName the class to load
      * @param theReferrer the class will be loaded using the classloader which
      *        has loaded this referrer class
      * @return the <code>Class</code> object for the class to load
      * @exception ClassNotFoundException if the class cannot be loaded through
      *            this class loader
      */
     public static Class loadClassFromWebappClassLoader(String theClassName, 
         Class theReferrer) throws ClassNotFoundException
     {
         return Class.forName(theClassName, true, theReferrer.getClassLoader());
     }
 
     /**
      * Try loading a resource bundle from either the context class loader or
      * the
      *
      * @param theName the resource bundle name
      * @param theReferrer the resource bundle will be loaded using the
      *        classloader which has loaded this referrer class
      * @return the loaded resource bundle
      */
     public static ResourceBundle loadPropertyResourceBundle(String theName, 
         Class theReferrer)
     {
         ResourceBundle bundle;
 
         try
         {
             // Try to load from the referrer class loader first
             
             // Some JDK implementation will return "null" when calling
             // getClassLoader(), signalling that the classloader is the
             // bootstrap class loader. However, getBundle() does not support
             // passing null for the class loader, hence the following test.
             if (theReferrer.getClassLoader() == null)
             {
                 bundle = PropertyResourceBundle.getBundle(theName,
                     Locale.getDefault());
             }
             else
             {                       
                 bundle = PropertyResourceBundle.getBundle(theName,
                     Locale.getDefault(), theReferrer.getClassLoader());
             }
         }
         catch (MissingResourceException e)
         {
             // Then, try to load from context classloader
             bundle = PropertyResourceBundle.getBundle(theName, 
                 Locale.getDefault(), 
                 Thread.currentThread().getContextClassLoader());
         }
 
         return bundle;
     }
 }
 

1		/*
2		* ====================================================================
3		*
4		* The Apache Software License, Version 1.1
5		*
6		* Copyright (c) 2001-2003 The Apache Software Foundation. All rights
7		* reserved.
8		*
9		* Redistribution and use in source and binary forms, with or without
10		* modification, are permitted provided that the following conditions
11		* are met:
12		*
13		* 1. Redistributions of source code must retain the above copyright
14		* notice, this list of conditions and the following disclaimer.
15		*
16		* 2. Redistributions in binary form must reproduce the above copyright
17		* notice, this list of conditions and the following disclaimer in
18		* the documentation and/or other materials provided with the
19		* distribution.
20		*
21		* 3. The end-user documentation included with the redistribution, if
22		* any, must include the following acknowlegement:
23		* "This product includes software developed by the
24		* Apache Software Foundation (http://www.apache.org/)."
25		* Alternately, this acknowlegement may appear in the software itself,
26		* if and wherever such third-party acknowlegements normally appear.
27		*
28		* 4. The names "The Jakarta Project", "Cactus" and "Apache Software
29		* Foundation" must not be used to endorse or promote products
30		* derived from this software without prior written permission. For
31		* written permission, please contact apache@apache.org.
32		*
33		* 5. Products derived from this software may not be called "Apache"
34		* nor may "Apache" appear in their names without prior written
35		* permission of the Apache Group.
36		*
37		* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38		* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39		* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40		* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
41		* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42		* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43		* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44		* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45		* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46		* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47		* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48		* SUCH DAMAGE.
49		* ====================================================================
50		*
51		* This software consists of voluntary contributions made by many
52		* individuals on behalf of the Apache Software Foundation. For more
53		* information on the Apache Software Foundation, please see
54		* <http://www.apache.org/>.
55		*
56		*/
57		package org.apache.cactus.util;
58
59		import java.util.Locale;
60		import java.util.MissingResourceException;
61		import java.util.PropertyResourceBundle;
62		import java.util.ResourceBundle;
63
64		/**
65		* Utiliy methods related to class loading in a webapp environment.
66		*
67		* @author <a href="mailto:vmassol@apache.org">Vincent Massol</a>
68		*
69		* @version $Id: ClassLoaderUtils.java,v 1.7 2003/05/26 11:45:22 cmlenz Exp $
70		*/
71		public class ClassLoaderUtils
72		{
73		/**
74		* Try loading a class first by using the context class loader or by using
75		* the classloader of the referrer class if the context classloader failed
76		* to load the class.
77		*
78		* @param theClassName the name of the test class
79		* @param theReferrer the class will be loaded using the classloader which
80		* has loaded this referrer class
81		* @return the class object the test class to call
82		* @exception ClassNotFoundException if the class cannot be loaded through
83		* either classloader
84		*/
85	0	public static Class loadClass(String theClassName, Class theReferrer)
86		throws ClassNotFoundException
87		{
88		// Get the class to call and build an instance of it.
89	0	Class clazz = null;
90
91	0	try
92		{
93		// try loading from webapp classloader first
94	0	clazz = loadClassFromWebappClassLoader(theClassName, theReferrer);
95		}
96		catch (Throwable internalException)
97		{
98		// Then try first from Context class loader so that we can put the
99		// Cactus jar as an external library.
100	0	clazz = loadClassFromContextClassLoader(theClassName);
101		}
102
103	0	return clazz;
104		}
105
106		/**
107		* Try loading class using the Context class loader.
108		*
109		* @param theClassName the class to load
110		* @return the <code>Class</code> object for the class to load
111		* @exception ClassNotFoundException if the class cannot be loaded through
112		* this class loader
113		*/
114	0	public static Class loadClassFromContextClassLoader(String theClassName)
115		throws ClassNotFoundException
116		{
117	0	return Class.forName(theClassName, true,
118		Thread.currentThread().getContextClassLoader());
119		}
120
121		/**
122		* Try loading class using the Webapp class loader.
123		*
124		* @param theClassName the class to load
125		* @param theReferrer the class will be loaded using the classloader which
126		* has loaded this referrer class
127		* @return the <code>Class</code> object for the class to load
128		* @exception ClassNotFoundException if the class cannot be loaded through
129		* this class loader
130		*/
131	0	public static Class loadClassFromWebappClassLoader(String theClassName,
132		Class theReferrer) throws ClassNotFoundException
133		{
134	0	return Class.forName(theClassName, true, theReferrer.getClassLoader());
135		}
136
137		/**
138		* Try loading a resource bundle from either the context class loader or
139		* the
140		*
141		* @param theName the resource bundle name
142		* @param theReferrer the resource bundle will be loaded using the
143		* classloader which has loaded this referrer class
144		* @return the loaded resource bundle
145		*/
146	0	public static ResourceBundle loadPropertyResourceBundle(String theName,
147		Class theReferrer)
148		{
149	0	ResourceBundle bundle;
150
151	0	try
152		{
153		// Try to load from the referrer class loader first
154
155		// Some JDK implementation will return "null" when calling
156		// getClassLoader(), signalling that the classloader is the
157		// bootstrap class loader. However, getBundle() does not support
158		// passing null for the class loader, hence the following test.
159	0	if (theReferrer.getClassLoader() == null)
160		{
161	0	bundle = PropertyResourceBundle.getBundle(theName,
162		Locale.getDefault());
163		}
164		else
165		{
166	0	bundle = PropertyResourceBundle.getBundle(theName,
167		Locale.getDefault(), theReferrer.getClassLoader());
168		}
169		}
170		catch (MissingResourceException e)
171		{
172		// Then, try to load from context classloader
173	0	bundle = PropertyResourceBundle.getBundle(theName,
174		Locale.getDefault(),
175		Thread.currentThread().getContextClassLoader());
176		}
177
178	0	return bundle;
179		}
180		}
181