URLResource (Undertow 2.1.0.Final API)

java.lang.Object
- io.undertow.server.handlers.resource.URLResource

All Implemented Interfaces:: RangeAwareResource, Resource

public class URLResource
extends Object
implements Resource, RangeAwareResource

Author:: Stuart Douglas

Constructor Summary

Constructors
Constructor and Description

URLResource(URL url, String path)

URLResource(URL url, URLConnection connection, String path)
Deprecated.

Constructors
Constructor and Description
`URLResource(URL url, String path)`
`URLResource(URL url, URLConnection connection, String path)` Deprecated.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`getCacheKey()`
`Long`	`getContentLength()`
`String`	`getContentType(MimeMappings mimeMappings)` Return the resources content type.
`ETag`	`getETag()`
`File`	`getFile()`
`Path`	`getFilePath()`
`Date`	`getLastModified()`
`String`	`getLastModifiedString()`
`String`	`getName()`
`String`	`getPath()`
`File`	`getResourceManagerRoot()` Returns the resource manager root.
`Path`	`getResourceManagerRootPath()` Returns the resource manager root.
`URL`	`getUrl()`
`boolean`	`isDirectory()`
`boolean`	`isRangeSupported()` It is possible that some resources managers may only support range requests on a subset of their resources,
`List<Resource>`	`list()`
`void`	`serve(Sender sender, HttpServerExchange exchange, IoCallback completionCallback)` Serve the resource, and call the provided callback when complete.
`void`	`serveImpl(Sender sender, HttpServerExchange exchange, long start, long end, boolean range, IoCallback completionCallback)`
`void`	`serveRange(Sender sender, HttpServerExchange exchange, long start, long end, IoCallback completionCallback)` Serve the resource, and call the provided callback when complete.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - URLResource
```
@Deprecated
public URLResource(URL url,
                               URLConnection connection,
                               String path)
```
    Deprecated.
  - URLResource
```
public URLResource(URL url,
                   String path)
```
- Method Detail
  - getPath
```
public String getPath()
```
    Specified by:
    
    getPath in interface Resource
    
    Returns:
    
    The path from the resource manager root
  - getLastModified
```
public Date getLastModified()
```
    Specified by:
    
    getLastModified in interface Resource
    
    Returns:
    
    The last modified date of this resource, or null if this cannot be determined
  - getLastModifiedString
```
public String getLastModifiedString()
```
    Specified by:
    
    getLastModifiedString in interface Resource
    
    Returns:
    
    A string representation of the last modified date, or null if this cannot be determined
  - getETag
```
public ETag getETag()
```
    Specified by:
    
    getETag in interface Resource
    
    Returns:
    
    The resources etags
  - getName
```
public String getName()
```
    Specified by:
    
    getName in interface Resource
    
    Returns:
    
    The name of the resource
  - isDirectory
```
public boolean isDirectory()
```
    Specified by:
    
    isDirectory in interface Resource
    
    Returns:
    
    true if this resource represents a directory
  - list
```
public List<Resource> list()
```
    Specified by:
    
    list in interface Resource
    
    Returns:
    
    a list of resources in this directory
  - getContentType
```
public String getContentType(MimeMappings mimeMappings)
```
    Description copied from interface: Resource
    
    Return the resources content type. In most cases this will simply use the provided mime mappings, however in some cases the resource may have additional information as to the actual content type.
    
    Specified by:
    
    getContentType in interface Resource
  - serve
```
public void serve(Sender sender,
                  HttpServerExchange exchange,
                  IoCallback completionCallback)
```
    Description copied from interface: Resource
    
    Serve the resource, and call the provided callback when complete.
    
    Specified by:
    
    serve in interface Resource
    
    Parameters:
    
    sender - The sender to use.
    
    exchange - The exchange
  - serveImpl
```
public void serveImpl(Sender sender,
                      HttpServerExchange exchange,
                      long start,
                      long end,
                      boolean range,
                      IoCallback completionCallback)
```
  - getContentLength
```
public Long getContentLength()
```
    Specified by:
    
    getContentLength in interface Resource
    
    Returns:
    
    The content length, or null if it is unknown
  - getCacheKey
```
public String getCacheKey()
```
    Specified by:
    
    getCacheKey in interface Resource
    
    Returns:
    
    A string that uniquely identifies this resource
  - getFile
```
public File getFile()
```
    Specified by:
    
    getFile in interface Resource
    
    Returns:
    
    The underlying file that matches the resource. This may return null if the resource does not map to a file
  - getFilePath
```
public Path getFilePath()
```
    Specified by:
    
    getFilePath in interface Resource
    
    Returns:
    
    The underlying file that matches the resource. This may return null if the resource does not map to a file
  - getResourceManagerRoot
```
public File getResourceManagerRoot()
```
    Description copied from interface: Resource
    
    Returns the resource manager root. If the resource manager has multiple roots then this returns the one that is the parent of this resource.
    
    Specified by:
    
    getResourceManagerRoot in interface Resource
    
    Returns:
    
    a file representing the resource manager root. This may return null if the resource does not map to a file
  - getResourceManagerRootPath
```
public Path getResourceManagerRootPath()
```
    Description copied from interface: Resource
    
    Returns the resource manager root. If the resource manager has multiple roots then this returns the one that is the parent of this resource.
    
    Specified by:
    
    getResourceManagerRootPath in interface Resource
    
    Returns:
    
    a path representing the resource manager root. This may return null if the resource does not map to a file
  - getUrl
```
public URL getUrl()
```
    Specified by:
    
    getUrl in interface Resource
    
    Returns:
    
    The URL of the resource
  - serveRange
```
public void serveRange(Sender sender,
                       HttpServerExchange exchange,
                       long start,
                       long end,
                       IoCallback completionCallback)
```
    Description copied from interface: RangeAwareResource
    
    Serve the resource, and call the provided callback when complete.
    
    Specified by:
    
    serveRange in interface RangeAwareResource
    
    Parameters:
    
    sender - The sender to use.
    
    exchange - The exchange
  - isRangeSupported
```
public boolean isRangeSupported()
```
    Description copied from interface: RangeAwareResource
    
    It is possible that some resources managers may only support range requests on a subset of their resources,
    
    Specified by:
    
    isRangeSupported in interface RangeAwareResource
    
    Returns:
    
    true if this resource supports range requests

Class URLResource

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

URLResource

URLResource

Method Detail

getPath

getLastModified

getLastModifiedString

getETag

getName

isDirectory

list

getContentType

serve

serveImpl

getContentLength

getCacheKey

getFile

getFilePath

getResourceManagerRoot

getResourceManagerRootPath

getUrl

serveRange

isRangeSupported