HttpRequest class

执行 HttpRequest的操作。

扩展

Dialog<O>

构造函数

HttpRequest()

初始化 HttpRequest 类的新实例。

HttpRequest(HttpMethod, string, [key: string]: string, any)

初始化 HttpRequest 类的新实例。

属性

$kind
body

Http 正文

contentType

请求正文的内容类型

disabled

如果为 true,则为 true 的可选表达式将禁用此操作。

headers

Http 标头

method

Http 方法

responseType

响应的响应类型

resultProperty

获取或设置要在其中存储 HTTP 响应的属性表达式。

url

Http Url

继承属性

EndOfTurn

获取默认的轮次结束结果。

id
telemetryClient

方法

beginDialog(DialogContext, O)

启动新的 对话框 并将其推送到对话堆栈上。

getConverter(Object)

继承的方法

configure(Record<string, unknown>)

用于配置对象的 Fluent 方法。

continueDialog(DialogContext)

在派生类中重写时,继续对话。

endDialog(TurnContext, DialogInstance, DialogReason)

在派生类中重写时,在对话结束之前执行清理。

getVersion()

用于帮助在重新部署时检测机器人更改的编码字符串。

onDialogEvent(DialogContext, DialogEvent)

通过使用当前对话或当前对话启动的对话,使用 DialogContext.emitEvent()引发事件时调用。

repromptDialog(TurnContext, DialogInstance)

在派生类中重写时,将用户重新分配输入。

resumeDialog(DialogContext, DialogReason, any)

在派生类中重写时,在堆栈上对话完成后恢复对话。

构造函数详细信息

HttpRequest()

初始化 HttpRequest 类的新实例。

new HttpRequest()

HttpRequest(HttpMethod, string, [key: string]: string, any)

初始化 HttpRequest 类的新实例。

new HttpRequest(method: HttpMethod, url: string, headers: [key: string]: string, body: any)

参数

method
HttpMethod

HttpMethod,例如 POST、GET、DELETE 或 PUT。

url

string

请求的 URL。

headers

[key: string]: string

请求的标头。

body

any

请求的原始正文。

属性详细信息

$kind

static $kind: string

属性值

string

body

Http 正文

body?: ValueExpression

属性值

ValueExpression

contentType

请求正文的内容类型

contentType?: StringExpression

属性值

StringExpression

disabled

如果为 true,则为 true 的可选表达式将禁用此操作。

disabled?: BoolExpression

属性值

BoolExpression

headers

Http 标头

headers?: [key: string]: StringExpression

属性值

[key: string]: StringExpression

method

Http 方法

method?: HttpMethod

属性值

responseType

响应的响应类型

responseType?: EnumExpression<ResponsesTypes>

属性值

EnumExpression<ResponsesTypes>

resultProperty

获取或设置要在其中存储 HTTP 响应的属性表达式。

resultProperty: StringExpression

属性值

StringExpression

url

Http Url

url?: StringExpression

属性值

StringExpression

继承属性详细信息

EndOfTurn

获取默认的轮次结束结果。

static EndOfTurn: DialogTurnResult

属性值

DialogTurnResult

注解

此结果指示对话(或对话中的逻辑步骤)已完成当前轮次的处理,仍然处于活动状态,并且正在等待更多输入。

继承自 Dialog.EndOfTurn

id

id: string

属性值

string

继承自 Dialog.id 的

telemetryClient

telemetryClient: BotTelemetryClient

属性值

BotTelemetryClient

继承自 Dialog.telemetryClient

方法详细信息

beginDialog(DialogContext, O)

启动新的 对话框 并将其推送到对话堆栈上。

function beginDialog(dc: DialogContext, _options?: O): Promise<DialogTurnResult>

参数

dc

DialogContext

当前会话轮次的 DialogContext

_options

O

自选。 要传递给对话的初始信息。

返回

Promise<DialogTurnResult>

表示异步操作的 Promise

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

参数

property

Object

条件选择器配置的键。

返回

Converter | ConverterFactory

选择器配置的转换器。

