X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fcharging-station%2Focpp%2FOCPPRequestService.ts;h=3a27a1923d7a0234efed3c223337e7e26ba2347f;hb=314793aaf25bf1a99deb3f8209c09421235942ba;hp=f6aa567fd98deb7cf98f5b7b645d35c974cd8e88;hpb=b84bca85e73f1be0db5482aee6924922e9dc10c9;p=e-mobility-charging-stations-simulator.git diff --git a/src/charging-station/ocpp/OCPPRequestService.ts b/src/charging-station/ocpp/OCPPRequestService.ts index f6aa567f..3a27a192 100644 --- a/src/charging-station/ocpp/OCPPRequestService.ts +++ b/src/charging-station/ocpp/OCPPRequestService.ts @@ -1,20 +1,15 @@ -import Ajv, { type JSONSchemaType } from 'ajv'; -import ajvFormats from 'ajv-formats'; +import _Ajv, { type ValidateFunction } from 'ajv' +import _ajvFormats from 'ajv-formats' -import { OCPPConstants } from './OCPPConstants'; -import type { OCPPResponseService } from './OCPPResponseService'; -import { OCPPServiceUtils } from './OCPPServiceUtils'; -import type { ChargingStation } from '../../charging-station'; -import { OCPPError } from '../../exception'; -import { PerformanceStatistics } from '../../performance'; +import type { ChargingStation } from '../../charging-station/index.js' +import { OCPPError } from '../../exception/index.js' +import { PerformanceStatistics } from '../../performance/index.js' import { - type EmptyObject, + ChargingStationEvents, type ErrorCallback, type ErrorResponse, ErrorType, - type HandleErrorParams, type IncomingRequestCommand, - type JsonObject, type JsonType, MessageType, type OCPPVersion, @@ -23,84 +18,54 @@ import { type RequestParams, type Response, type ResponseCallback, - type ResponseType, -} from '../../types'; -import { Constants, Utils, logger } from '../../utils'; + type ResponseType +} from '../../types/index.js' +import { + clone, + formatDurationMilliSeconds, + handleSendMessageError, + logger +} from '../../utils/index.js' +import { OCPPConstants } from './OCPPConstants.js' +import type { OCPPResponseService } from './OCPPResponseService.js' +import { OCPPServiceUtils } from './OCPPServiceUtils.js' +type Ajv = _Ajv.default +// eslint-disable-next-line @typescript-eslint/no-redeclare +const Ajv = _Ajv.default +const ajvFormats = _ajvFormats.default + +const moduleName = 'OCPPRequestService' -const moduleName = 'OCPPRequestService'; +const defaultRequestParams: RequestParams = { + skipBufferingOnError: false, + triggerMessage: false, + throwError: false +} export abstract class OCPPRequestService { - private static instance: OCPPRequestService | null = null; - private readonly version: OCPPVersion; - private readonly ajv: Ajv; - private readonly ocppResponseService: OCPPResponseService; - protected abstract jsonSchemas: Map>; + private static instance: OCPPRequestService | null = null + private readonly version: OCPPVersion + private readonly ocppResponseService: OCPPResponseService + protected readonly ajv: Ajv + protected abstract payloadValidateFunctions: Map> - protected constructor(version: OCPPVersion, ocppResponseService: OCPPResponseService) { - this.version = version; + protected constructor (version: OCPPVersion, ocppResponseService: OCPPResponseService) { + this.version = version this.ajv = new Ajv({ keywords: ['javaType'], - multipleOfPrecision: 2, - }); - ajvFormats(this.ajv); - this.ocppResponseService = ocppResponseService; - this.requestHandler = this.requestHandler.bind(this) as < - ReqType extends JsonType, - ResType extends JsonType - >( - chargingStation: ChargingStation, - commandName: RequestCommand, - commandParams?: JsonType, - params?: RequestParams - ) => Promise; - this.sendMessage = this.sendMessage.bind(this) as ( - chargingStation: ChargingStation, - messageId: string, - messagePayload: JsonType, - commandName: RequestCommand, - params?: RequestParams - ) => Promise; - this.sendResponse = this.sendResponse.bind(this) as ( - chargingStation: ChargingStation, - messageId: string, - messagePayload: JsonType, - commandName: IncomingRequestCommand - ) => Promise; - this.sendError = this.sendError.bind(this) as ( - chargingStation: ChargingStation, - messageId: string, - ocppError: OCPPError, - commandName: RequestCommand | IncomingRequestCommand - ) => Promise; - this.internalSendMessage = this.internalSendMessage.bind(this) as ( - chargingStation: ChargingStation, - messageId: string, - messagePayload: JsonType | OCPPError, - messageType: MessageType, - commandName: RequestCommand | IncomingRequestCommand, - params?: RequestParams - ) => Promise; - this.buildMessageToSend = this.buildMessageToSend.bind(this) as ( - chargingStation: ChargingStation, - messageId: string, - messagePayload: JsonType | OCPPError, - messageType: MessageType, - commandName: RequestCommand | IncomingRequestCommand, - responseCallback: ResponseCallback, - errorCallback: ErrorCallback - ) => string; - this.validateRequestPayload = this.validateRequestPayload.bind(this) as ( - chargingStation: ChargingStation, - commandName: RequestCommand | IncomingRequestCommand, - payload: T - ) => boolean; - this.validateIncomingRequestResponsePayload = this.validateIncomingRequestResponsePayload.bind( - this - ) as ( - chargingStation: ChargingStation, - commandName: RequestCommand | IncomingRequestCommand, - payload: T - ) => boolean; + multipleOfPrecision: 2 + }) + ajvFormats(this.ajv) + this.ocppResponseService = ocppResponseService + this.requestHandler = this.requestHandler.bind(this) + this.sendMessage = this.sendMessage.bind(this) + this.sendResponse = this.sendResponse.bind(this) + this.sendError = this.sendError.bind(this) + this.internalSendMessage = this.internalSendMessage.bind(this) + this.buildMessageToSend = this.buildMessageToSend.bind(this) + this.validateRequestPayload = this.validateRequestPayload.bind(this) + this.validateIncomingRequestResponsePayload = + this.validateIncomingRequestResponsePayload.bind(this) } public static getInstance( @@ -108,12 +73,12 @@ export abstract class OCPPRequestService { ocppResponseService: OCPPResponseService ): T { if (OCPPRequestService.instance === null) { - OCPPRequestService.instance = new this(ocppResponseService); + OCPPRequestService.instance = new this(ocppResponseService) } - return OCPPRequestService.instance as T; + return OCPPRequestService.instance as T } - public async sendResponse( + public async sendResponse ( chargingStation: ChargingStation, messageId: string, messagePayload: JsonType, @@ -127,15 +92,16 @@ export abstract class OCPPRequestService { messagePayload, MessageType.CALL_RESULT_MESSAGE, commandName - ); + ) } catch (error) { - this.handleSendMessageError(chargingStation, commandName, error as Error, { - throwError: true, - }); + handleSendMessageError(chargingStation, commandName, error as Error, { + throwError: true + }) + return null } } - public async sendError( + public async sendError ( chargingStation: ChargingStation, messageId: string, ocppError: OCPPError, @@ -149,23 +115,24 @@ export abstract class OCPPRequestService { ocppError, MessageType.CALL_ERROR_MESSAGE, commandName - ); + ) } catch (error) { - this.handleSendMessageError(chargingStation, commandName, error as Error); + handleSendMessageError(chargingStation, commandName, error as Error) + return null } } - protected async sendMessage( + protected async sendMessage ( chargingStation: ChargingStation, messageId: string, messagePayload: JsonType, commandName: RequestCommand, - params: RequestParams = { - skipBufferingOnError: false, - triggerMessage: false, - throwError: false, - } + params?: RequestParams ): Promise { + params = { + ...defaultRequestParams, + ...params + } try { return await this.internalSendMessage( chargingStation, @@ -174,326 +141,346 @@ export abstract class OCPPRequestService { MessageType.CALL_MESSAGE, commandName, params - ); + ) } catch (error) { - this.handleSendMessageError(chargingStation, commandName, error as Error, { - throwError: params.throwError, - }); + handleSendMessageError(chargingStation, commandName, error as Error, { + throwError: params.throwError + }) + return null } } - private validateRequestPayload( + private validateRequestPayload( chargingStation: ChargingStation, commandName: RequestCommand | IncomingRequestCommand, payload: T ): boolean { - if (chargingStation.getPayloadSchemaValidation() === false) { - return true; + if (chargingStation.stationInfo?.ocppStrictCompliance === false) { + return true } - if (this.jsonSchemas.has(commandName as RequestCommand) === false) { + if (!this.payloadValidateFunctions.has(commandName as RequestCommand)) { logger.warn( `${chargingStation.logPrefix()} ${moduleName}.validateRequestPayload: No JSON schema found for command '${commandName}' PDU validation` - ); - return true; + ) + return true } - const validate = this.ajv.compile(this.jsonSchemas.get(commandName as RequestCommand)); - payload = Utils.cloneObject(payload); - OCPPServiceUtils.convertDateToISOString(payload); - if (validate(payload)) { - return true; + const validate = this.payloadValidateFunctions.get(commandName as RequestCommand) + payload = clone(payload) + OCPPServiceUtils.convertDateToISOString(payload) + if (validate?.(payload) === true) { + return true } logger.error( `${chargingStation.logPrefix()} ${moduleName}.validateRequestPayload: Command '${commandName}' request PDU is invalid: %j`, - validate.errors - ); + validate?.errors + ) // OCPPError usage here is debatable: it's an error in the OCPP stack but not targeted to sendError(). throw new OCPPError( - OCPPServiceUtils.ajvErrorsToErrorType(validate.errors), + OCPPServiceUtils.ajvErrorsToErrorType(validate?.errors), 'Request PDU is invalid', commandName, - JSON.stringify(validate.errors, null, 2) - ); + JSON.stringify(validate?.errors, undefined, 2) + ) } - private validateIncomingRequestResponsePayload( + private validateIncomingRequestResponsePayload( chargingStation: ChargingStation, commandName: RequestCommand | IncomingRequestCommand, payload: T ): boolean { - if (chargingStation.getPayloadSchemaValidation() === false) { - return true; + if (chargingStation.stationInfo?.ocppStrictCompliance === false) { + return true } if ( - this.ocppResponseService.jsonIncomingRequestResponseSchemas.has( + !this.ocppResponseService.incomingRequestResponsePayloadValidateFunctions.has( commandName as IncomingRequestCommand - ) === false + ) ) { logger.warn( - `${chargingStation.logPrefix()} ${moduleName}.validateIncomingRequestResponsePayload: No JSON schema found for command '${commandName}' PDU validation` - ); - return true; - } - const validate = this.ajv.compile( - this.ocppResponseService.jsonIncomingRequestResponseSchemas.get( - commandName as IncomingRequestCommand + `${chargingStation.logPrefix()} ${moduleName}.validateIncomingRequestResponsePayload: No JSON schema validation function found for command '${commandName}' PDU validation` ) - ); - payload = Utils.cloneObject(payload); - OCPPServiceUtils.convertDateToISOString(payload); - if (validate(payload)) { - return true; + return true + } + const validate = this.ocppResponseService.incomingRequestResponsePayloadValidateFunctions.get( + commandName as IncomingRequestCommand + ) + payload = clone(payload) + OCPPServiceUtils.convertDateToISOString(payload) + if (validate?.(payload) === true) { + return true } logger.error( - `${chargingStation.logPrefix()} ${moduleName}.validateIncomingRequestResponsePayload: Command '${commandName}' reponse PDU is invalid: %j`, - validate.errors - ); + `${chargingStation.logPrefix()} ${moduleName}.validateIncomingRequestResponsePayload: Command '${commandName}' response PDU is invalid: %j`, + validate?.errors + ) // OCPPError usage here is debatable: it's an error in the OCPP stack but not targeted to sendError(). throw new OCPPError( - OCPPServiceUtils.ajvErrorsToErrorType(validate.errors), + OCPPServiceUtils.ajvErrorsToErrorType(validate?.errors), 'Response PDU is invalid', commandName, - JSON.stringify(validate.errors, null, 2) - ); + JSON.stringify(validate?.errors, undefined, 2) + ) } - private async internalSendMessage( + private async internalSendMessage ( chargingStation: ChargingStation, messageId: string, messagePayload: JsonType | OCPPError, messageType: MessageType, commandName: RequestCommand | IncomingRequestCommand, - params: RequestParams = { - skipBufferingOnError: false, - triggerMessage: false, - } + params?: RequestParams ): Promise { + params = { + ...defaultRequestParams, + ...params + } if ( - (chargingStation.inUnknownState() === true && - commandName === RequestCommand.BOOT_NOTIFICATION) || - (chargingStation.getOcppStrictCompliance() === false && - chargingStation.inUnknownState() === true) || - chargingStation.inAcceptedState() === true || - (chargingStation.inPendingState() === true && + (chargingStation.inUnknownState() && commandName === RequestCommand.BOOT_NOTIFICATION) || + (chargingStation.stationInfo?.ocppStrictCompliance === false && + chargingStation.inUnknownState()) || + chargingStation.inAcceptedState() || + (chargingStation.inPendingState() && (params.triggerMessage === true || messageType === MessageType.CALL_RESULT_MESSAGE)) ) { // eslint-disable-next-line @typescript-eslint/no-this-alias - const self = this; + const self = this // Send a message through wsConnection - return Utils.promiseWithTimeout( - new Promise((resolve, reject) => { - /** - * Function that will receive the request's response - * - * @param payload - - * @param requestPayload - - */ - const responseCallback = (payload: JsonType, requestPayload: JsonType): void => { - if (chargingStation.getEnableStatistics() === true) { - chargingStation.performanceStatistics?.addRequestStatistic( - commandName, - MessageType.CALL_RESULT_MESSAGE - ); - } - // Handle the request's response - self.ocppResponseService - .responseHandler( - chargingStation, - commandName as RequestCommand, - payload, - requestPayload - ) - .then(() => { - resolve(payload); - }) - .catch((error) => { - reject(error); - }) - .finally(() => { - chargingStation.requests.delete(messageId); - }); - }; - - /** - * Function that will receive the request's error response - * - * @param error - - * @param requestStatistic - - */ - const errorCallback = (error: OCPPError, requestStatistic = true): void => { - if (requestStatistic === true && chargingStation.getEnableStatistics() === true) { - chargingStation.performanceStatistics?.addRequestStatistic( - commandName, - MessageType.CALL_ERROR_MESSAGE - ); - } - logger.error( - `${chargingStation.logPrefix()} Error occurred at ${OCPPServiceUtils.getMessageTypeString( - messageType - )} command ${commandName} with PDU %j:`, - messagePayload, - error - ); - chargingStation.requests.delete(messageId); - reject(error); - }; + return await new Promise((resolve, reject: (reason?: unknown) => void) => { + /** + * Function that will receive the request's response + * + * @param payload - + * @param requestPayload - + */ + const responseCallback = (payload: JsonType, requestPayload: JsonType): void => { + if (chargingStation.stationInfo?.enableStatistics === true) { + chargingStation.performanceStatistics?.addRequestStatistic( + commandName, + MessageType.CALL_RESULT_MESSAGE + ) + } + // Handle the request's response + self.ocppResponseService + .responseHandler( + chargingStation, + commandName as RequestCommand, + payload, + requestPayload + ) + .then(() => { + resolve(payload) + }) + .catch(reject) + .finally(() => { + chargingStation.requests.delete(messageId) + chargingStation.emit(ChargingStationEvents.updated) + }) + } - if (chargingStation.getEnableStatistics() === true) { - chargingStation.performanceStatistics?.addRequestStatistic(commandName, messageType); + /** + * Function that will receive the request's error response + * + * @param ocppError - + * @param requestStatistic - + */ + const errorCallback = (ocppError: OCPPError, requestStatistic = true): void => { + if (requestStatistic && chargingStation.stationInfo?.enableStatistics === true) { + chargingStation.performanceStatistics?.addRequestStatistic( + commandName, + MessageType.CALL_ERROR_MESSAGE + ) } - const messageToSend = this.buildMessageToSend( - chargingStation, - messageId, + logger.error( + `${chargingStation.logPrefix()} Error occurred at ${OCPPServiceUtils.getMessageTypeString( + messageType + )} command ${commandName} with PDU %j:`, messagePayload, - messageType, - commandName, - responseCallback, - errorCallback - ); - let sendError = false; - // Check if wsConnection opened - const wsOpened = chargingStation.isWebSocketConnectionOpened() === true; - if (wsOpened) { - const beginId = PerformanceStatistics.beginMeasure(commandName); - try { - chargingStation.wsConnection?.send(messageToSend); - logger.debug( - `${chargingStation.logPrefix()} >> Command '${commandName}' sent ${OCPPServiceUtils.getMessageTypeString( - messageType - )} payload: ${messageToSend}` - ); - } catch (error) { - logger.error( - `${chargingStation.logPrefix()} >> Command '${commandName}' failed to send ${OCPPServiceUtils.getMessageTypeString( - messageType - )} payload: ${messageToSend}:`, - error - ); - sendError = true; + ocppError + ) + chargingStation.requests.delete(messageId) + chargingStation.emit(ChargingStationEvents.updated) + reject(ocppError) + } + + const handleSendError = (ocppError: OCPPError): void => { + if (params.skipBufferingOnError === false) { + // Buffer + chargingStation.bufferMessage(messageToSend) + if (messageType === MessageType.CALL_MESSAGE) { + this.setCachedRequest( + chargingStation, + messageId, + messagePayload as JsonType, + commandName, + responseCallback, + errorCallback + ) } - PerformanceStatistics.endMeasure(commandName, beginId); + } else if ( + params.skipBufferingOnError === true && + messageType === MessageType.CALL_MESSAGE + ) { + // Remove request from the cache + chargingStation.requests.delete(messageId) } - const wsClosedOrErrored = !wsOpened || sendError === true; - if (wsClosedOrErrored && params.skipBufferingOnError === false) { - // Buffer - chargingStation.bufferMessage(messageToSend); - // Reject and keep request in the cache - return reject( + reject(ocppError) + } + + if (chargingStation.stationInfo?.enableStatistics === true) { + chargingStation.performanceStatistics?.addRequestStatistic(commandName, messageType) + } + const messageToSend = this.buildMessageToSend( + chargingStation, + messageId, + messagePayload, + messageType, + commandName + ) + // Check if wsConnection opened + if (chargingStation.isWebSocketConnectionOpened()) { + const beginId = PerformanceStatistics.beginMeasure(commandName) + const sendTimeout = setTimeout(() => { + handleSendError( new OCPPError( ErrorType.GENERIC_ERROR, - `WebSocket closed or errored for buffered message id '${messageId}' with content '${messageToSend}'`, + `Timeout ${formatDurationMilliSeconds( + OCPPConstants.OCPP_WEBSOCKET_TIMEOUT + )} reached for ${ + params.skipBufferingOnError === false ? '' : 'non ' + }buffered message id '${messageId}' with content '${messageToSend}'`, commandName, - (messagePayload as JsonObject)?.details ?? Constants.EMPTY_FREEZED_OBJECT + (messagePayload as OCPPError).details ) - ); - } else if (wsClosedOrErrored) { - const ocppError = new OCPPError( + ) + }, OCPPConstants.OCPP_WEBSOCKET_TIMEOUT) + chargingStation.wsConnection?.send(messageToSend, (error?: Error) => { + PerformanceStatistics.endMeasure(commandName, beginId) + clearTimeout(sendTimeout) + if (error == null) { + logger.debug( + `${chargingStation.logPrefix()} >> Command '${commandName}' sent ${OCPPServiceUtils.getMessageTypeString( + messageType + )} payload: ${messageToSend}` + ) + if (messageType === MessageType.CALL_MESSAGE) { + this.setCachedRequest( + chargingStation, + messageId, + messagePayload as JsonType, + commandName, + responseCallback, + errorCallback + ) + } else { + // Resolve response + resolve(messagePayload) + } + } else { + handleSendError( + new OCPPError( + ErrorType.GENERIC_ERROR, + `WebSocket errored for ${ + params.skipBufferingOnError === false ? '' : 'non ' + }buffered message id '${messageId}' with content '${messageToSend}'`, + commandName, + { name: error.name, message: error.message, stack: error.stack } + ) + ) + } + }) + } else { + handleSendError( + new OCPPError( ErrorType.GENERIC_ERROR, - `WebSocket closed or errored for non buffered message id '${messageId}' with content '${messageToSend}'`, + `WebSocket closed for ${ + params.skipBufferingOnError === false ? '' : 'non ' + }buffered message id '${messageId}' with content '${messageToSend}'`, commandName, - (messagePayload as JsonObject)?.details ?? Constants.EMPTY_FREEZED_OBJECT - ); - // Reject response - if (messageType !== MessageType.CALL_MESSAGE) { - return reject(ocppError); - } - // Reject and remove request from the cache - return errorCallback(ocppError, false); - } - // Resolve response - if (messageType !== MessageType.CALL_MESSAGE) { - return resolve(messagePayload); - } - }), - OCPPConstants.OCPP_WEBSOCKET_TIMEOUT, - new OCPPError( - ErrorType.GENERIC_ERROR, - `Timeout for message id '${messageId}'`, - commandName, - (messagePayload as JsonObject)?.details ?? Constants.EMPTY_FREEZED_OBJECT - ), - () => { - messageType === MessageType.CALL_MESSAGE && chargingStation.requests.delete(messageId); + (messagePayload as OCPPError).details + ) + ) } - ); + }) } throw new OCPPError( ErrorType.SECURITY_ERROR, - `Cannot send command ${commandName} PDU when the charging station is in ${chargingStation.getRegistrationStatus()} state on the central server`, + `Cannot send command ${commandName} PDU when the charging station is in ${chargingStation.bootNotificationResponse?.status} state on the central server`, commandName - ); + ) } - private buildMessageToSend( + private buildMessageToSend ( chargingStation: ChargingStation, messageId: string, messagePayload: JsonType | OCPPError, messageType: MessageType, - commandName: RequestCommand | IncomingRequestCommand, - responseCallback: ResponseCallback, - errorCallback: ErrorCallback + commandName: RequestCommand | IncomingRequestCommand ): string { - let messageToSend: string; + let messageToSend: string // Type of message switch (messageType) { // Request case MessageType.CALL_MESSAGE: // Build request - this.validateRequestPayload(chargingStation, commandName, messagePayload as JsonObject); - chargingStation.requests.set(messageId, [ - responseCallback, - errorCallback, - commandName, - messagePayload as JsonType, - ]); + this.validateRequestPayload(chargingStation, commandName, messagePayload as JsonType) messageToSend = JSON.stringify([ messageType, messageId, - commandName, - messagePayload, - ] as OutgoingRequest); - break; + commandName as RequestCommand, + messagePayload as JsonType + ] satisfies OutgoingRequest) + break // Response case MessageType.CALL_RESULT_MESSAGE: // Build response this.validateIncomingRequestResponsePayload( chargingStation, commandName, - messagePayload as JsonObject - ); - messageToSend = JSON.stringify([messageType, messageId, messagePayload] as Response); - break; + messagePayload as JsonType + ) + messageToSend = JSON.stringify([ + messageType, + messageId, + messagePayload as JsonType + ] satisfies Response) + break // Error Message case MessageType.CALL_ERROR_MESSAGE: // Build Error Message messageToSend = JSON.stringify([ messageType, messageId, - (messagePayload as OCPPError)?.code ?? ErrorType.GENERIC_ERROR, - (messagePayload as OCPPError)?.message ?? '', - (messagePayload as OCPPError)?.details ?? { commandName }, - ] as ErrorResponse); - break; + (messagePayload as OCPPError).code, + (messagePayload as OCPPError).message, + (messagePayload as OCPPError).details ?? { + command: (messagePayload as OCPPError).command + } + ] satisfies ErrorResponse) + break } - return messageToSend; + return messageToSend } - private handleSendMessageError( + private setCachedRequest ( chargingStation: ChargingStation, + messageId: string, + messagePayload: JsonType, commandName: RequestCommand | IncomingRequestCommand, - error: Error, - params: HandleErrorParams = { throwError: false } + responseCallback: ResponseCallback, + errorCallback: ErrorCallback ): void { - logger.error(`${chargingStation.logPrefix()} Request command '${commandName}' error:`, error); - if (params?.throwError === true) { - throw error; - } + chargingStation.requests.set(messageId, [ + responseCallback, + errorCallback, + commandName, + messagePayload + ]) } - // eslint-disable-next-line @typescript-eslint/no-unused-vars public abstract requestHandler( chargingStation: ChargingStation, commandName: RequestCommand, - commandParams?: JsonType, + commandParams?: ReqType, params?: RequestParams - ): Promise; + ): Promise }