クラス ResourceUtils

メソッドの詳細

• isUrl

  public static boolean isUrl(@Nullable StringSE resourceLocation)

  指定されたリソースの場所が URL であるかどうかを返します: 特別な「クラスパス」擬似 URL または標準 URL。

  パラメーター:

  resourceLocation - チェックする文字列

  戻り値:

  場所が URL として適格かどうか

  関連事項:

  • CLASSPATH_URL_PREFIX
  • URLSE
  • toURL(String)

• getURL

  public static URLSE getURL(StringSE resourceLocation) throws FileNotFoundExceptionSE

  指定されたリソースの場所を java.net.URL に解決します。

  URL が実際に存在するかどうかはチェックしません。指定された場所が対応する URL を返すだけです。

  パラメーター:

  resourceLocation - 解決するリソースの場所: "classpath:" 疑似 URL、"file:" URL、またはプレーンファイルパス

  戻り値:

  対応する URL オブジェクト

  例外:

  FileNotFoundExceptionSE - リソースを URL に解決できない場合

  関連事項:

  • toURL(String)

• getFile

  public static FileSE getFile(StringSE resourceLocation) throws FileNotFoundExceptionSE

  指定されたリソースの場所を java.io.File、つまりファイルシステム内のファイルに解決します。

  ファイルが実際に存在するかどうかはチェックしません。指定された場所に対応する File を返すだけです。

  パラメーター:

  resourceLocation - 解決するリソースの場所: "classpath:" 疑似 URL、"file:" URL、またはプレーンファイルパス

  戻り値:

  対応する File オブジェクト

  例外:

  FileNotFoundExceptionSE - リソースがファイルシステム内のファイルに解決できない場合

  関連事項:

  • getFile(URL)

• getFile

  public static FileSE getFile(URLSE resourceUrl) throws FileNotFoundExceptionSE

  指定されたリソース URL を java.io.File に、つまりファイルシステム内のファイルに解決します。

  パラメーター:

  resourceUrl - 解決するリソース URL

  戻り値:

  対応する File オブジェクト

  例外:

  FileNotFoundExceptionSE - URL をファイルシステム内のファイルに解決できない場合

  関連事項:

  • getFile(URL, String)

• 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(URI, String)

• 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(URL)

• isJarURL

  public static boolean isJarURL(URLSE url)

  指定された URL が jar ファイル内のリソースを指しているかどうかを判断します。たとえば、URL にプロトコル "jar"、"war"、"zip"、"vfszip"、"wsjar" が含まれているかどうか。

  パラメーター:

  url - チェックする URL

  戻り値:

  URL が JAR URL として識別されているかどうか

  関連事項:

  • isJarFileURL(URL)

• isJarFileURL

  public static boolean isJarFileURL(URLSE url)

  指定された URL が jar ファイル自体を指しているかどうか、つまり、プロトコル "file" を持ち、".jar" 拡張子で終わるかどうかを判別します。

  パラメーター:

  url - チェックする URL

  戻り値:

  URL が JAR ファイル URL として識別されているかどうか

  導入:

  4.1

  関連事項:

  • extractJarFileURL(URL)

• extractJarFileURL

  public static URLSE extractJarFileURL(URLSE jarUrl) throws MalformedURLExceptionSE

  指定された URL（jar ファイル内のリソースまたは jar ファイル自体を指している場合があります）から実際の jar ファイルの URL を抽出します。

  パラメーター:

  jarUrl - 元の URL

  戻り値:

  実際の jar ファイルの URL

  例外:

  MalformedURLExceptionSE - 有効な jar ファイルの URL を抽出できなかった場合

  関連事項:

  • extractArchiveURL(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()
  • toURI(String)

• toURI

  public static URISE toURI(StringSE location) throws URISyntaxExceptionSE

  最初にスペースを "%20" URI エンコーディングに置き換えて、指定されたロケーション文字列の URI インスタンスを作成します。

  パラメーター:

  location - URI インスタンスに変換する場所の文字列

  戻り値:

  URI インスタンス

  例外:

  URISyntaxExceptionSE - 場所が有効な URI ではなかった場合

  関連事項:

  • toURI(URL)

• toURL

  public static URLSE toURL(StringSE location) throws MalformedURLExceptionSE

  URI の構築と URL 変換を経て、指定された場所の文字列のクリーンな URL インスタンスを作成します。

  パラメーター:

  location - URL インスタンスに変換する場所の文字列

  戻り値:

  URL インスタンス

  例外:

  MalformedURLExceptionSE - 場所が有効な URL ではなかった場合

  導入:

  6.0

  関連事項:

  • URI.toURL()
  • toURI(String)

• toRelativeURL

  public static URLSE toRelativeURL(URLSE root, StringSE relativePath) throws MalformedURLExceptionSE

  URI の構築と URL 変換を経て、指定されたルート URL と相対パスのクリーンな URL インスタンスを作成します。

  パラメーター:

  root - 開始するルート URL

  relativePath - 適用する相対パス

  戻り値:

  相対 URL インスタンス

  例外:

  MalformedURLExceptionSE - 最終結果が有効な URL でない場合

  導入:

  6.0

  関連事項:

  • toURL(String)
  • StringUtils.applyRelativePath(java.lang.String, java.lang.String)

• useCachesIfNecessary

  public static void useCachesIfNecessary(URLConnectionSE con)

  指定された接続に "useCaches"SE フラグを設定します。false を優先しますが、フラグを jar リソースの JVM デフォルト値 (通常は true) のままにします。

  パラメーター:

  con - フラグを設定する URLConnection

  関連事項:

  • URLConnection.setUseCaches(boolean)SE