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 (view full)

BaseFileIdentifierMapper
- ExtensionBasedMapper
  - SubdomainExtensionBasedMapper

Index

Constructors

constructor

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

Properties

`Protected` `Readonly`baseRequestURI

baseRequestURI: 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:181

`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:147

`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.
- OptionalcontentType: 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:104

`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.
Parameters
- identifier: ResourceIdentifier
  Incoming identifier.
Returns string
A string representing the relative path.

Throws
NotFoundHttpError If the identifier does not match the baseRequestURI.
Inherited from BaseFileIdentifierMapper.getRelativePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:195

`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:227

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:116

`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:69

`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.
- OptionalcontentType: 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.
- OptionalcontentType: 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:46

`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 whether the given relative path is valid.
Parameters
- path: string
  A relative path, as generated by getRelativePath.
- identifier: ResourceIdentifier
  A resource identifier.
Returns void
Throws
BadRequestHttpError If the relative path is invalid.
Inherited from BaseFileIdentifierMapper.validateRelativePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:212

Class ExtensionBasedMapper

Hierarchy (view full)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ExtensionBasedMapper

Properties

Protected ReadonlybaseRequestURI

Protected Readonlylogger

Protected ReadonlyrootFilepath

Protected ReadonlyunknownMediaTypeExtension

Methods

ProtectedgetAbsolutePath

Parameters

Returns string

ProtectedgetContainerUrl

Parameters

Returns Promise<string>

ProtectedgetContentTypeFromPath

Parameters

Returns Promise<string>

ProtectedgetContentTypeFromUrl

Parameters

Returns Promise<string>

ProtectedgetDocumentUrl

Parameters

Returns Promise<string>

ProtectedgetRelativePath

Parameters

Returns string

Throws

ProtectedisMetadataPath

Parameters

Returns boolean

mapFilePathToUrl

Parameters

Returns Promise<ResourceLink>

ProtectedmapUrlToContainerPath

Parameters

Returns Promise<ResourceLink>

ProtectedmapUrlToDocumentPath

Parameters

Returns Promise<ResourceLink>

mapUrlToFilePath

Parameters

Returns Promise<ResourceLink>

ProtectedstripExtension

Parameters

Returns string

ProtectedvalidateRelativePath

Parameters

Returns void

Throws

Settings

On This Page

`Protected` `Readonly`baseRequestURI

`Protected` `Readonly`logger

`Protected` `Readonly`rootFilepath

`Protected` `Readonly`unknownMediaTypeExtension

`Protected`getAbsolutePath

`Protected`getContainerUrl

`Protected`getContentTypeFromPath

`Protected`getContentTypeFromUrl

`Protected`getDocumentUrl

`Protected`getRelativePath

`Protected`isMetadataPath

`Protected`mapUrlToContainerPath

`Protected`mapUrlToDocumentPath

`Protected`stripExtension

`Protected`validateRelativePath