继承的方法详细信息

configure(Record<string, unknown>)

用于配置对象的 Fluent 方法。

function configure(config: Record<string, unknown>): this

参数

config

Record<string, unknown>

要应用的配置设置。

返回

this

操作完成后 可配置

继承自 Configure.configure

continueDialog(DialogContext)

在派生类中重写时,继续对话。

function continueDialog(dc: DialogContext): Promise<DialogTurnResult>

参数

dc

DialogContext

当前对话框轮次的上下文。

返回

Promise<DialogTurnResult>

解析为对话框轮次结果的承诺。

注解

支持多轮对话的派生对话应重写此方法。 默认情况下,此方法指示对话框已完成并返回。

DialogContext 在继续对话时调用此方法。

若要向对话上下文发出信号,表明此对话已完成,请等待 DialogContext.endDialog 退出此方法。

另请参阅

继承自 Dialog.continueDialog

endDialog(TurnContext, DialogInstance, DialogReason)

在派生类中重写时,在对话结束之前执行清理。

function endDialog(_context: TurnContext, _instance: DialogInstance, _reason: DialogReason): Promise<void>

参数

_context

TurnContext

轮次的上下文对象。

_instance

DialogInstance

此对话框的当前状态信息。

_reason

DialogReason

对话结束的原因。

返回

Promise<void>

注解

在结束之前需要执行日志记录或清理的派生对话应重写此方法。 默认情况下,此方法不起作用。

当当前对话结束时,DialogContext 调用此方法。

另请参阅

继承自 Dialog.endDialog

getVersion()

用于帮助在重新部署时检测机器人更改的编码字符串。

function getVersion(): string

返回

string

唯一字符串,仅当对话发生更改时,才应以重启对话框的方式更改。

注解

这默认返回对话 ID,但可以重写以提供更精确的更改检测逻辑。 堆栈上具有其版本更改的任何对话框都将导致引发 versionChanged 事件。 如果机器人未处理此事件,将引发错误,从而导致运行机器人错误处理程序逻辑。

返回空字符串将一起禁用组件的版本跟踪。

继承自 Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

通过使用当前对话或当前对话启动的对话,使用 DialogContext.emitEvent()引发事件时调用。

function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>

参数

dc

DialogContext

当前对话轮次的对话上下文。

e

DialogEvent

正在引发的事件。

返回

Promise<boolean>

如此 如果事件由当前对话框处理,并且冒泡应停止。

继承自 Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

在派生类中重写时,将用户重新分配输入。

function repromptDialog(_context: TurnContext, _instance: DialogInstance): Promise<void>

参数

_context

TurnContext

轮次的上下文对象。

_instance

DialogInstance

此对话框的当前状态信息。

返回

Promise<void>

注解

支持验证和重新提示逻辑的派生对话应重写此方法。 默认情况下,此方法不起作用。

DialogContext 在当前对话应从用户重新请求输入时调用此方法。 此方法是针对提示对话实现的。

另请参阅

继承自 Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

在派生类中重写时,在堆栈上对话完成后恢复对话。

function resumeDialog(dc: DialogContext, reason: DialogReason, result?: any): Promise<DialogTurnResult>

参数

dc

DialogContext

当前对话框轮次的上下文。

reason

DialogReason

对话恢复的原因。 这通常 DialogReason.endCalled

result

any

自选。 结束的对话框中的返回值(如果有)。

返回

Promise<DialogTurnResult>

解析为对话框轮次结果的承诺。

注解

支持多轮对话的派生对话应重写此方法。 默认情况下,此方法指示对话框已完成并返回。

DialogContext 恢复对话时调用此方法。 如果堆栈上的上一个对话框返回了一个值,则该值位于 result 参数中。

若要启动 对话,请使用 DialogContext.beginDialogDialogContext.prompt;但是,此对话不一定是启动子对话的对话框。 若要向对话上下文发出信号,表明此对话已完成,请等待 DialogContext.endDialog 退出此方法。

另请参阅

继承自 Dialog.resumeDialog