ResourceUtils (Spring Framework API)

java.lang.ObjectSE
- org.springframework.util.ResourceUtils

```
public abstract class ResourceUtils
extends ObjectSE
```
リソースの場所をファイルシステム内のファイルに解決するユーティリティメソッド。主にフレームワーク内での内部使用向け。
コアパッケージで Spring のリソース抽象化を使用して、あらゆる種類のファイルリソースを統一的に処理することを検討してください。ResourceLoader の getResource() メソッドは、任意の場所を Resource オブジェクトに解決できます。これにより、getFile() メソッドを介してファイルシステムで java.io.File を取得できます。
導入:
1.1.5
作成者:
Juergen Hoeller
関連事項:
Resource, ClassPathResource, FileSystemResource, UrlResource, ResourceLoader

フィールドサマリー

フィールド
修飾子と型	フィールドと説明
`static StringSE`	`CLASSPATH_URL_PREFIX` クラスパスからロードするための擬似 URL プレフィックス: "classpath:"。
`static StringSE`	`FILE_URL_PREFIX` ファイルシステムからロードするための URL プレフィックス: "file:"。
`static StringSE`	`JAR_FILE_EXTENSION` 通常の jar ファイルのファイル拡張子: ".jar"。
`static StringSE`	`JAR_URL_PREFIX` jar ファイルからロードするための URL プレフィックス: "jar:"。
`static StringSE`	`JAR_URL_SEPARATOR` JAR URL と JAR 内のファイルパスの区切り文字: "!/"。
`static StringSE`	`URL_PROTOCOL_FILE` ファイルシステム内のファイルの URL プロトコル: "file"。
`static StringSE`	`URL_PROTOCOL_JAR` jar ファイルからのエントリの URL プロトコル: "jar"。
`static StringSE`	`URL_PROTOCOL_VFS` 一般的な JBoss VFS リソースの URL プロトコル: "vfs"。
`static StringSE`	`URL_PROTOCOL_VFSFILE` JBoss ファイルシステムリソースの URL プロトコル: "vfsfile"。
`static StringSE`	`URL_PROTOCOL_VFSZIP` JBoss jar ファイルからのエントリの URL プロトコル: "vfszip"。
`static StringSE`	`URL_PROTOCOL_WAR` war ファイルからのエントリの URL プロトコル: "war"。
`static StringSE`	`URL_PROTOCOL_WSJAR` WebSphere jar ファイルからのエントリの URL プロトコル: "wsjar"。
`static StringSE`	`URL_PROTOCOL_ZIP` zip ファイルからのエントリの URL プロトコル: "zip"。
`static StringSE`	`WAR_URL_PREFIX` Tomcat の war ファイルからロードするための URL プレフィックス: "war:"。
`static StringSE`	`WAR_URL_SEPARATOR` Tomcat の WAR URL と jar パーツ間の特別な区切り文字。

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
ResourceUtils()

コンストラクター
コンストラクターと説明
`ResourceUtils()`

メソッドのサマリー

