主要内容

matlab.net.URI类

包裹:matlab.net

统一资源标识符(URI)

描述

这个matlab.net.URI类构造internet统一资源标识符(URI),如web地址或URL。internet URI是一个分为多个组件的字符串。每个组件由URI类。下面的文本显示了属性及其相关的标点符号,为清晰起见,用空格分隔。空格不出现在编码的URI中。关联的标点符号不属于属性值的一部分。

Scheme: //Authority /Path(1) /Path(2)…/路径(结束)?查询#片段

在哪里权威包含以下属性:

UserInfo@Host:Port

使用matlab.net.URI字符串字符方法来创建internet URI。这些方法通过在非空属性中添加标点符号和转义保留字符来编码属性。

所有属性都是可选的。但是,不同的使用可能需要设置某些属性。

若要从输出字符串中删除属性及其标点符号,请将属性值设置为[]

创建

描述

obj = matlab.net.URI创建一个空URI。

实例

obj = matlab.net.URI (目的地)创建指定的URI目的地

实例

obj = matlab.net.URI (目的地,queryVector)设定查询财产queryVector查询值将附加到中已指定的任何查询参数目的地

obj = matlab.net.URI (目的地,queryName,查询值)添加一个或多个queryName,查询值参数到查询财产。

obj = matlab.net.URI (目的地,queryVector,queryName,查询值)增加了queryVectorqueryName,查询值参数到查询财产。

obj = matlab.net.URI (___,格式)指定数组出现在列表中时的输出格式查询值论点。您可以使用前面语法中的任何输入参数。

obj = matlab.net.URI (___“文字”)表明目的地已经编码。如果您复制并粘贴一个已经编码的URI(例如,从浏览器的地址栏),请使用此选项。当您直接读取这个URI的属性时,您将看到经过解码的版本。这个“文字”选项不允许构造非法URI。它防止重新编码“%”字符。必须始终编码的字符,例如“\”' '宿主路径,仍为百分比编码。

此选项对查询(matlab.net.QueryParameter)参数。

输入参数

全部展开

指定为字符串或指定URI或其部分的字符向量,或matlab.net.URI对象。如果目的地是一个matlab.net.URI对象,然后目的地这肯定是唯一的论点。

例子:https://user:pwd@www.tatmou.com:8000/product/matlab?abc=def&this=that#xyz所有属性

例子:主机和方案属性://www.tatmou.com

例子:仅限主机://www.tatmou.com

例子:主机和路径:/ / www.mathworks.co下载188bet金宝搏m/products/matlab/

例子:道路只有:下载188bet金宝搏products/matlab/live editor

例子:主机和查询://www.tatmou.com/search/site_search.html?q=weboptions

查询属性,指定为matlab.net.QueryParameter对象。查询的形式如下:

name1 = value1&name2 = value2&name3 = value3

例子:查询参数('hl','en','ie','utf8','num',50)

查询名称,指定为字符串或字符向量。web服务定义queryName,查询值对它作为请求的一部分接受的。不编码字符在queryName

查询值,指定为字符数组或数字、逻辑或日期时间值或数组。不编码字符在查询值

输出格式,指定为matlab.net.ArrayFormat对象中出现数组时查询值论点。有关允许的值,请参见ArrayFormat

这个格式参数不影响中值的格式queryVector论点。

属性

全部展开

URI方案,有时称为协议,出现在:/ /字符,指定为字符串或字符向量。计划总是返回一个字符串。如果不是空的,那么计划必须是httphttps.然而,这一公约并不强制执行。MATLAB®不支持其他方案,如金宝app文件

例子:http

例子:https

用户信息,指定为字符串或字符向量。用户信息出现在宿主属性后跟@的性格。这个字符串方法percent对特殊字符进行编码。设置时用户信息,不编码值。

例子:的名字

例子:名称:密码

主机名,指定为字符串或字符向量。格式为DNS (Domain Name System)或IPv4 (Internet Protocol version 4)或IPv6 (version 6)地址。这个字符串方法对URI的主机部分中不允许的字符进行百分比编码。一段字符()未更改。设置时宿主,不编码值。

例子:www.tatmou.com

例子:2222:7344:0db8:0000:0100:8a2e: 0370:85a3IPv6地址

端口号,指定为数字,或表示0–65535范围内数字的字符串或字符向量,存储为uint16

例子:8000

路径段,指定为字符串或字符串向量或字符向量或字符向量的单元格数组。结果始终是字符串向量。若要查看编码路径的值,请使用编码路径财产。

属性指定URI中的路径编码路径财产。编码路径是一系列的片段被/字符,其中每一个片段都是路径

路径(1)/路径(2)/路径(3)/.../路径(结束)

这个/字符不出现在路径,但编码路径包含它们。例如,

uri = matlab.net.URI;uri.Path={“下载188bet金宝搏产品”matlab的}; P=uri.Path
P = "下载188bet金宝搏products" "matlab"
EP=uri.EncodedPath
EP=产品下载188bet金宝搏/matlab

如果你设置路径到包含/字符,然后该值在/结果与指定字符串向量或字符向量的单元格数组相同。

uri。路径=“下载188bet金宝搏产品/ matlab”;P = uri。路径
P = "下载188bet金宝搏products" "matlab"

总还有一个路径段的个数/字符编码路径。任何段都可以是空字符串。如果路径(1)是一个空字符串,那么编码路径始于/.如果路径(结束)是一个空字符串,那么编码路径/

uri。路径=“/下载188bet金宝搏产品/ matlab /”;EP=uri.EncodedPath
EP = /下载188bet金宝搏产品/ matlab /

设置时路径对于非标量字符串或单元格数组,URI的路径部分中不允许的字符将以百分比编码编码路径。包括#性格

uri.Path={“foo#bar”}; EP = uri。EncodedPath
EP = foo % 23条

不要对数据进行编码#的性格。如果您这样做,那么已编码的字符将被再次编码。

uri.Path={“foo % 23 fbar”};EP=uri.EncodedPath
EP=foo%2523Fbar

路径可以是相对的也可以是绝对的。绝对路径是一个有多个段的路径,其第一个段是空的。它被编码为以/后跟第二个字符串的字符。绝对路径的定义对应于path-absolute,定义于RFC 3986第3.3节.相对路径是第一个字符串非空的路径。它的编码没有前导/. 例如,创建绝对路径:

uri1=matlab.net.URI;uri1.Path={''“下载188bet金宝搏产品”matlab的};EP = uri1。编码路径
EP = /下载188bet金宝搏产品/ matlab

创建相对路径:

uri2=matlab.net.URI;uri2.Path={“下载188bet金宝搏产品”matlab的};EP=uri2.EncodedPath
EP=产品下载188bet金宝搏/matlab

如果URI包含计划,宿主,用户信息港口城市财产,路径难道不是空的吗编码路径他有领导才能/.这个/字符分隔开路径从其他属性。因此,绝对路径和相对路径之间的区别只存在于不包含计划,宿主,用户信息,或港口城市属性。例如,尿酸1这是一条绝对的道路。

uri1.EncodedPath
ans=/pr下载188bet金宝搏oducts/matlab

设置宿主:

1.主持人=“www.tatmou.com”;disp (string (uri1))
//www.tatmou.com/下载188bet金宝搏products/matlab

设置宿主的相对路径尿酸2:

uri2。编码路径
ans =产下载188bet金宝搏品/ matlab
uri2。宿主=“www.tatmou.com”;disp (string (uri2))
//www.tatmou.com/下载188bet金宝搏products/matlab

要创建具有指向根路径的URI,请设置路径string.empty["" ""]

uri.Path={“下载188bet金宝搏产品”matlab的''};EP=uri.EncodedPath
EP / 下载188bet金宝搏matlab / =产品

设置路径对于文件夹,在向量末尾添加一个空字符串。此约定会添加一个尾随字符串/编码路径

uri.Path={“下载188bet金宝搏产品”matlab的''};EP=uri.EncodedPath
EP / 下载188bet金宝搏matlab / =产品

URI的查询,指定为的向量matlab.net.QueryParameter对象或包含带有可选前导的编码查询的字符串?的性格。

指向辅助资源的方向,指定为字符串或字符向量。这个字符串方法%对URI的片段部分中不允许的字符进行编码片段,不编码值。

例子:在URI中//www.tatmou.com/help/matlab/ref/weboptions.html#examples这个片段属性是例子

URI是否绝对,指定为真正的错误的.绝对URI具有非空计划如果URI不是绝对的,那么它是相对的绝对uri看见RFC 3986统一资源标识符(URI):通用语法-第4.3节绝对URI

这个路径绝对URI中的属性始终被视为绝对路径,并且编码路径属性始终包含前导符/的性格。要发送消息,URI必须是绝对的,并且必须包含一个非空值宿主财产。

数据类型:必然的

URI的编码授权部分,指定为字符串或字符向量,仅当属性为非空时才显示相关标点EncodedAuthority用户信息@宿主:港口城市.设置EncodedAuthority是设置用户信息,宿主,港口城市属性,但必须对特殊字符进行编码。

例子:在URI中https://user:pwd@www.tatmou.com:8000/product/matlab?abc=def&this=that#xyz这个EncodedAuthority属性是用户:pwd@www.tatmou.com:8000

已编码的路径,指定为字符串或字符向量。读取此属性以获取路径属性作为编码字符串,因为它将出现在编码URI中。如果已经将路径编码为字符串,则将编码路径属性,而不是路径属性以防止进一步编码。当阅读编码路径,它有一个领先的/如果路径不是[]而且之前的URI中有非空组件路径

设置编码路径指向空数组('',[]string.empty)等价于setting路径这个值。

如果没有路径属性,然后编码路径返回一个空字符串,"".然而,编码路径决不是空数组。

例子:在URI中//www.tatmou.com/金宝搏官方网站solutions/robotics这个编码路径属性是/金宝搏官方网站解决方案/机器人

编码查询,指定为字符串或字符向量。编码查询返回与调用字符串关于查询财产。设置编码查询相当于设置查询财产。

例子:在URI中//www.tatmou.com/金宝appsupport/search_results.html?q=+weboptions+产品:“MATLAB+编译器”这个编码查询属性是q=+weboptions+产品:%22MATLAB+编译器%22

整个已编码的URI,指定为字符串或字符向量。编码杜里的返回相同的值matlab.net.URI.string方法背景编码杜里相当于调用URI构造函数的“文字”论点。

方法

全部展开

例子

全部崩溃

创建一个URI。

U=matlab.net.URI('//www.tatmou.com');U.Query = matlab.net.QueryParameter (“q”,“weboptions”);美国路=“搜索/ site_search.html”

显示包含的搜索结果weboptions

网络(字符(U))
U=matlab.net.URI(“//www.tatmou.com/下载188bet金金宝app宝搏products/simulink/”);U.EncodedURI
Ans = string "//www.tatmou.com/下载188bet金金宝app宝搏products/simulink/"
R2016b中引入