长弓三石

本文介绍了使用仓颉语言开发TLS客户端示例的过程，包含TLS单向认证模式选择和具体实现步骤。示例展示了客户端与服务端的连接、信息收发功能，支持输入服务端地址和端口，并能够发送带换行符的消息。开发中采用TrustAll证书验证模式简化测试，界面包含连接按钮、消息输入框和通讯记录显示区域。代码部分详细说明了权限配置、组件构建和事件处理，包括输入校验、消息发送及历史记录更新等功能。该示例为仓颉语言网络编程提供了实用参考。

摘要： 本文介绍了在鸿蒙OS（API 17）中使用仓颉语言实现TLS加密回声服务器的开发过程。传统TCP/UDP通信存在明文传输的安全风险，TLS协议通过加密保障数据安全。文章详细展示了服务端配置数字证书和私钥的步骤，并提供了完整的仓颉代码实现，包括权限声明、UI界面设计（支持证书/私钥文件选择）、服务端端口绑定等功能。关键类如TlsSocket和TlsServerConfig用于建立加密通信，后续将结合客户端进行数据收发测试。（150字）

本文介绍了TLS数字证书验签的基本原理和实现方法。主要内容包括： 数字证书信任链的构成：根证书→中间证书→用户证书，形成完整的信任链验证机制。 证书验签实践演示： 通过浏览器导出百度网站的证书链 使用仓颉语言开发移动端应用 实现证书选择、查看和验签功能 展示正确证书验签通过和错误证书验证失败的场景 技术实现要点： 申请网络访问权限 配置仓颉编译环境 定义证书状态管理类 实现证书文件选择器 集成证书验证功能 该示例展示了完整的数字证书验证流程，为开发安全通信应用提供了参考实现。通过证书链验证机制，可有效确保证

本文介绍了使用固定包头可变包体方案解决TCP粘包问题的方法。该方案通过在数据包前添加2字节固定包头来记录包体长度，避免了传统结束标志法的局限性。文章展示了在鸿蒙系统仓颉语言API17环境下的实现步骤，包括项目创建、权限配置、代码编写等关键环节。演示示例通过TCP回声服务器测试，成功实现了数据包的完整收发，解决了粘包问题。主要代码展示了如何构建包含长度信息的包头，以及如何通过缓冲区管理确保数据包的完整性。该方法适用于需要稳定传输数据的网络应用场景。

本文介绍了使用数据包结束标志解决TCP粘包问题的方法。通过在消息尾部添加边界标志（如"\r\n"），接收端可以准确识别完整数据包。文章提供了仓颉语言编写的示例代码，展示了如何实现该方案，包括创建TCP连接、发送带结束标志的数据包，以及接收处理逻辑。测试结果表明该方法有效解决了粘包问题，确保了数据完整传输。关键步骤包括：配置网络权限、设置接收缓冲区、查找结束标志位置进行包分割。

在基于TCP协议的端到端通讯中，如果一端连续发送两个或者两个以上的数据包，对端在一次接收时，收到的数据包数量可能大于1个，也可能是几个完整数据包加上一个完整包的一部分数据，这些统称为粘包。在本系列的第6篇文章《鸿蒙网络编程系列6-TCP数据粘包表现及原因分析》中，基于ArkTS语言在API9环境下使用TCPSocket对象演示了数据粘包的表现，因为粘包是和TCP协议直接相关的，所以，在API17下，使用仓颉语言一样可以实现类似的效果

本文介绍了基于仓颉语言在API17环境下实现SMTP邮件发送客户端的开发过程。通过搜狐邮箱服务器（地址116.130.217.16，端口25）演示了邮件发送功能，包括登录验证、邮件内容填写和发送等步骤。文章详细说明了项目创建、权限配置、UI界面搭建等关键环节，并提供了完整的代码示例。开发过程中需要注意搜狐邮箱需使用独立密码登录，区别于腾讯邮箱已强制要求SSL/TLS加密方式。该示例展示了鸿蒙系统网络编程的基本方法，具有实用参考价值。

