Class BaseFileIdentifierMapper

Base class for FileIdentifierMapper implementations.

Hierarchy

BaseFileIdentifierMapper
- ExtensionBasedMapper
- FixedContentTypeMapper

Implements

FileIdentifierMapper

Index

Constructors

constructor

new BaseFileIdentifierMapper(base: string, rootFilepath: string): BaseFileIdentifierMapper
Parameters
- base: string
- rootFilepath: string
Returns BaseFileIdentifierMapper
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:27

Properties

`Protected` `Readonly` baseRequestURI

baseRequestURI: string

`Protected` `Readonly` logger

logger: Logger = ...

`Protected` `Readonly` rootFilepath

rootFilepath: string

Methods

`Protected` getAbsolutePath

getAbsolutePath(path: string): string
Get the absolute file path based on the rootFilepath.

Returns
Absolute path of the file.
Parameters
- path: string
  
  The relative file path.
Returns string
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:172

`Protected` getContainerUrl

getContainerUrl(relative: string): Promise<string>
Maps the given container path to a URL and determines its content type.

Returns
A ResourceLink with all the necessary metadata.
Parameters
- relative: string
  
  The relative container path.
Returns Promise<string>
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:141

`Protected` getContentTypeFromPath

getContentTypeFromPath(filePath: string): Promise<string>
Determines the content type from the relative path.

Returns
The content type of the document.
Parameters
- filePath: string
  
  The file path of the document.
Returns Promise<string>
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:162

`Protected` getContentTypeFromUrl

getContentTypeFromUrl(identifier: ResourceIdentifier, contentType?: string): Promise<string>
Determines the content type from the document identifier.

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

`Protected` getDocumentUrl

getDocumentUrl(relative: string): Promise<string>
Maps the given document path to a URL and determines its content type.

Returns
A ResourceLink with all the necessary metadata.
Parameters
- relative: string
  
  The relative document path.
Returns Promise<string>
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:151

`Protected` getRelativePath

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

Throws
NotFoundHttpError If the identifier does not match the baseRequestURI.

Returns
A string representing the relative path.
Parameters
- identifier: ResourceIdentifier
  
  Incoming identifier.
Returns string
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:185

`Protected` isMetadataPath

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

mapFilePathToUrl

mapFilePathToUrl(filePath: string, isContainer: boolean): Promise<ResourceLink>
Maps the given file path to a URL and determines its content type.

Returns
A ResourceLink with all the necessary metadata.
Parameters
- filePath: string
  
  The input file path.
- isContainer: boolean
  
  If the path corresponds to a file.
Returns Promise<ResourceLink>
Implementation of FileIdentifierMapper.mapFilePathToUrl
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:111

`Protected` mapUrlToContainerPath

mapUrlToContainerPath(identifier: ResourceIdentifier, filePath: string): Promise<ResourceLink>
Maps the given container identifier to a file path, possibly making alterations to the direct translation.

Returns
A ResourceLink with all the necessary metadata.
Parameters
- identifier: ResourceIdentifier
  
  The input identifier.
- filePath: string
  
  The direct translation of the identifier onto the file path.
Returns Promise<ResourceLink>
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:70

`Protected` mapUrlToDocumentPath

mapUrlToDocumentPath(identifier: ResourceIdentifier, filePath: string, contentType?: string): 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.

Returns
A ResourceLink with all the necessary metadata.
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>
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:86

mapUrlToFilePath

mapUrlToFilePath(identifier: ResourceIdentifier, isMetadata: boolean, contentType?: string): 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.

Returns
A ResourceLink with all the necessary metadata.
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>
Implementation of FileIdentifierMapper.mapUrlToFilePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:42

`Protected` validateRelativePath

validateRelativePath(path: string, identifier: ResourceIdentifier): 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
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:202

Class BaseFileIdentifierMapper

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

base: string

rootFilepath: string

Returns BaseFileIdentifierMapper

Properties

Protected Readonly baseRequestURI

Protected Readonly logger

Protected Readonly rootFilepath

Methods

Protected getAbsolutePath

Returns

Parameters

path: string

Returns string

Protected getContainerUrl

Returns

Parameters

relative: string

Returns Promise<string>

Protected getContentTypeFromPath

Returns

Parameters

filePath: string

Returns Promise<string>

Protected getContentTypeFromUrl

Returns

Parameters

identifier: ResourceIdentifier

Optional contentType: string

Returns Promise<string>

Protected getDocumentUrl

Returns

Parameters

relative: string

Returns Promise<string>

Protected getRelativePath

Throws

Returns

Parameters

identifier: ResourceIdentifier

Returns string

Protected isMetadataPath

Parameters

path: string

Returns boolean

mapFilePathToUrl

Returns

Parameters

filePath: string

isContainer: boolean

Returns Promise<ResourceLink>

Protected mapUrlToContainerPath

Returns

Parameters

identifier: ResourceIdentifier

filePath: string

Returns Promise<ResourceLink>

Protected mapUrlToDocumentPath

Returns

Parameters

identifier: ResourceIdentifier

filePath: string

Optional contentType: string

Returns Promise<ResourceLink>

mapUrlToFilePath

Returns

Parameters

identifier: ResourceIdentifier

isMetadata: boolean

Optional contentType: string

Returns Promise<ResourceLink>

`Protected` `Readonly` baseRequestURI

`Protected` `Readonly` logger

`Protected` `Readonly` rootFilepath

`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` validateRelativePath