org.exolab.castor.xml.util.resolvers

Class ResolveHelpers

java.lang.Object

org.exolab.castor.xml.util.resolvers.ResolveHelpers

public final class ResolveHelpers
extends Object

Some helpers used by the resolver commands. This is a utility class which is NOT meant to be instantiated.

Since:

1.2

Version:

$Revision$ $Date$

Author:

Joachim Grueneis

Method Summary

Modifier and Type	Method and Description
static ClassLoader	getClassLoader(ClassLoader loader) Gets the ClassLoader that's actually to be used (e.g.
static String	getPackageName(String className) Gets the package name of the given class name.
static String	getQualifiedFileName(String fileName, String packageName) Qualifies the given fileName with the given packageName and returns the resulting file path. If packageName is null or a zero-length String, this method will return fileName.
static Class	loadClass(ClassLoader classLoader, String className) Capsulates the ClassLoader.loadClass method to throw no exceptions but return null instead.
static boolean	namespaceEquals(String ns1, String ns2) Compares the two strings for equality.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getQualifiedFileName

public static String getQualifiedFileName(String fileName,
                                          String packageName)

Qualifies the given fileName with the given packageName and returns the resulting file path.
If packageName is null or a zero-length String, this method will return fileName.

Parameters:

fileName - The file name to be qualified.

packageName - The package name to be used for qualifying.

Returns:

The qualified file path.

getPackageName

public static String getPackageName(String className)

Gets the package name of the given class name.

Parameters:

className - The class name to retrieve the package name from.

Returns:

The package name or the empty String if className is null or does not contain a package.

namespaceEquals

public static boolean namespaceEquals(String ns1,
                                      String ns2)

Compares the two strings for equality. A Null and empty strings are considered equal.

Returns:

true if the two strings are considered equal.

getClassLoader

public static ClassLoader getClassLoader(ClassLoader loader)

Gets the ClassLoader that's actually to be used (e.g. for loading resources).
The actual ClassLoader is determined in the following way:

If the passed in "preferred" loader is not null, it is used. If the loader of this XMLClassDescriptor is not null, it is used. The context class loader of the current thread is used.

Parameters:

loader - The "preferred" ClassLoader.

Returns:

The loader to be used.

loadClass

public static Class loadClass(ClassLoader classLoader,
                              String className)

Capsulates the ClassLoader.loadClass method to throw no exceptions but return null instead. Any exception caught are logged with info severity.

Parameters:

classLoader - the class loader to use

className - the class to load

Returns:

the loaded Class or null