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