クラス UrlResource
- 実装されたすべてのインターフェース:
InputStreamSource
,Resource
- 既知の直属サブクラス
FileUrlResource
- 導入:
- 28.12.2003
- 作成者:
- Juergen Hoeller, Sam Brannen
- 関連事項:
コンストラクターのサマリー
コンストラクターコンストラクター説明UrlResource
(StringSE path) URI パスに基づいて新しいUrlResource
を作成します。UrlResource
(StringSE protocol, StringSE location) URI 仕様に基づいて新しいUrlResource
を作成します。UrlResource
(StringSE protocol, StringSE location, StringSE fragment) URI 仕様に基づいて新しいUrlResource
を作成します。UrlResource
(URISE uri) 指定された URI オブジェクトに基づいて新しいUrlResource
を作成します。UrlResource
(URLSE url) 指定された URL オブジェクトに基づいて新しいUrlResource
を作成します。方法の概要
修飾子と型メソッド説明createRelative
(StringSE relativePath) この実装はUrlResource
を作成し、相対パスを適応させるためにcreateRelativeURL(String)
に委譲します。protected URLSE
createRelativeURL
(StringSE relativePath) このデリゲートはjava.net.URL
を作成し、このリソース記述子の基になる URL のパスに相対する指定されたパスを適用します。protected void
リソースをフェッチする前に、指定されたURLConnection
SE をカスタマイズします。boolean
この実装は、基になる URL 参照を比較します。static UrlResource
指定された URL パスから新しいUrlResource
を作成します。static UrlResource
指定されたURI
SE から新しいUrlResource
を作成します。この実装は、URL を含む説明を返します。getFile()
この実装は、ファイルシステム内のファイルを参照する場合、基になる URL/URI の File 参照を返します。この実装は、この URL が参照するファイルの URL デコードされた名前を返します。この実装は、指定された URL の InputStream を開きます。getURI()
この実装は、可能であれば、基になる URI を直接返します。getURL()
この実装は、基になる URL 参照を返します。int
hashCode()
この実装は、基になる URL 参照のハッシュコードを返します。boolean
isFile()
この実装は、常にfalse
を返します。クラス org.springframework.core.io.AbstractFileResolvingResource から継承されたメソッド
contentLength, customizeConnection, exists, getFile, getFileForLastModifiedCheck, isFile, isReadable, lastModified, readableChannel
クラス org.springframework.core.io.AbstractResource から継承されたメソッド
isOpen, toString
クラス java.lang.ObjectSE から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, waitSE, waitSE
インターフェース org.springframework.core.io.Resource から継承されたメソッド
getContentAsByteArray, getContentAsString
コンストラクターの詳細
UrlResource
指定された URL オブジェクトに基づいて新しいUrlResource
を作成します。- パラメーター:
url
- URL- 関連事項:
UrlResource
指定された URI オブジェクトに基づいて新しいUrlResource
を作成します。- パラメーター:
uri
- URI- 例外:
MalformedURLExceptionSE
- 指定された URL パスが無効な場合- 導入:
- 2.5
UrlResource
URI パスに基づいて新しいUrlResource
を作成します。メモ: 指定されたパスは、必要に応じて事前にエンコードする必要があります。
- パラメーター:
path
- URI パス- 例外:
MalformedURLExceptionSE
- 指定された URI パスが無効な場合- 関連事項:
UrlResource
URI 仕様に基づいて新しいUrlResource
を作成します。指定された部分は、必要に応じて自動的にエンコードされます。
- パラメーター:
protocol
- 使用する URL プロトコル (たとえば、"jar" または "file" - コロンなし)。別名「スキーム」location
- 場所(たとえば、そのプロトコル内のファイルパス); 「スキーム固有の部分」とも呼ばれます- 例外:
MalformedURLExceptionSE
- 指定された URL 指定が有効でない場合- 関連事項:
UrlResource
public UrlResource(StringSE protocol, StringSE location, @Nullable StringSE fragment) throws MalformedURLExceptionSE URI 仕様に基づいて新しいUrlResource
を作成します。指定された部分は、必要に応じて自動的にエンコードされます。
- パラメーター:
protocol
- 使用する URL プロトコル (たとえば、"jar" または "file" - コロンなし)。別名「スキーム」location
- 場所(たとえば、そのプロトコル内のファイルパス); 「スキーム固有の部分」とも呼ばれますfragment
- その場所内のフラグメント (たとえば、HTML ページ上のアンカーは、次のように "#" 区切り文字の後に続きます。)- 例外:
MalformedURLExceptionSE
- 指定された URL 指定が有効でない場合- 関連事項:
メソッドの詳細
from
指定されたURI
SE から新しいUrlResource
を作成します。このファクトリメソッドは、
MalformedURLException
SE をキャッチしてUncheckedIOException
SE にラップして再スローするUrlResource(URI)
の便利な方法です。Stream
SE およびOptional
SE API での使用、またはチェック済みのIOException
SE が望ましくない場合のその他のシナリオでの使用に適しています。- パラメーター:
uri
- URI- 例外:
UncheckedIOExceptionSE
- 指定された URL パスが無効な場合- 導入:
- 6.0
- 関連事項:
from
指定された URL パスから新しいUrlResource
を作成します。このファクトリメソッドは、
MalformedURLException
SE をキャッチしてUncheckedIOException
SE にラップして再スローするUrlResource(String)
の便利な方法です。Stream
SE およびOptional
SE API での使用、またはチェック済みのIOException
SE が望ましくない場合のその他のシナリオでの使用に適しています。- パラメーター:
path
- URL パス- 例外:
UncheckedIOExceptionSE
- 指定された URL パスが無効な場合- 導入:
- 6.0
- 関連事項:
getInputStream
この実装は、指定された URL の InputStream を開きます。主に Windows で jar ファイルのロックを回避するために、
useCaches
フラグをfalse
に設定します。- 戻り値:
- 基になるリソースの入力ストリーム (
null
であってはなりません) - 例外:
FileNotFoundExceptionSE
- 基盤となるリソースが存在しない場合IOExceptionSE
- コンテンツストリームを開けなかった場合- 関連事項:
customizeConnection
クラスからコピーされた説明:AbstractFileResolvingResource
リソースをフェッチする前に、指定されたURLConnection
SE をカスタマイズします。ResourceUtils.useCachesIfNecessary(URLConnection)
を呼び出し、可能であればAbstractFileResolvingResource.customizeConnection(HttpURLConnection)
に委譲します。サブクラスでオーバーライドできます。- オーバーライド:
- クラス
AbstractFileResolvingResource
のcustomizeConnection
- パラメーター:
con
- カスタマイズする URLConnection- 例外:
IOExceptionSE
- URLConnection メソッドからスローされた場合
getURL
この実装は、基になる URL 参照を返します。- 次で指定:
- インターフェース
Resource
のgetURL
- オーバーライド:
- クラス
AbstractResource
のgetURL
getURI
この実装は、可能であれば、基になる URI を直接返します。- 次で指定:
- インターフェース
Resource
のgetURI
- オーバーライド:
- クラス
AbstractResource
のgetURI
- 例外:
IOExceptionSE
- リソースを URI として解決できない場合、つまりリソースが記述子として使用できない場合
isFile
public boolean isFile()クラスからコピーされた説明:AbstractResource
この実装は、常にfalse
を返します。- 次で指定:
- インターフェース
Resource
のisFile
- オーバーライド:
- クラス
AbstractFileResolvingResource
のisFile
- 関連事項:
getFile
この実装は、ファイルシステム内のファイルを参照する場合、基になる URL/URI の File 参照を返します。- 次で指定:
- インターフェース
Resource
のgetFile
- オーバーライド:
- クラス
AbstractFileResolvingResource
のgetFile
- 例外:
FileNotFoundExceptionSE
- リソースが絶対ファイルパスとして解決できない場合、つまりリソースがファイルシステムで使用できない場合IOExceptionSE
- 一般的な解決 / 読み取りエラーの場合- 関連事項:
createRelative
この実装はUrlResource
を作成し、相対パスを適応させるためにcreateRelativeURL(String)
に委譲します。- 次で指定:
- インターフェース
Resource
のcreateRelative
- オーバーライド:
- クラス
AbstractResource
のcreateRelative
- パラメーター:
relativePath
- 相対パス (このリソースに関連して)- 戻り値:
- 相対リソースのリソースハンドル
- 例外:
MalformedURLExceptionSE
- 関連事項:
createRelativeURL
このデリゲートはjava.net.URL
を作成し、このリソース記述子の基になる URL のパスに相対する指定されたパスを適用します。先頭のスラッシュは削除され、"#" 記号がエンコードされます。この方法は、6.1 の時点で結合されたパスを効果的にクリーンアップすることに注意してください。
getFilename
この実装は、この URL が参照するファイルの URL デコードされた名前を返します。- 次で指定:
- インターフェース
Resource
のgetFilename
- オーバーライド:
- クラス
AbstractResource
のgetFilename
- 関連事項:
getDescription
この実装は、URL を含む説明を返します。- 関連事項:
equals
この実装は、基になる URL 参照を比較します。- オーバーライド:
- クラス
AbstractResource
のequals
- 関連事項:
hashCode
public int hashCode()この実装は、基になる URL 参照のハッシュコードを返します。- オーバーライド:
- クラス
AbstractResource
のhashCode
- 関連事項: