クラス FileUrlResource
java.lang.ObjectSE
org.springframework.core.io.AbstractResource
org.springframework.core.io.AbstractFileResolvingResource
org.springframework.core.io.UrlResource
org.springframework.core.io.FileUrlResource
- 実装されたすべてのインターフェース:
InputStreamSource
、Resource
、WritableResource
ファイルの解決を想定した
UrlResource
のサブクラスで、WritableResource
インターフェースを実装します。このリソースバリアントは、getFile()
から解決された File
SE ハンドルもキャッシュします。 これは、"file:..." URL ロケーションに対して DefaultResourceLoader
によって解決されるクラスであり、WritableResource
へのダウンキャストを許可します。
または、File
SE ハンドルまたは NIO Path
SE から直接構築する場合は、FileSystemResource
の使用を検討してください。
- 導入:
- 5.0.2
- 作成者:
- Juergen Hoeller
コンストラクターのサマリー
コンストラクターコンストラクター説明FileUrlResource
(StringSE location) URL プロトコル「ファイル」を使用して、指定されたファイルの場所に基づいて新しいFileUrlResource
を作成します。FileUrlResource
(URLSE url) 指定された URL オブジェクトに基づいて新しいFileUrlResource
を作成します。方法の概要
修飾子と型メソッド説明createRelative
(StringSE relativePath) この実装はUrlResource
を作成し、相対パスを適応させるためにUrlResource.createRelativeURL(String)
に委譲します。getFile()
この実装は、ファイルシステム内のファイルを参照する場合、基になる URL/URI の File 参照を返します。基礎となるリソースのOutputStream
SE を返し、そのコンテンツを(上書き)書き込みできるようにします。boolean
このリソースの内容をWritableResource.getOutputStream()
を介して書き込むことができるかどうかを示します。WritableByteChannel
SE を返します。クラス org.springframework.core.io.UrlResource から継承されたメソッド
createRelativeURL, customizeConnection, equals, from, from, getDescription, getFilename, getInputStream, getURI, getURL, hashCode, isFile
クラス 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.InputStreamSource から継承されたメソッド
getInputStream
インターフェース org.springframework.core.io.Resource から継承されたメソッド
contentLength, exists, getContentAsByteArray, getContentAsString, getDescription, getFilename, getURI, getURL, isFile, isOpen, isReadable, lastModified, readableChannel
コンストラクターの詳細
FileUrlResource
指定された URL オブジェクトに基づいて新しいFileUrlResource
を作成します。これは URL プロトコルとして「ファイル」を強制しないことに注意してください。プロトコルがファイルに解決可能であることがわかっている場合、この目的に適しています。
- パラメーター:
url
- URL- 関連事項:
FileUrlResource
URL プロトコル「ファイル」を使用して、指定されたファイルの場所に基づいて新しいFileUrlResource
を作成します。指定された部分は、必要に応じて自動的にエンコードされます。
- パラメーター:
location
- 場所 (すなわち、そのプロトコル内のファイルパス)- 例外:
MalformedURLExceptionSE
- 指定された URL 指定が有効でない場合- 関連事項:
メソッドの詳細
getFile
クラスからコピーされた説明:UrlResource
この実装は、ファイルシステム内のファイルを参照する場合、基になる URL/URI の File 参照を返します。- 次で指定:
- インターフェース
Resource
のgetFile
- オーバーライド:
- クラス
UrlResource
のgetFile
- 例外:
FileNotFoundExceptionSE
- リソースが絶対ファイルパスとして解決できない場合、つまりリソースがファイルシステムで使用できない場合IOExceptionSE
- 一般的な解決 / 読み取りエラーの場合- 関連事項:
isWritable
public boolean isWritable()インターフェースからコピーされた説明:WritableResource
このリソースの内容をWritableResource.getOutputStream()
を介して書き込むことができるかどうかを示します。一般的なリソース記述子の場合は
true
になります。実際にコンテンツを作成しようとすると失敗する可能性があることに注意してください。ただし、false
の値は、リソースの内容を変更できないことを明確に示しています。- 次で指定:
- インターフェース
WritableResource
のisWritable
- 関連事項:
getOutputStream
インターフェースからコピーされた説明:WritableResource
基礎となるリソースのOutputStream
SE を返し、そのコンテンツを(上書き)書き込みできるようにします。- 次で指定:
- インターフェース
WritableResource
のgetOutputStream
- 例外:
IOExceptionSE
- ストリームを開けなかった場合- 関連事項:
writableChannel
インターフェースからコピーされた説明:WritableResource
WritableByteChannel
SE を返します。各呼び出しで新しいチャネルが作成されることが予想されます。
デフォルトの実装では、
Channels.newChannel(OutputStream)
SE とWritableResource.getOutputStream()
の結果が返されます。- 次で指定:
- インターフェース
WritableResource
のwritableChannel
- 戻り値:
- 基になるリソースのバイトチャネル (
null
であってはなりません) - 例外:
FileNotFoundExceptionSE
- 基になるリソースが存在しない場合IOExceptionSE
- コンテンツチャネルを開けなかった場合- 関連事項:
createRelative
クラスからコピーされた説明:UrlResource
この実装はUrlResource
を作成し、相対パスを適応させるためにUrlResource.createRelativeURL(String)
に委譲します。- 次で指定:
- インターフェース
Resource
のcreateRelative
- オーバーライド:
- クラス
UrlResource
のcreateRelative
- パラメーター:
relativePath
- 相対パス (このリソースに関連して)- 戻り値:
- 相対リソースのリソースハンドル
- 例外:
MalformedURLExceptionSE
- 関連事項: