编程语言编译器云原生语言运行时【免费下载链接】wingA programming language for the cloud ☁️ A unified programming model, combining infrastructure and runtime code into one language ⚡项目地址https://gitcode.com/gh_mirrors/wi/wing点击查看免费下载技术速览cloud.Endpoint是 Wing 标准库winglang/sdk中用于描述“对外可访问端点”的预置资源resource。它本身并不负责创建或托管服务而是把一段目标 URL 作为编译产物的一部分输出——让 Wing 编译出的基础设施如 API、Website在部署后能直接对外暴露访问地址并能在 Wing Console 等 UI 中以“端点卡片”的形式直观呈现。读完本文你将掌握cloud.Endpoint的构造方式、EndpointProps的完整配置项、它在sim/tf-aws/awscdk三类目标平台下的落地差异以及如何通过测试用例验证其行为。1. 为什么需要cloud.Endpoint在 Wing 的统一编程模型里预置preflight代码会生成云资源inflight 代码则运行在云端。很多真实业务里基础设施编排完成后还需要向外部暴露访问入口API 网关的公网地址、静态网站的分发 URL、或任何自定义的外部链接。cloud.Endpoint正是为此而生——它不是请求代理也不是反向代理而是一个“端点声明”你把 URL 交给它Wing 会在编译产出的目标平台Terraform / CloudFormation / 模拟器中以对应的“输出Output”机制记录这个 URL同时给 Wing Console 提供用于展示的元信息标签、浏览器可达性。源码层面Endpoint继承自Resource其核心实现位于 packages/winglang/sdk/src/cloud/endpoint.tsexport class Endpoint extends Resource { private _url!: string; protected _label: string | undefined; protected _browserSupport: boolean | undefined; constructor(scope: Construct, id: string, url: string, props?: EndpointProps) { if (new.target Endpoint) { return Resource._newFromFactory(ENDPOINT_FQN, scope, id, url, props); } ... this._url url; this._label props?.label; this._browserSupport props?.browserSupport; } }可以看到Endpoint的本质是一个“纯声明型”资源构造阶段接收 URL并可选地接收props类内部只保存字段不发起任何网络请求或资源创建。2. 基本用法创建并暴露一个端点根据官方文档 endpoint.md 的示例最简用法是bring cloud; let endpoint new cloud.Endpoint(https://example.com);new cloud.Endpoint(url)的构造函数签名由三个参数组成scope与id由编译器自动注入url: str为必填即要对外暴露的 URLprops?: EndpointProps为可选的配置对象。上述示例对应的可运行测试样例在 tests/doc_examples/valid/endpoint.md_example_1/main.w 与 tests/doc_examples/valid/endpoint.md_example_2/main.w 中均有收录属于文档的“可编译”示例。2.1 与cloud.Api组合暴露 API 的真实地址cloud.Endpoint更常见的用法是承接其他资源的运行期 URL。例如把 API 网关的地址包装成端点bring cloud; bring http; let api new cloud.Api(); api.get(/, inflight () { return { status: 200, body: OK }; }); let endpoint new cloud.Endpoint(api.url); assert(endpoint.url api.url); test access endpoint url { assert(http.get(endpoint.url).body OK); }这段来自 tests/sdk_tests/endpoint/url.test.w 的测试印证了两个关键事实cloud.Api本身内部就持有一个Endpoint见 cloud/api.ts其urlgetter 直接委托给this._endpoint.url而cloud.Api构造函数接受的url参数也会据此构造内部端点Endpoint.url是可读的属性且等于构造时传入的 URL在测试中通过http.get(endpoint.url)还能真正访问到该 URL 背后的服务说明 Endpoint 就是“URL 的搬运工”。需要特别指出Endpoint只是把已有 URL 声明为公开端点并输出到编译产物它不会替你创建 API 或网站。要生成 API 请使用cloud.Api见 cloud/api.ts要托管静态站点请使用cloud.Website其内部同样暴露了_endpoint见 cloud/website.ts。3.EndpointProps为端点添加 UI 元信息cloud.Endpoint支持通过构造函数的第二个参数传入EndpointProps用于在 Wing Console 等图形界面中更好地展示端点。其定义见 endpoint.ts属性类型必填说明labelstr否端点的展示标签仅用于 UI 展示。示例My Dashboard。默认undefinedbrowserSupportbool否该端点是否可通过浏览器访问仅用于 UI 展示如控制图标显示。默认undefined在 Wing 中按结构体字面量传入bring cloud; new cloud.Endpoint(https://example.com, { label: My Dashboard, browserSupport: true, });这两项配置在模拟器实现中会被完整透传。查看 target-sim/endpoint.ts 可以看到toSimulator()输出的EndpointSchema结构定义于 schema-resources.tsconst props: EndpointSchema { inputUrl: this._inputUrl, // 构造时传入的原始 URL url: this.url, // 对外输出的 URL label: this.label, // 标签 browserSupport: this.browserSupport, // 浏览器可达性 };而在基类 endpoint.ts 中label还会被写入构造节点Construct Node的描述Node.of(this).description props?.label ?? A cloud endpoint即当不传label时端点在资源树中的描述默认显示为 “A cloud endpoint”。4. 多目标平台的实现差异cloud.Endpoint是一个抽象资源真正落地的行为取决于你选择的编译目标platform。官方文档在 endpoint.md 的 “Target-specific details” 一节给出了四类目标的说明下面结合源码逐一展开。4.1 模拟器sim行为模拟实现会把端点 URL 作为模拟器资源输出toSimulator()输出cloud.Endpoint类型的资源见 target-sim/endpoint.tsWing Console 中会以可交互的端点卡片呈现。源码里更有意思的是模拟器的 inflight 实现 target-sim/endpoint.inflight.ts它内置了基于winglang/wingtunnels的本地隧道机制。当状态文件state.json中存有上次运行使用的子域名时init()会通过connect(subdomain)为inputUrl建立隧道并把隧道分配的公网 URL 作为最终输出的urlurl: this.connectResponse?.url ?? this._props.url。同时它暴露了expose()/hide()/exposeStatus()三个方法分别用于对外暴露、关闭隧道和查询连接状态connected | disconnected | connecting见EndpointExposeStatus类型。这意味着在模拟器中端点不仅“展示”还能通过隧道临时对外开放方便联调。4.2 AWS Terraformtf-aws行为tf-aws实现把端点 URL 生成为Terraform Output即terraform output可查询的部署输出值。源码见 target-tf-aws/endpoint.ts它继承自共享 AWS 实现 shared-aws/endpoint.tsexport class Endpoint extends AwsEndpoint { constructor(scope, id, url, props {}) { super(scope, id, url, props); new TerraformOutput(this, Url, { value: this.url, }); } }即每次apply后terraform output会列出名为Url的输出项值是端点 URL。同时shared-aws/endpoint.ts 定义了该资源的 “lift” 逻辑onLift()会把 URL 以环境变量的形式注入 inflight 宿主host_liftedState()把$url映射为process.env[环境变量名]环境变量名由ResourceNames.generateName生成统一转大写、非法字符替换为_。而 inflight 客户端 shared-aws/endpoint.inflight.ts 仅保存url字段export class EndpointClient implements IEndpointClient { public readonly url: string; public constructor({ $url }: { $url: string }) { this.url $url; } }注意EndpointInflightMethods为空枚举见 endpoint.tsIEndpointClient也没有任何方法endpoint.ts——因为Endpoint的“运行期能力”就只有一个只读的url字段没有可调用的 inflight 方法。这也是为什么在 Wing 中它更多被当作“元数据输出”而非可执行资源。4.3 AWS CDKawscdk行为awscdk实现使用CloudFormation Output输出端点 URL。官方文档明确指出其对应 AWS CloudFormation 的 outputs-section 结构即部署后可在 CloudFormation 控制台或aws cloudformation describe-stacks的输出区看到该值。仓库中该目标的实现遵循同一模式在栈资源中声明一个输出项值为this.url。在当前仓库的packages/winglang/sdk/src目录结构中CDK 目标相关实现位于shared-aws与各target-*目录的协同之下Endpoint的抽象定义与 lift 逻辑均复用了 endpoint.ts 与 shared-aws/endpoint.ts 中的实现。4.4 Azure 与 GCPtf-azure/tf-gcp行为官方文档标注为 Not supported yet。也就是说目前这两个目标平台尚未提供cloud.Endpoint的落地实现在相应目标下使用该资源会得到不支持的错误。若你的应用需要在 Azure / GCP 上对外暴露端点需要关注 Wing 后续版本的支持进展。5. API 速查以下是cloud.Endpoint的公开 API 汇总与文档 endpoint.md 的 API Reference 部分一致构造函数bring cloud; new cloud.Endpoint(https://example.com); // 或携带可选 props new cloud.Endpoint(url, { label: My Dashboard, browserSupport: true });参数类型必填说明urlstr✅端点 URLpropsEndpointProps❌端点配置label / browserSupport属性属性类型说明urlstr端点 URL只读propsEndpointProps端点配置只读EndpointProps字段字段类型说明labelstr端点标签仅用于 UI 展示。示例My DashboardbrowserSupportbool端点是否支持浏览器访问仅用于 UI 展示6. 小结与使用建议cloud.Endpoint是 Wing 标准库中一个“小而专”的资源它的核心价值在于声明式输出把 URL 编入编译产物Terraform Output / CloudFormation Output部署后可查询UI 呈现通过label与browserSupport让 Wing Console 直观展示端点跨平台一致sim、tf-aws、awscdk均以“输出 URL”为共同语义tf-azure、tf-gcp尚未支持使用时需注意平台选择零运行负担没有 inflight 方法只是 URL 的载体因此不会有额外的运行时开销。典型组合套路cloud.Api或cloud.Website负责创建真实服务 → 用new cloud.Endpoint(api.url)把公网地址声明为端点 → 在目标平台输出中拿到最终 URL或直接在 Wing Console 中查看与通过隧道联调。如果你只是想给已有资源“贴一个可访问的标签”cloud.Endpoint就是最轻量、最贴合 Wing 心智模型的选择。参考路径本文涉及的源码与测试文件均位于当前仓库定义与配置项见 cloud/endpoint.ts官方文档见 cloud/endpoint.md模拟器实现见 target-sim/endpoint.ts 与 target-sim/endpoint.inflight.tsAWS 共享实现见 shared-aws/endpoint.tstf-aws实现见 target-tf-aws/endpoint.ts行为验证见 tests/sdk_tests/endpoint/url.test.w。赞分享编程语言编译器云原生语言运行时【免费下载链接】wingA programming language for the cloud ☁️ A unified programming model, combining infrastructure and runtime code into one language ⚡项目地址https://gitcode.com/gh_mirrors/wi/wing点击查看免费下载相关推荐java-design-patterns 之 Event Aggregator事件聚合器模式集中式事件管理的完整实战指南java design patterns 之 Event Aggregator事件聚合器模式集中式事件管理的完整实战指南 Event Aggregator编程语言编译器云原生语言运行时Wasp 自定义 HTTP API 端点Custom APIs完全指南从声明到部署的实践详解Wasp 自定义 HTTP API 端点Custom APIs完全指南从声明到部署的实践详解 导读 Wasp 默认通过 OperationsQuery后端前端Web框架编译器开发工具代码生成D-FINE模型部署模式云端、边缘、端侧不同部署方案D FINE模型部署模式云端、边缘、端侧不同部署方案 概述 D FINEFine grained Distribution Refinement作为新一代人工智能计算机视觉深度学习上一篇class-transformer终极指南深度剖析Type装饰器的强大功能下一篇终极Wifite2教程5分钟识破无线网络中的恶意攻击创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