在本系列的第5篇文章《鸿蒙网络编程系列5-TCP连接超时分析》中，介绍了基于ArkTS语言使用TCPSocket对象连接TCP服务端超时的示例。不过，在基于仓颉语言的鸿蒙应用开发中，并没有提供类似的鸿蒙API，幸运的是，仓颉语言自己内置了更强大的TcpSocket对象，可以使用该对象连接TCP服务端。

在本系列的第51篇文章《鸿蒙网络编程系列51-仓颉版使用Request部件下载文件到本地》中介绍了如何使用Request部件下载文件，Request部件还具有上传文件的能力，本文将通过一个示例演示该能力在仓颉语言下的实现。本文使用的服务端为本系列第13篇文章《鸿蒙网络编程系列13-使用Request部件上传文件到服务端示例》中使用的服务端。

鸿蒙系统提供了上传下载部件，即Request部件，封装了上传下载能力，方便了相关功能的开发。不过，在当前适配仓颉语言的Request部件中，只提供了基于代理（Agent）的上传下载能力，方便性也相对ArkTS语言差一些，毕竟是刚开始适配，以后应该会提供更丰富的功能。

TCP服务端是基于TCP协议构建的一种网络服务模式，它为HTTP（超文本传输协议）、SMTP（简单邮件传输协议）等高层协议的应用程序提供了可靠的底层支持。在TCP服务端中，服务器启动后会监听一个或多个端口，等待客户端发起连接请求。当接收到客户端的连接请求时，服务端会响应并建立一个全双工的连接，并确保双方都准备好进行数据交换。一旦连接建立成功，服务端就能够开始接收来自客户端的数据，并根据需要向客户端发送响应信息。对于运行在TCP服务端之上的应用层协议来说，这种可靠的服务是非常重要的。

TCP协议作为传输层的核心协议，确保了数据传输的可靠性与顺序性，构成了许多广泛应用的高层协议的基础。相较于UDP，TCP在正式开始数据传输前需完成三次握手以建立连接，这一过程虽然使得TCP在效率上略逊一筹，但其采用的发送-确认机制确保了数据传输的高度可靠性。此外，通过引入滑动窗口机制，TCP不仅能够有效提升数据传输效率，还能够在一定程度上优化网络资源的利用。因此，尽管TCP在建立连接方面存在一定的开销，但它凭借强大的可靠性和高效的传输特性，在众多应用场景中占据着不可或缺的地位。

回声服务器指的是这样一种服务器，它接受客户端的连接，并且把收到的数据原样返回给客户端，本系列的第2篇文章《鸿蒙网络编程系列2-UDP回声服务器的实现》中基于ArkTS语言在API 9的环境下实现了UDP回声服务器，本文将使用仓颉语言在API 12的环境中实现类似的功能。当然，UDP是无连接的协议，没有所谓的服务端，严格来说，UDP回声服务器并不是一个服务器，而是一个UDP客户端，和普通客户端不不同的是，作为UDP回声服务器的客户端，不主动发送消息，只是在接收到消息以后，才会给发送端回复同样的消息。

本系列的第1篇文章《鸿蒙网络编程系列1-UDP通讯示例》中基于ArkTS语言在API 9的环境下演示了UDP通讯的基础用法，本文将使用仓颉语言在API 12的环境中实现类似的功能。这可能听起来有点不太现实，在ArkTS语言下可以利用kit.NetworkKit下的socket模块，该模块包含UDPSocket类，使用该类可以进行UDP通讯。

本系列的第18篇文章《鸿蒙网络编程系列18-Web组件加载网页的四种方式示例》中，使用ArkTS语言基于API 9环境演示了Web组件四种加载网页内容的方式，其中就包括使用WebviewController的loadData方法直接加载HTML脚本的方式。不过，目前的仓颉版本还不支持loadData方法，因此，本文将基于API 12环境演示Web组件加载网页的其他三种方式。

数字证书是网络安全的重要基础，它通过数字签名来保证数据的完整性和真实性。HTTPS协议通过数字证书来保证通信的安全性，数字证书由数字证书机构（CA）颁发，购买商业版本的数字证书需要不菲的费用，周期也较长，在系统的开发和测试期间，可以使用自签名的数字证书，这种方式方便快速，也不需要费用，在系统正式部署以后，可以切换为正式的证书。鸿蒙的httpRequest类支持配置自定义的CA证书，通过配置CA证书，可以不使用系统CA证书进行校验，从而实现对HTTPS证书的自选CA校验。

在本系列的第21篇文章《鸿蒙网络编程系列21-使用HttpRequest上传任意文件到服务端示例》中，使用ArkTS语言基于API 9环境演示了文件上传功能的实现，本节将使用仓颉语言基于API 12环境实现类似的功能。

在本系列的第10篇文章《鸿蒙网络编程系列10-使用HttpRequest下载文件到本地示例》中，使用ArkTS语言在API 9环境下演示了基于HttpRequest进行文件下载的功能，本章将使用仓颉语言在API 12环境下实现类似的功能。因为本示例使用的下载网站必须登录后才可以下载，所以，需要先模拟登录，获取登录后的cookie，再使用cookie进行文件下载。

域名解析是网络开发中经常使用的功能之一，特别是对于当前版本的鸿蒙API，使用TCP或者UDP等网络协议通讯时，只能使用确定的IP地址进行绑定或者发送消息，还不支持直接使用域名，所以，通过域名解析得到对应的IP地址，然后再使用套接字进行通讯，可以避免使用者记录IP地址的困难。在本系列的第15篇文章《鸿蒙网络编程系列15-域名解析示例》中，我们基于ArkTS语言在API 9的环境下演示了对网站域名进行解析的过程，本文将使用仓颉语言在API 12的环境中实现类似的功能。//获取默认激活的数据网络。

在本系列的第9篇文章《鸿蒙网络编程系列9-使用HttpRequest模拟登录示例》中，我们基于ArkTS语言在API 9的环境下使用HttpRequest发起HTTP请求，模拟了对目标网站的登录，本文将使用仓颉语言在API 12的环境中实现类似的功能。//创建一个HTTP请求，每一个HttpRequest对象对应一个HTTP请求,如需发起多个HTTP请求，须为每个请求创建对应对象。//根据URL地址，发起HTTP网络请求，在callback回调函数中返回响应。

数字证书的验签是网络编程中一个重要的功能，它保证了数字证书的真实性，在此基础上，我们才可以信任该证书，从而信任基于该证书建立的安全通道，所以说，数字证书的验签是通讯安全的基石，了解数字证书验签的原理和方法，有助于我们建立安全的通讯。该方法可以通过CA的公钥来验证证书的有效性。本文将通过一个示例演示数字证书内容的查看方法以及如何对一个数字证书进行验签。

web组件在加载了网页以后，有两种方式可以实现打印，第一种是在网页中调用W3C标准协议接口window.print()进行打印，这种方式比较简单方便，只要网页中触发了该方法即可打印，缺点是如果网页没有地方触发则不能打印；另外一种是在应用侧实现的，通过web控制器的createWebPrintDocumentAdapter方法创建打印适配器，然后将适配器传入打印的print接口即可调起打印，虽然有点复杂，但是可以打印任何网页；本文将分别演示这两种打印方式的实现。

/下载开始前通知用户，用户需要在此接口中调用WebDownloadItem.start提供下载路径//下载过程中的回调//下载完成后的回调//下载失败时的回调web组件在下载状态变化时会自动调用委托中的对应回调函数。本文将通过一个示例演示web组件的下载能力，通过进度条展示下载进度的变化。

在本系列的第7、8篇文章，分别讲解了基于TLS传输单向和双向认证的通讯示例，这两个示例都是TLS客户端直接连接TLS服务端的。众所周知，TLS通讯也是基于TCP协议的，首先在TCP协议上，客户端和服务端连接成功，然后双方经过TLS握手过程，认证数字证书，最后再进行加密的通讯。既然这样，能不能先显式建立TCP连接，然后把这个连接再升级为TLS协议呢？通过该函数，可以基于一个已经建立连接的TCP套接字生成TLS客户端，然后不经过调用bind函数，就可以和服务端建立连接。

在本系列的第6篇文章《鸿蒙网络编程系列6-TCP数据粘包表现及原因分析》中，我们演示了TCP数据粘包的表现，如图所示：随后解释了粘包背后的可能原因，并给出了解决TCP传输粘包问题的两种思路，第一种是指定数据包结束标志，在本系列第35篇《鸿蒙网络编程系列35-通过数据包结束标志解决TCP粘包问题》中给出了具体的实现，第二种是通过固定包头指定包的长度，本文将通过一个示例演示这种思路的实现。

Wifi热点是移动设备接入网络的重要形式，特别是在不具备固定网络接入点的情况下，可以通过Wifi热点灵活方便的接入网络，因此在日常生活中具有广泛的应用。//返回扫描到的热点列表//查询WLAN信号强度。//添加候选网络配置//连接到自己添加的候选网络（如果当前已经连接到热点，需要先断开连接）。

在本系列的第6篇文章《鸿蒙网络编程系列6-TCP数据粘包表现及原因分析》中，我们演示了TCP数据粘包的表现，如图所示：随后解释了粘包背后的可能原因，并给出了解决TCP传输粘包问题的两种思路，其中一种就是指定数据包结束标志，本节将通过一个示例演示这种思路的实现。

在Web开发中拦截器是一种非常有用的模式，它允许开发者在请求发送到服务器之前或响应返回给客户端之前执行一些预处理或后处理操作。这种机制特别适用于需要对所有网络请求或响应进行统一处理的情况，比如添加全局错误处理、请求头的修改、响应数据的格式化等，本示例将使用RCP模块提供的拦截器功能，实现对HTTP请求的性能监控，为简单起见，本示例只记录每个HTTP请求和响应的时间以及相关的状态信息，读者可以根据需要记录更多的信息并在此基础上进行深入的统计分析。

这种通讯方式一般来说没什么问题，但是在需要对内容保密的情况下就不可取了，毕竟它们都是通过明文进行通讯的，如果数据包在传输过程中被拦截，攻击者可以直接读取其中的信息，这使得用户的敏感信息（如密码、个人资料等）容易遭受窃听或篡改。当使用TLS进行通讯时，客户端和服务器会先进行一个握手过程，在这个过程中双方协商加密算法、交换加密密钥等，之后所有传输的数据都会被加密，即使数据包被第三方截获，由于没有解密密钥，第三方也无法读取数据的真实内容。可以看到，TLS服务端连接成功了，并且在日志区域输出了服务端的证书信息。

在OpenAI推出GPT系列大模型以后，市场上各种类似的大模型也层出不穷，这些大模型也基本都会兼容OpenAI的接口，在开发基于大模型的应用时，选择使用OpenAI接口作为和后端大模型通讯的标准，可以更好的适配不同厂家的模型。本节将开发一个简单的智能助手，可以支持OpenAI兼容的大模型作为后端使用，本示例将演示如何使用RCP模块调用OpenAI兼容接口，如何把一个对象实例转换为Json字符串作为传递的参数，以及在接收到HTTP响应的字符串后，如何转换为对象实例。

RCP模块是Harmony NEXT全新开发的HTTP数据请求能力接口，它为上传下载能力专门封装了几个方法，针对下载能力，主要是下载到文件的downloadToFile方法：以及下载到流的downloadToStream方法：两个方法都是通过参数url指定下载要请求的地址，通过参数downloadTo指定写入的文件或者数据流。本文将通过一个示例演示RCP下载能力的使用，并分别下载到文件和数据流。

在鸿蒙API10以后，提供了TCPSocketServer类，该类封装了TCP服务端的相关接口，包括用来监听的listen方法，订阅各种事件的on方法，以及发送数据的send方法，关于这些接口的简介见前文。在本示例中，要注意的是TCP服务端是可以接受多个客户端的连接的，也就是说在订阅连接事件的消息并进行处理时，每一个连接（TCPSocketConnection）都代表一个新的TCP客户端，这些客户端都是互相独立的，要处理与客户端的消息收发，就要订阅每一个连接的接收消息事件。

在文件的下载中，特别是大文件的下载中，可能会出现各种原因导致的下载暂停情况，如果不做特殊处理，下次还需要从头开始下载，既浪费了时间，又浪费了流量。不过，HTTP协议通过Range首部提供了对文件分块下载的支持，也就是说可以指定服务器返回文件特定范围的数据，这就为我们实现文件的断点续传提供了基础。

TLS安全通讯的基础是基于对操作系统或者浏览器根证书的信任，如果CA证书签发机构被入侵，或者设备内置证书被篡改，都会导致TLS握手环节面临中间人攻击的风险。其实，这种风险被善意利用的情况还是很常见的，比如著名的HTTPS调试工具Fiddler，就是利用了这一点，通过让使用者信任自己签发的证书，达到替换服务端证书的目的，最终可以实现对HTTPS通讯的监听。那么，如何防范这种风险呢？

在鸿蒙客户端对服务端发起HTTPS请求时，如果使用HttpRequest的request发起请求，那么就存在服务端数字证书的验证问题，你只有两个选择，一个是使用系统的CA，一个是使用自己选定的CA，在上文。选择证书验证模式，在请求地址输入要访问的https网址，然后单击“请求”按钮，就可以在下面的日志区域显示请求结果。这里为简单起见，自定义规则是所有的验证都通过，读者可以根据自己的需要来修改，比如不验证证书的有效期。可不可以自定义验证规则，比如，只验证数字证书的公玥，忽略有效期，就是说失效了也可以继续用。

包括了HttpRequestOptions类型的options，可以指定发起请求的参数，其中就包括caPath，如果设置了caPath，系统将使用用户指定路径的CA证书，而不是系统的CA证书，这就给我们提供了一个方法，使用自签名证书的CA证书来验证服务端证书，从而达到正常发起HTTPS请求的目的。选择证书验证模式，在请求地址输入要访问的https网址，然后单击“请求”按钮，就可以在下面的日志区域显示请求结果。在前述关于HttpRequest的文章中，比如。步骤4：编译运行，可以使用模拟器或者真机。

在通常的APP开发中，经常会采用内嵌网页的形式，通过网页来展现丰富的动态内容，虽少了很多原生开发的功能，但是这么做无可厚非，毕竟APP需要适配的系统平台很多，比如安卓、苹果、各种PC端，现在还有如日中天的鸿蒙系统；为每一种平台做定制难度还是很大的，但是这些平台的APP都支持内嵌网页，通过网页可以屏蔽各平台的差异，从而减少开发难度，提高开发效率。

如果你不想转义，其实也有办法，就是把data中的内容进行base64编码，然后把encoding参数设置为“base64”就可以了。鸿蒙系统提供了web组件，可以在APP里内嵌该组件显示网页信息，但是，很多开发者反应一种比较奇特的情况，就是在加载的网页里，如果含有字符#的话，就会出现白屏，或者是#后的内容无法显示。里已经介绍了，这种出现白屏的情况，一般都是因为使用了WebviewController的loadData方法进行加载。前面的内容#后面的内容，咋区别对待呢!Button("加载")

订阅TCPSocketServer的连接事件，在新的客户端套接字连接上以后，会触发callback回调，在回调中包含TCPSocketConnection对象，该对象就表示TCPSocket客户端与服务端的连接。当然，HTTP的协议还是有一点复杂的，这里就不展开了，不过我们明白，只要我们按照协议格式构造出了请求应答的文本，然后使用TCP协议作为传输层进行收发即可。虽然本示例比较简单，但是具备了HTTP服务端的基本功能，可以接收客户端的输入，并且可以对客户端的输入进行处理，最后再发送给客户端。

鸿蒙的web组件可以加载网页，如果网页本身具备文件上传功能的话就比较尴尬了，因为html上传文件时，允许用户选择本地文件，但是鸿蒙因为安全性的考虑，只允许操作沙箱中的文件，所以在web组件中的上传功能本身无法直接使用。