すべてのメソッド静的メソッド具象メソッド
修飾子と型	メソッドと説明
`static URLSE`	`extractArchiveURL(URLSE jarUrl)` 指定された jar/war URL（jar ファイル内のリソースまたは jar ファイル自体を指す場合があります）から最も外側のアーカイブの URL を抽出します。
`static URLSE`	`extractJarFileURL(URLSE jarUrl)` 指定された URL（jar ファイル内のリソースまたは jar ファイル自体を指している場合があります）から実際の jar ファイルの URL を抽出します。
`static FileSE`	`getFile(StringSE resourceLocation)` 指定されたリソースの場所を `java.io.File` に解決します。
`static FileSE`	`getFile(URISE resourceUri)` 指定されたリソース URI を `java.io.File` に解決します。
`static FileSE`	`getFile(URISE resourceUri, StringSE description)` 指定されたリソース URI を `java.io.File` に解決します。
`static FileSE`	`getFile(URLSE resourceUrl)` 指定されたリソース URL を `java.io.File` に解決します。
`static FileSE`	`getFile(URLSE resourceUrl, StringSE description)` 指定されたリソース URL を `java.io.File` に解決します。
`static URLSE`	`getURL(StringSE resourceLocation)` 指定されたリソースの場所を `java.net.URL` に解決します。
`static boolean`	`isFileURL(URLSE url)` 指定された URL がファイルシステム内のリソース、つまり
`static boolean`	`isJarFileURL(URLSE url)` 指定された URL が jar ファイル自体を指しているかどうか、つまり、プロトコル "file" を持ち、".jar" 拡張子で終わるかどうかを判別します。
`static boolean`	`isJarURL(URLSE url)` 指定された URL が jar ファイル内のリソースを指しているかどうかを判別します。
`static boolean`	`isUrl(StringSE resourceLocation)` 指定されたリソースの場所が URL であるかどうかを返します: 特別な「クラスパス」擬似 URL または標準 URL。
`static URISE`	`toURI(StringSE location)` 最初にスペースを "%20" URI エンコーディングに置き換えて、指定されたロケーション文字列の URI インスタンスを作成します。
`static URISE`	`toURI(URLSE url)` 最初にスペースを "%20" URI エンコーディングに置き換えて、指定された URL の URI インスタンスを作成します。
`static void`	`useCachesIfNecessary(URLConnectionSE con)` 指定された接続に `"useCaches"`SE フラグを設定します。`false` を優先しますが、JNLP ベースのリソースの場合はフラグを `true` のままにします。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- フィールドの詳細
  - CLASSPATH_URL_PREFIX
```
public static final StringSE CLASSPATH_URL_PREFIX
```
    クラスパスからロードするための擬似 URL プレフィックス: "classpath:"。
    関連事項:
    定数フィールド値
  - FILE_URL_PREFIX
```
public static final StringSE FILE_URL_PREFIX
```
    ファイルシステムからロードするための URL プレフィックス: "file:"。
    関連事項:
    定数フィールド値
  - JAR_URL_PREFIX
```
public static final StringSE JAR_URL_PREFIX
```
    jar ファイルからロードするための URL プレフィックス: "jar:"。
    関連事項:
    定数フィールド値
  - WAR_URL_PREFIX
```
public static final StringSE WAR_URL_PREFIX
```
    Tomcat の war ファイルからロードするための URL プレフィックス: "war:"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_FILE
```
public static final StringSE URL_PROTOCOL_FILE
```
    ファイルシステム内のファイルの URL プロトコル: "file"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_JAR
```
public static final StringSE URL_PROTOCOL_JAR
```
    jar ファイルからのエントリの URL プロトコル: "jar"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_WAR
```
public static final StringSE URL_PROTOCOL_WAR
```
    war ファイルからのエントリの URL プロトコル: "war"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_ZIP
```
public static final StringSE URL_PROTOCOL_ZIP
```
    zip ファイルからのエントリの URL プロトコル: "zip"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_WSJAR
```
public static final StringSE URL_PROTOCOL_WSJAR
```
    WebSphere jar ファイルからのエントリの URL プロトコル: "wsjar"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_VFSZIP
```
public static final StringSE URL_PROTOCOL_VFSZIP
```
    JBoss jar ファイルからのエントリの URL プロトコル: "vfszip"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_VFSFILE
```
public static final StringSE URL_PROTOCOL_VFSFILE
```
    JBoss ファイルシステムリソースの URL プロトコル: "vfsfile"。
    関連事項:
    定数フィールド値
  - URL_PROTOCOL_VFS
```
public static final StringSE URL_PROTOCOL_VFS
```
    一般的な JBoss VFS リソースの URL プロトコル: "vfs"。
    関連事項:
    定数フィールド値
  - JAR_FILE_EXTENSION
```
public static final StringSE JAR_FILE_EXTENSION
```
    通常の jar ファイルのファイル拡張子: ".jar"。
    関連事項:
    定数フィールド値
  - JAR_URL_SEPARATOR
```
public static final StringSE JAR_URL_SEPARATOR
```
    JAR URL と JAR 内のファイルパスの区切り文字: "!/"。
    関連事項:
    定数フィールド値
  - WAR_URL_SEPARATOR
```
public static final StringSE WAR_URL_SEPARATOR
```
    Tomcat の WAR URL と jar パーツ間の特別な区切り文字。
    関連事項:
    定数フィールド値
