public class ServletContextResource extends AbstractFileResolvingResource implements ContextResource
ServletContext
EE リソースの Resource
実装。Web アプリケーションのルートディレクトリ内の相対パスを解釈します。 常にストリームアクセスと URL アクセスをサポートしますが、Web アプリケーションアーカイブが展開されている場合にのみ java.io.File
アクセスを許可します。
ServletContext.getResourceAsStream(java.lang.String)
EE, ServletContext.getResource(java.lang.String)
EE, ServletContext.getRealPath(java.lang.String)
EEコンストラクターと説明 |
---|
ServletContextResource(ServletContextEE servletContext, StringSE path) 新しい ServletContextResource を作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
Resource | createRelative(StringSE relativePath) この実装は ServletContextResource を作成し、このリソース記述子の元となるファイルのパスに対して指定されたパスを適用します。 |
boolean | equals(ObjectSE other) この実装は、基になる ServletContext リソースの場所を比較します。 |
boolean | exists() この実装は ServletContext.getResource をチェックします。 |
StringSE | getDescription() この実装は、ServletContext リソースの場所を含む説明を返します。 |
FileSE | getFile() この実装は "file:" URL を解決するか、代わりに ServletContext.getRealPath に委譲し、見つからないか解決できない場合は FileNotFoundException をスローします。 |
StringSE | getFilename() この実装は、この ServletContext リソースが参照するファイルの名前を返します。 |
InputStreamSE | getInputStream() この実装は ServletContext.getResourceAsStream に委譲しますが、リソースが見つからない場合は FileNotFoundException をスローします。 |
StringSE | getPath() このリソースのパスを返します。 |
StringSE | getPathWithinContext() 囲んでいる「コンテキスト」内のパスを返します。 |
ServletContextEE | getServletContext() このリソースの ServletContext を返します。 |
URLSE | getURL() この実装は ServletContext.getResource に委譲しますが、リソースが見つからない場合は FileNotFoundException をスローします。 |
int | hashCode() この実装は、基になる ServletContext リソースの場所のハッシュコードを返します。 |
boolean | isFile() この実装は、常に false を返します。 |
boolean | isReadable() この実装は ServletContext.getResourceAsStream に委譲します。読み取り不可能なリソースの場合に null を返します(例: |
contentLength, customizeConnection, customizeConnection, getFile, getFileForLastModifiedCheck, isFile, lastModified, readableChannel
getURI, isOpen, toString
cloneSE, finalizeSE, getClassSE, notifySE, notifyAllSE, waitSE, waitSE, waitSE
contentLength, getURI, isOpen, lastModified, readableChannel
public ServletContextResource(ServletContextEE servletContext, StringSE path)
サーブレット仕様では、多くのコンテナーがスラッシュを付けずにパスを受け入れる場合でも、リソースパスはスラッシュで始まる必要があります。指定されたパスがスラッシュで始まっていない場合は、その前にスラッシュが追加されます。
servletContext
- ロードする ServletContextpath
- リソースのパス public final ServletContextEE getServletContext()
public final StringSE getPath()
public boolean exists()
ServletContext.getResource
をチェックします。Resource
の exists
AbstractFileResolvingResource
の exists
ServletContext.getResource(String)
EEpublic boolean isReadable()
ServletContext.getResourceAsStream
に委譲します。これは、読み取り不可能なリソース(ディレクトリなど)の場合に null
を返します。Resource
の isReadable
AbstractFileResolvingResource
の isReadable
ServletContext.getResourceAsStream(String)
EEpublic boolean isFile()
AbstractResource
false
を返します。Resource
の isFile
AbstractFileResolvingResource
の isFile
Resource.getFile()
public InputStreamSE getInputStream() throws IOExceptionSE
ServletContext.getResourceAsStream
に委譲しますが、リソースが見つからない場合は FileNotFoundException をスローします。InputStreamSource
の getInputStream
null
であってはなりません)FileNotFoundExceptionSE
- 基になるリソースが存在しない場合 IOExceptionSE
- コンテンツストリームを開けなかった場合 ServletContext.getResourceAsStream(String)
EEpublic URLSE getURL() throws IOExceptionSE
ServletContext.getResource
に委譲しますが、リソースが見つからない場合は FileNotFoundException をスローします。Resource
の getURL
AbstractResource
の getURL
IOExceptionSE
- リソースを URL として解決できない場合、つまりリソースが記述子として利用できない場合 ServletContext.getResource(String)
EEpublic FileSE getFile() throws IOExceptionSE
ServletContext.getRealPath
に委譲し、見つからないか解決できない場合は FileNotFoundException をスローします。Resource
の getFile
AbstractFileResolvingResource
の getFile
FileNotFoundExceptionSE
- リソースが絶対ファイルパスとして解決できない場合、つまりリソースがファイルシステムで使用できない場合 IOExceptionSE
- 一般的な解決 / 読み取りエラーの場合 ServletContext.getResource(String)
EE, ServletContext.getRealPath(String)
EEpublic Resource createRelative(StringSE relativePath)
Resource
の createRelative
AbstractResource
の createRelative
relativePath
- 相対パス (このリソースに関連して)StringUtils.applyRelativePath(String, String)
@Nullable public StringSE getFilename()
Resource
の getFilename
AbstractResource
の getFilename
StringUtils.getFilename(String)
public StringSE getDescription()
Resource
の getDescription
Object.toString()
SEpublic StringSE getPathWithinContext()
ContextResource
これは通常、コンテキスト固有のルートディレクトリへの相対パスです。ServletContext ルートまたは PortletContext ルート。
ContextResource
の getPathWithinContext
public boolean equals(ObjectSE other)
AbstractResource
の equals
Resource.getDescription()
public int hashCode()
AbstractResource
の hashCode
Resource.getDescription()