クラス UrlResource

メソッドの詳細

• from

  public static UrlResource from(URISE uri) throws UncheckedIOExceptionSE

  指定された URISE から新しい UrlResource を作成します。

  このファクトリメソッドは、MalformedURLExceptionSE をキャッチして UncheckedIOExceptionSE にラップして再スローする UrlResource(URI) の便利な方法です。StreamSE および OptionalSE API での使用、またはチェック済みの IOExceptionSE が望ましくない場合のその他のシナリオでの使用に適しています。

  パラメーター:

  uri - URI

  例外:

  UncheckedIOExceptionSE - 指定された URL パスが無効な場合

  導入:

  6.0

  関連事項:

  • UrlResource(URI)

• from

  public static UrlResource from(StringSE path) throws UncheckedIOExceptionSE

  指定された URL パスから新しい UrlResource を作成します。

  このファクトリメソッドは、MalformedURLExceptionSE をキャッチして UncheckedIOExceptionSE にラップして再スローする UrlResource(String) の便利な方法です。StreamSE および OptionalSE API での使用、またはチェック済みの IOExceptionSE が望ましくない場合のその他のシナリオでの使用に適しています。

  パラメーター:

  path - URL パス

  例外:

  UncheckedIOExceptionSE - 指定された URL パスが無効な場合

  導入:

  6.0

  関連事項:

  • UrlResource(String)

• setUseCaches

  public void setUseCaches(boolean useCaches)

  このリソースのすべての URLConnectionSE 操作に適用する、URLConnection.setUseCaches(boolean)SE の明示的なフラグを設定します。

  デフォルトでは、キャッシュは jar リソースにのみ適用されます。明示的に true フラグを指定するとすべてのリソースにキャッシュが適用され、明示的に false フラグを指定すると jar リソースのキャッシュも無効になります。

  導入:

  6.2.10

  関連事項:

  • ResourceUtils.useCachesIfNecessary(URLConnection)

• getInputStream

  public InputStreamSE getInputStream() throws IOExceptionSE

  この実装は、指定された URL の InputStream を開きます。

  戻り値:

  基になるリソースの入力ストリーム (null であってはなりません)

  例外:

  IOExceptionSE - コンテンツストリームを開けなかった場合

  関連事項:

  • URL.openConnection()
  • URLConnection.setUseCaches(boolean)SE
  • URLConnection.getInputStream()

• customizeConnection

  protected void customizeConnection(URLConnectionSE con) throws IOExceptionSE

  クラスからコピーされた説明: AbstractFileResolvingResource

  リソースをフェッチする前に、指定された URLConnectionSE をカスタマイズします。

  ResourceUtils.useCachesIfNecessary(URLConnection) を呼び出し、可能であれば AbstractFileResolvingResource.customizeConnection(HttpURLConnection) に委譲します。サブクラスでオーバーライドできます。

  オーバーライド:

  クラス AbstractFileResolvingResource の customizeConnection 

  パラメーター:

  con - カスタマイズする URLConnection

  例外:

  IOExceptionSE - URLConnection メソッドからスローされた場合

• getURL

  public URLSE getURL()

  この実装は、基になる URL 参照を返します。

  次で指定:

  インターフェース Resource の getURL 

  オーバーライド:

  クラス AbstractResource の getURL 

• getURI

  public URISE getURI() throws IOExceptionSE

  この実装は、可能であれば、基になる URI を直接返します。

  次で指定:

  インターフェース Resource の getURI 

  オーバーライド:

  クラス AbstractResource の getURI 

  例外:

  IOExceptionSE - リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合

• isFile

  public boolean isFile()

  クラスからコピーされた説明: AbstractResource

  この実装は、常に false を返します。

  次で指定:

  インターフェース Resource の isFile 

  オーバーライド:

  クラス AbstractFileResolvingResource の isFile 

  関連事項:

  • Resource.getFile()
  • Resource.getFilePath()

• getFile

  public FileSE getFile() throws IOExceptionSE

  この実装は、ファイルシステム内のファイルを参照する場合、基になる URL/URI の File 参照を返します。

  次で指定:

  インターフェース Resource の getFile 

  オーバーライド:

  クラス AbstractFileResolvingResource の getFile 

  例外:

  IOExceptionSE - 一般的な解決 / 読み取りエラーの場合

  関連事項:

  • ResourceUtils.getFile(java.net.URL, String)

• createRelative

  public Resource createRelative(StringSE relativePath) throws MalformedURLExceptionSE

  この実装は UrlResource を作成し、相対パスを適応させるために createRelativeURL(String) に委譲します。

  次で指定:

  インターフェース Resource の createRelative 

  オーバーライド:

  クラス AbstractResource の createRelative 

  パラメーター:

  relativePath - 相対パス (このリソースに関連して)

  戻り値:

  相対リソースのリソースハンドル

  例外:

  MalformedURLExceptionSE

  関連事項:

  • createRelativeURL(String)

• createRelativeURL

  protected URLSE createRelativeURL(StringSE relativePath) throws MalformedURLExceptionSE

  このデリゲートは java.net.URL を作成し、このリソース記述子の基になる URL のパスに相対する指定されたパスを適用します。

  先頭のスラッシュは削除され、"#" 記号がエンコードされます。この方法は、6.1 の時点で結合されたパスを効果的にクリーンアップすることに注意してください。

  例外:

  MalformedURLExceptionSE

  導入:

  5.2

  関連事項:

  • createRelative(String)
  • ResourceUtils.toRelativeURL(URL, String)

• getFilename

  public @Nullable StringSE getFilename()

  この実装は、この URL が参照するファイルの URL デコードされた名前を返します。

  次で指定:

  インターフェース Resource の getFilename 

  オーバーライド:

  クラス AbstractResource の getFilename 

  関連事項:

  • URL.getPath()
  • URLDecoder.decode(String, java.nio.charset.Charset)SE

• getDescription

  public StringSE getDescription()

  この実装は、URL を含む説明を返します。

  関連事項:

  • Object.toString()

• equals

  public boolean equals(@Nullable ObjectSE other)

  この実装は、基になる URL 参照を比較します。

  オーバーライド:

  クラス AbstractResource の equals 

  関連事項:

  • Resource.getDescription()

• hashCode

  public int hashCode()

  この実装は、基になる URL 参照のハッシュコードを返します。

  オーバーライド:

  クラス AbstractResource の hashCode 

  関連事項:

  • Resource.getDescription()