- コンストラクターの詳細
  - ResourceUtils
```
public ResourceUtils()
```
- メソッドの詳細
  - isUrl
```
public static boolean isUrl(@Nullable
                            StringSE resourceLocation)
```
    指定されたリソースの場所が URL であるかどうかを返します: 特別な「クラスパス」擬似 URL または標準 URL。
    パラメーター:
    resourceLocation - チェックする文字列
    戻り値:
    場所が URL として適格かどうか
    関連事項:
    CLASSPATH_URL_PREFIX, URLSE
  - getURL
```
public static URLSE getURL(StringSE resourceLocation)
                  throws FileNotFoundExceptionSE
```
    指定されたリソースの場所を java.net.URL に解決します。
    URL が実際に存在するかどうかはチェックしません。指定された場所が対応する URL を返すだけです。
    パラメーター:
    resourceLocation - 解決するリソースの場所: "classpath:" 疑似 URL、"file:" URL、またはプレーンファイルパス
    戻り値:
    対応する URL オブジェクト
    例外:
    FileNotFoundExceptionSE - リソースを URL に解決できない場合
  - getFile
```
public static FileSE getFile(StringSE resourceLocation)
                    throws FileNotFoundExceptionSE
```
    指定されたリソースの場所を java.io.File、つまりファイルシステム内のファイルに解決します。
    ファイルが実際に存在するかどうかはチェックしません。指定された場所に対応する File を返すだけです。
    パラメーター:
    resourceLocation - 解決するリソースの場所: "classpath:" 疑似 URL、"file:" URL、またはプレーンファイルパス
    戻り値:
    対応する File オブジェクト
    例外:
    FileNotFoundExceptionSE - リソースがファイルシステム内のファイルに解決できない場合
  - getFile
```
public static FileSE getFile(URLSE resourceUrl)
                    throws FileNotFoundExceptionSE
```
    指定されたリソース URL を java.io.File に、つまりファイルシステム内のファイルに解決します。
    パラメーター:
    resourceUrl - 解決するリソース URL
    戻り値:
    対応する File オブジェクト
    例外:
    FileNotFoundExceptionSE - URL をファイルシステム内のファイルに解決できない場合
  - getFile
```
public static FileSE getFile(URLSE resourceUrl,
                           StringSE description)
                    throws FileNotFoundExceptionSE
```
    指定されたリソース URL を java.io.File に、つまりファイルシステム内のファイルに解決します。
    パラメーター:
    resourceUrl - 解決するリソース URL
    description - URL が作成された元のリソースの説明 (たとえば、クラスパスの場所)
    戻り値:
    対応する File オブジェクト
    例外:
    FileNotFoundExceptionSE - URL をファイルシステム内のファイルに解決できない場合
  - getFile
```
public static FileSE getFile(URISE resourceUri)
                    throws FileNotFoundExceptionSE
```
    指定されたリソース URI を java.io.File、つまりファイルシステム内のファイルに解決します。
    パラメーター:
    resourceUri - 解決するリソース URI
    戻り値:
    対応する File オブジェクト
    例外:
    FileNotFoundExceptionSE - URL をファイルシステム内のファイルに解決できない場合
    導入:
    2.5
  - getFile
```
public static FileSE getFile(URISE resourceUri,
                           StringSE description)
                    throws FileNotFoundExceptionSE
```
    指定されたリソース URI を java.io.File、つまりファイルシステム内のファイルに解決します。
    パラメーター:
    resourceUri - 解決するリソース URI
    description - URI が作成された元のリソースの説明 (たとえば、クラスパスの場所)
    戻り値:
    対応する File オブジェクト
    例外:
    FileNotFoundExceptionSE - URL をファイルシステム内のファイルに解決できない場合
    導入:
    2.5
  - isFileURL
```
public static boolean isFileURL(URLSE url)
```
    指定された URL がファイルシステムのリソースを指しているかどうか、つまりプロトコル "file"、"vfsfile"、"vfs" を持っているかどうかを確認します。
    パラメーター:
    url - チェックする URL
    戻り値:
    URL がファイルシステム URL として識別されているかどうか
  - isJarURL
