org.seasar.framework.util
クラス ResourcesUtil

java.lang.Object
  org.seasar.framework.util.ResourcesUtil

public class ResourcesUtil

extends java.lang.Object

ファイルシステム上やJarファイル中に展開されているリソースの集まりを扱うユーティリティクラスです。

次のプロトコルをサポートしています。

• file
• jar
• wsjar(WebShpere独自プロトコル、jarの別名)
• zip(WebLogic独自プロトコル)
• code-source(Oracle AS(OC4J)独自プロトコル)
• vfsfile(JBossAS5独自プロトコル、fileの別名)
• vfszip(JBossAS5独自プロトコル)

作成者:

koichik

関連項目:

URLUtil.toCanonicalProtocol(String)

入れ子クラスの概要

static class	ResourcesUtil.FileSystemResources ファイルシステム上のリソースの集まりを扱うオブジェクトです。
static class	ResourcesUtil.JarFileResources Jarファイル中のリソースの集まりを扱うオブジェクトです。
static interface	ResourcesUtil.Resources リソースの集まりを表すオブジェクトです。
static interface	ResourcesUtil.ResourcesFactory Resourcesのインスタンスを作成するファクトリです。
static class	ResourcesUtil.VfsZipResources JBossAS5のvfszipプロトコルで表されるリソースの集まりを扱うオブジェクトです。

フィールドの概要

protected static ResourcesUtil.Resources[]	EMPTY_ARRAY 空のResourcesUtil.Resourcesの配列です。
protected static java.util.Map	resourcesTypeFactories URLのプロトコルをキー、ResourceTypeFactoryを値とするマッピングです。

コンストラクタの概要

ResourcesUtil()

メソッドの概要

static void	addResourcesFactory(java.lang.String protocol, ResourcesUtil.ResourcesFactory factory) ResourcesUtil.ResourcesFactoryを追加します。
protected static java.io.File	getBaseDir(java.net.URL url, java.lang.String baseName) ファイルを表すURLからルートパッケージの上位となるベースディレクトリを求めて返します。
static ResourcesUtil.Resources	getResourcesType(java.lang.Class referenceClass) 指定のクラスを基点とするリソースの集まりを扱うResourcesUtil.Resourcesを返します。
static ResourcesUtil.Resources	getResourcesType(java.lang.String rootDir) 指定のディレクトリを基点とするリソースの集まりを扱うResourceTypeを返します。
protected static ResourcesUtil.Resources	getResourcesType(java.net.URL url, java.lang.String rootPackage, java.lang.String rootDir) URLを扱うResourcesUtil.Resourcesを作成して返します。
static ResourcesUtil.Resources[]	getResourcesTypes(java.lang.String rootPackage) 指定のルートパッケージを基点とするリソースの集まりを扱うResourceTypeの配列を返します。
protected static java.lang.String	toClassFile(java.lang.String className) クラス名をクラスファイルのパス名に変換して返します。
protected static java.lang.String	toDirectoryName(java.lang.String packageName) パッケージ名をディレクトリ名に変換して返します。

クラス java.lang.Object から継承したメソッド

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

フィールドの詳細

EMPTY_ARRAY

protected static final ResourcesUtil.Resources[] EMPTY_ARRAY

空のResourcesUtil.Resourcesの配列です。

resourcesTypeFactories

protected static final java.util.Map resourcesTypeFactories

URLのプロトコルをキー、ResourceTypeFactoryを値とするマッピングです。

コンストラクタの詳細

ResourcesUtil

public ResourcesUtil()

メソッドの詳細

addResourcesFactory

public static void addResourcesFactory(java.lang.String protocol,
                                       ResourcesUtil.ResourcesFactory factory)

ResourcesUtil.ResourcesFactoryを追加します。

パラメータ:

protocol - URLのプロトコル

factory - プロトコルに対応するResourcesUtil.Resourcesのファクトリ

getResourcesType

public static ResourcesUtil.Resources getResourcesType(java.lang.Class referenceClass)

指定のクラスを基点とするリソースの集まりを扱うResourcesUtil.Resourcesを返します。

このメソッドが返すResourcesUtil.Resourcesは、指定されたクラスをFQNで参照可能なパスをルートとします。 例えば指定されたクラスが foo.Barで、そのクラスファイルがclasses/foo/Bar.classの場合、 このメソッドが返すResourcesUtil.Resourcesはclassesディレクトリ以下のリソースの集合を扱います。

パラメータ:

referenceClass - 基点となるクラス

戻り値:

指定のクラスを基点とするリソースの集まりを扱うResourcesUtil.Resources

getResourcesType

public static ResourcesUtil.Resources getResourcesType(java.lang.String rootDir)

指定のディレクトリを基点とするリソースの集まりを扱うResourceTypeを返します。

パラメータ:

rootDir - ルートディレクトリ

戻り値:

指定のディレクトリを基点とするリソースの集まりを扱うResourceType

getResourcesTypes

public static ResourcesUtil.Resources[] getResourcesTypes(java.lang.String rootPackage)

指定のルートパッケージを基点とするリソースの集まりを扱うResourceTypeの配列を返します。

パラメータ:

rootPackage - ルートパッケージ

戻り値:

指定のルートパッケージを基点とするリソースの集まりを扱うResourceTypeの配列

getResourcesType

protected static ResourcesUtil.Resources getResourcesType(java.net.URL url,
                                                          java.lang.String rootPackage,
                                                          java.lang.String rootDir)

URLを扱うResourcesUtil.Resourcesを作成して返します。

URLのプロトコルが未知の場合はnullを返します。

パラメータ:

url - リソースのURL

rootPackage - ルートパッケージ

rootDir - ルートディレクトリ

戻り値:

URLを扱うResourcesUtil.Resources

toDirectoryName

protected static java.lang.String toDirectoryName(java.lang.String packageName)

パッケージ名をディレクトリ名に変換して返します。

パラメータ:

packageName - パッケージ名

戻り値:

ディレクトリ名

toClassFile

protected static java.lang.String toClassFile(java.lang.String className)

クラス名をクラスファイルのパス名に変換して返します。

パラメータ:

className - クラス名

戻り値:

クラスファイルのパス名

getBaseDir

protected static java.io.File getBaseDir(java.net.URL url,
                                         java.lang.String baseName)

ファイルを表すURLからルートパッケージの上位となるベースディレクトリを求めて返します。

パラメータ:

url - ファイルを表すURL

baseName - ベース名

戻り値:

ルートパッケージの上位となるベースディレクトリ