HandleHttpRequest
描述:
启动HTTP服务器并监听HTTP请求。 对于每个请求，创建一个数据流并输出到“success”连线。 此组件设计为与HandleHttpResponse组件一起使用，以创建Web服务
标签:
http, https, request, listen, ingress, web service, 请求, 监听, 网络服务
参数:
如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置.
| 名字 | 默认值 | 允许值列表 | 描述 |
|---|---|---|---|
| 监听端口 | 20001 | 监听用户请求HTTP请求服务的端口 | |
| 绑定主机 | 要绑定的主机名。 如果未指定，将绑定到所有主机 | ||
| SSL服务 | 控制器服务API: RestrictedSSLContextService 实现: StandardRestrictedSSLContextService | 用于保证服务器的SSL服务安全。 如果指定，服务器将仅接受HTTPS请求; 否则，服务器将只接受HTTP请求 | |
| HTTP会话服务 | 控制器服务API: HttpContextMap 实现: StandardHttpContextMap | HTTP会话服务，用于缓存HTTP请求信息 | |
| HTTP API注册服务 | 控制器服务API: ApiRegistryService 实现: StandardApiRegistryService | API管理平台注册服务，将被弃用，建议使用<API注册>代替 | |
| HTTP认证服务 | 控制器服务API: APIAuthenticationService 实现: AuthenticationService | 该服务用于请求的认证。 | |
| API注册 | 禁用 | - 启用 - 禁用 | 决定是否允许将该组件提供的Http服务同步注册到API管理平台 |
| 请求路径 | 支持正则表达式，指定传入URL请求中允许的有效HTTP路径。 如果指定了此值并且HTTP请求的路径与此正则表达式不匹配，则组件将响应404，同时该路径还支持简单的路径变量，比如/api/{id}, 数据流上将添加相应的http.query.param.id属性 | ||
| URL字符编码 | UTF-8 | 如果HTTP请求没有提供URL解码参数，则用于解码URL参数的字符集编码 | |
| 允许GET | 允许 | - 允许 - 禁止 | 允许HTTP GET方法 |
| 允许POST | 允许 | - 允许 - 禁止 | 允许HTTP POST方法 |
| 允许PUT | 允许 | - 允许 - 禁止 | 允许HTTP PUT方法 |
| 允许DELETE | 允许 | - 允许 - 禁止 | 允许HTTP DELETE方法 |
| 允许HEAD | 禁止 | - 允许 - 禁止 | 允许HTTP HEAD方法 |
| 允许OPTIONS | 禁止 | - 允许 - 禁止 | 允许HTTP OPTIONS方法 |
| 额外的HTTP方法 | 被允许的以逗号分隔的非标准HTTP方法列表 | ||
| 客户端身份认证 | 不认证 | - 不认证  - 尝试认证 - 需要认证 | 指定组件是否应对客户端进行身份验证。 如果未指定<SSL服务>属性或提供的SSL仅使用KeyStore而不使用TrustStore，则忽略此值。 |
| 请求队列大小 | 50 | Http请求容器队列的大小 |
连线:
| 名字 | 描述 |
|---|---|
| success | 收到的所有内容都将输出到“success”连线 |
读取属性:
未提供。
写入属性:
| 名字 | 描述 |
|---|---|
| http.context.identifier | 允许HandleHttpRequest和HandleHttpResponse协同时，数据流的HTTP请求/响应的标识符。 |
| mime.type | 数据的MIME类型，同http头“Content-Type”的定义 |
| http.servlet.path | 请求URL的一部分，Servlet路径 |
| http.context.path | 请求URL的一部分，Context路径 |
| http.method | 用于请求的HTTP方法，例如GET或POST |
| http.local.name | 服务器的IP地址/主机名 |
| http.server.port | 服务器的监听端口 |
| http.query.string | 请求URL的查询字符串 |
| http.remote.host | 请求者的主机名 |
| http.remote.addr | 请求者的IP:端口 |
| http.remote.user | 请求者的用户名 |
| http.protocol | 用于通信的协议 |
| http.request.uri | 完整的请求URL |
| http.auth.type | 使用的HTTP授权类型 |
| http.principal.name | 发出请求的经过身份验证的用户的名称 |
| http.subject.dn | 客户端的专有名称。 除非将组件配置为使用SSLContext服务，否则不会填充此值 |
| http.issuer.dn | 颁发主题证书的实体的专有名称。 除非将组件配置为使用SSLContext服务，否则不会填充此值 |
| http.headers.XXX | 请求中收到的每个HTTP标头都将作为属性添加，前缀为“http.headers”。 例如，如果请求包含名为“x-my-header”的HTTP标头，则该值将添加到名为“http.headers.x-my-header”的属性中 |
状态管理:
该组件不保存状态。
限制:
该组件没有限制
输入流要求:
组件禁止提供输入流。
系统资源考量:
未提供。