BaseFileIdentifierMapper | Community Solid Server

Base class for FileIdentifierMapper implementations.

Hierarchy

BaseFileIdentifierMapper
- ExtensionBasedMapper
- FixedContentTypeMapper

Implements

FileIdentifierMapper

Index

Constructors

constructor

Properties

Methods

Constructors

constructor

new BaseFileIdentifierMapper(base: string, rootFilepath: string): BaseFileIdentifierMapper

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

Properties

Protected Readonly baseRequestURI

baseRequestURI: string

Protected Readonly logger

logger: Logger = ...

Protected Readonly rootFilepath

rootFilepath: string

Methods

Protected getAbsolutePath

getAbsolutePath(path: string): string

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:172
Get the absolute file path based on the rootFilepath.

Parameters
- path: string
  
  The relative file path.
Returns string
Absolute path of the file.

Protected getContainerUrl

getContainerUrl(relative: string): Promise<string>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:141
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.

Protected getContentTypeFromPath

getContentTypeFromPath(filePath: string): Promise<string>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:162
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.

Protected getContentTypeFromUrl

getContentTypeFromUrl(identifier: ResourceIdentifier, contentType?: string): Promise<string>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:100
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.

Protected getDocumentUrl

getDocumentUrl(relative: string): Promise<string>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:151
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.

Protected getRelativePath

getRelativePath(identifier: ResourceIdentifier): string

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:185
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.

Protected isMetadataPath

isMetadataPath(path: string): boolean

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:217
Checks if the given path is a metadata path.

Parameters
- path: string
Returns boolean

mapFilePathToUrl

mapFilePathToUrl(filePath: string, isContainer: boolean): Promise<ResourceLink>

Implementation of FileIdentifierMapper.mapFilePathToUrl
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:111
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.

Protected mapUrlToContainerPath

mapUrlToContainerPath(identifier: ResourceIdentifier, filePath: string): Promise<ResourceLink>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:70
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.

Protected mapUrlToDocumentPath

mapUrlToDocumentPath(identifier: ResourceIdentifier, filePath: string, contentType?: string): Promise<ResourceLink>

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:86
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.

mapUrlToFilePath

mapUrlToFilePath(identifier: ResourceIdentifier, isMetadata: boolean, contentType?: string): Promise<ResourceLink>

Implementation of FileIdentifierMapper.mapUrlToFilePath
- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:42
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.

Protected validateRelativePath

validateRelativePath(path: string, identifier: ResourceIdentifier): void

- Defined in src/storage/mapping/BaseFileIdentifierMapper.ts:202
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

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

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

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 validateRelativePath

Parameters

path: string

identifier: ResourceIdentifier

Returns void