Class ExtensionBasedMapper

Supports the behaviour described in https://www.w3.org/DesignIssues/HTTPFilenameMapping.html Determines content-type based on the file extension. In case an identifier does not end on an extension matching its content-type, the corresponding file will be appended with the correct extension, preceded by $.

Hierarchy

BaseFileIdentifierMapper
- ExtensionBasedMapper
  - SubdomainExtensionBasedMapper

Constructors

constructor

new ExtensionBasedMapper(base, rootFilepath, customTypes?): ExtensionBasedMapper
Parameters
- base: string
- rootFilepath: string
- Optional customTypes: Record<string, string>
Returns ExtensionBasedMapper
Overrides BaseFileIdentifierMapper.constructor
- Defined in src/storage/mapping/ExtensionBasedMapper.ts:20

Properties

`Protected` `Readonly` baseRequestURI

baseRequestURI: string

`Private` `Readonly` customExtensions

customExtensions: Record<string, string>

`Private` `Readonly` customTypes

customTypes: Record<string, string>

`Protected` `Readonly` logger

logger: Logger = ...

`Protected` `Readonly` rootFilepath

rootFilepath: string

`Protected` `Readonly` unknownMediaTypeExtension

unknownMediaTypeExtension: "unknown" = 'unknown'

Methods

`Protected` getAbsolutePath

getAbsolutePath(path): string
Get the absolute file path based on the rootFilepath.
Parameters
- path: string
  
  The relative file path.
Returns string
Absolute path of the file.
Inherited from BaseFileIdentifierMapper.getAbsolutePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:172

`Protected` getContainerUrl

getContainerUrl(relative): Promise<string>
Maps the given container path to a URL and determines its content type.
Parameters
- relative: string
  
  The relative container path.
Returns Promise<string>
A ResourceLink with all the necessary metadata.
Inherited from BaseFileIdentifierMapper.getContainerUrl
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:141

`Protected` getContentTypeFromPath

getContentTypeFromPath(filePath): Promise<string>
Determines the content type from the relative path.
Parameters
- filePath: string
  
  The file path of the document.
Returns Promise<string>
The content type of the document.
Overrides BaseFileIdentifierMapper.getContentTypeFromPath
- Defined in src/storage/mapping/ExtensionBasedMapper.ts:83

`Protected` getContentTypeFromUrl

getContentTypeFromUrl(identifier, contentType?): Promise<string>
Determines the content type from the document identifier.
Parameters
- identifier: ResourceIdentifier
  
  The input identifier.
- Optional contentType: string
  
  The content-type provided with the request.
Returns Promise<string>
The content type of the document.
Inherited from BaseFileIdentifierMapper.getContentTypeFromUrl
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:100

`Protected` getDocumentUrl

getDocumentUrl(relative): Promise<string>
Maps the given document path to a URL and determines its content type.
Parameters
- relative: string
  
  The relative document path.
Returns Promise<string>
A ResourceLink with all the necessary metadata.
Overrides BaseFileIdentifierMapper.getDocumentUrl
- Defined in src/storage/mapping/ExtensionBasedMapper.ts:79

`Protected` getRelativePath

getRelativePath(identifier): string
Strips the baseRequestURI from the identifier.

Throws
NotFoundHttpError If the identifier does not match the baseRequestURI.
Parameters
- identifier: ResourceIdentifier
  
  Incoming identifier.
Returns string
A string representing the relative path.
Inherited from BaseFileIdentifierMapper.getRelativePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:185

`Protected` isMetadataPath

isMetadataPath(path): boolean
Checks if the given path is a metadata path.
Parameters
- path: string
Returns boolean
Inherited from BaseFileIdentifierMapper.isMetadataPath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:217

mapFilePathToUrl

mapFilePathToUrl(filePath, isContainer): Promise<ResourceLink>
Maps the given file path to a URL and determines its content type.
Parameters
- filePath: string
  
  The input file path.
- isContainer: boolean
  
  If the path corresponds to a file.
Returns Promise<ResourceLink>
A ResourceLink with all the necessary metadata.
Inherited from BaseFileIdentifierMapper.mapFilePathToUrl
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:111

`Protected` mapUrlToContainerPath

mapUrlToContainerPath(identifier, filePath): Promise<ResourceLink>
Maps the given container identifier to a file path, possibly making alterations to the direct translation.
Parameters
- identifier: ResourceIdentifier
  
  The input identifier.
- filePath: string
  
  The direct translation of the identifier onto the file path.