```
public static boolean isJarURL(URLSE url)
```
    指定された URL が jar ファイル内のリソースを指しているかどうかを判別します。つまり、プロトコルは "jar"、"war"、「 "zip"、"vfszip"、または "wsjar" です。
    パラメーター:
    url - チェックする URL
    戻り値:
    URL が JAR URL として識別されているかどうか
  - isJarFileURL
```
public static boolean isJarFileURL(URLSE url)
```
    指定された URL が jar ファイル自体を指しているかどうか、つまり、プロトコル "file" を持ち、".jar" 拡張子で終わるかどうかを判別します。
    パラメーター:
    url - チェックする URL
    戻り値:
    URL が JAR ファイル URL として識別されているかどうか
    導入:
    4.1
  - extractJarFileURL
```
public static URLSE extractJarFileURL(URLSE jarUrl)
                             throws MalformedURLExceptionSE
```
    指定された URL（jar ファイル内のリソースまたは jar ファイル自体を指している場合があります）から実際の jar ファイルの URL を抽出します。
    パラメーター:
    jarUrl - 元の URL
    戻り値:
    実際の jar ファイルの URL
    例外:
    MalformedURLExceptionSE - 有効な jar ファイルの URL を抽出できなかった場合
  - extractArchiveURL
```
public static URLSE extractArchiveURL(URLSE jarUrl)
                             throws MalformedURLExceptionSE
```
    指定された jar/war URL（jar ファイル内のリソースまたは jar ファイル自体を指す場合があります）から最も外側のアーカイブの URL を抽出します。
    war ファイル内にネストされた jar ファイルの場合、これは war ファイルへの URL を返します。これは、ファイルシステムで解決可能なファイルであるためです。
    パラメーター:
    jarUrl - 元の URL
    戻り値:
    実際の jar ファイルの URL
    例外:
    MalformedURLExceptionSE - 有効な jar ファイルの URL を抽出できなかった場合
    導入:
    4.1.8
    関連事項:
    extractJarFileURL(URL)
  - toURI
```
public static URISE toURI(URLSE url)
                 throws URISyntaxExceptionSE
```
    最初にスペースを "%20" URI エンコーディングに置き換えて、指定された URL の URI インスタンスを作成します。
    パラメーター:
    url - URI インスタンスに変換する URL
    戻り値:
    URI インスタンス
    例外:
    URISyntaxExceptionSE - URL が有効な URI ではなかった場合
    関連事項:
    URL.toURI()SE
  - toURI
```
public static URISE toURI(StringSE location)
                 throws URISyntaxExceptionSE
```
    最初にスペースを "%20" URI エンコーディングに置き換えて、指定されたロケーション文字列の URI インスタンスを作成します。
    パラメーター:
    location - URI インスタンスに変換する場所の文字列
    戻り値:
    URI インスタンス
    例外:
    URISyntaxExceptionSE - 場所が有効な URI ではなかった場合
  - useCachesIfNecessary
```
public static void useCachesIfNecessary(URLConnectionSE con)
```
    指定された接続に "useCaches"SE フラグを設定します。false を優先しますが、JNLP ベースのリソースの場合はフラグを true のままにします。
    パラメーター:
    con - フラグを設定する URLConnection

クラス ResourceUtils

フィールドサマリー

コンストラクターのサマリー

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

CLASSPATH_URL_PREFIX

FILE_URL_PREFIX

JAR_URL_PREFIX

WAR_URL_PREFIX

URL_PROTOCOL_FILE

URL_PROTOCOL_JAR

URL_PROTOCOL_WAR

URL_PROTOCOL_ZIP

URL_PROTOCOL_WSJAR

URL_PROTOCOL_VFSZIP

URL_PROTOCOL_VFSFILE

URL_PROTOCOL_VFS

JAR_FILE_EXTENSION

JAR_URL_SEPARATOR

WAR_URL_SEPARATOR

コンストラクターの詳細

ResourceUtils

メソッドの詳細

isUrl

getURL

getFile

getFile

getFile

getFile

getFile

isFileURL

isJarURL

isJarFileURL

extractJarFileURL

extractArchiveURL

toURI

toURI

useCachesIfNecessary