Returns Promise<ResourceLink>
A ResourceLink with all the necessary metadata.
Inherited from BaseFileIdentifierMapper.mapUrlToContainerPath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:67

`Protected` mapUrlToDocumentPath

mapUrlToDocumentPath(identifier, filePath, contentType?): Promise<ResourceLink>
Maps the given document identifier to a file path, possibly making alterations to the direct translation (for instance, based on its content type)). Determines the content type if none was provided.
Parameters
- identifier: ResourceIdentifier
  
  The input identifier.
- filePath: string
  
  The direct translation of the identifier onto the file path.
- Optional contentType: string
  
  The content-type provided with the request.
Returns Promise<ResourceLink>
A ResourceLink with all the necessary metadata.
Overrides BaseFileIdentifierMapper.mapUrlToDocumentPath
- Defined in src/storage/mapping/ExtensionBasedMapper.ts:40

mapUrlToFilePath

mapUrlToFilePath(identifier, isMetadata, contentType?): Promise<ResourceLink>
Maps the given resource identifier / URL to a file path. Determines the content type if none was provided. For containers the content-type input is ignored.
Parameters
- identifier: ResourceIdentifier
  
  The input identifier.
- isMetadata: boolean
  
  If we need the data or metadata file path.
- Optional contentType: string
  
  The content-type provided with the request.
Returns Promise<ResourceLink>
A ResourceLink with all the necessary metadata.
Inherited from BaseFileIdentifierMapper.mapUrlToFilePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:45

`Protected` stripExtension

stripExtension(path): string
Helper function that removes the internal extension, one starting with $., from the given path. Nothing happens if no such extension is present.
Parameters
- path: string
Returns string
- Defined in src/storage/mapping/ExtensionBasedMapper.ts:94

`Protected` validateRelativePath

validateRelativePath(path, identifier): void
Check if the given relative path is valid.

Throws
BadRequestHttpError If the relative path is invalid.
Parameters
- path: string
  
  A relative path, as generated by getRelativePath.
- identifier: ResourceIdentifier
  
  A resource identifier.
Returns void
Inherited from BaseFileIdentifierMapper.validateRelativePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:202

Class ExtensionBasedMapper

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

base: string

rootFilepath: string

Optional customTypes: Record<string, string>

Returns ExtensionBasedMapper

Properties

Protected Readonly baseRequestURI

Private Readonly customExtensions

Private Readonly customTypes

Protected Readonly logger

Protected Readonly rootFilepath

Protected Readonly unknownMediaTypeExtension

Methods

Protected getAbsolutePath

Parameters

path: string

Returns string

Protected getContainerUrl

Parameters

relative: string

Returns Promise<string>

Protected getContentTypeFromPath

Parameters

filePath: string

Returns Promise<string>

Protected getContentTypeFromUrl

Parameters

identifier: ResourceIdentifier

Optional contentType: string

Returns Promise<string>

Protected getDocumentUrl

Parameters

relative: string

Returns Promise<string>

Protected getRelativePath

Throws

Parameters

identifier: ResourceIdentifier

Returns string

Protected isMetadataPath

Parameters

path: string

Returns boolean

mapFilePathToUrl

Parameters

filePath: string

isContainer: boolean

Returns Promise<ResourceLink>

Protected mapUrlToContainerPath

Parameters

identifier: ResourceIdentifier

filePath: string

Returns Promise<ResourceLink>

Protected mapUrlToDocumentPath

Parameters

identifier: ResourceIdentifier

filePath: string

Optional contentType: string

Returns Promise<ResourceLink>

mapUrlToFilePath

Parameters

identifier: ResourceIdentifier

isMetadata: boolean

Optional contentType: string

Returns Promise<ResourceLink>

Protected stripExtension

Parameters

path: string

Returns string

Protected validateRelativePath

Throws

Parameters

`Optional` customTypes: Record<string, string>

`Protected` `Readonly` baseRequestURI

`Private` `Readonly` customExtensions

`Private` `Readonly` customTypes

`Protected` `Readonly` logger

`Protected` `Readonly` rootFilepath

`Protected` `Readonly` unknownMediaTypeExtension

`Protected` getAbsolutePath

`Protected` getContainerUrl

`Protected` getContentTypeFromPath

`Protected` getContentTypeFromUrl

`Optional` contentType: string

`Protected` getDocumentUrl

`Protected` getRelativePath

`Protected` isMetadataPath

`Protected` mapUrlToContainerPath

`Protected` mapUrlToDocumentPath

`Optional` contentType: string

`Optional` contentType: string

`Protected` stripExtension

`Protected` validateRelativePath