matlab.net.QueryParameter 클래스

네임스페이스: matlab.net

URI(Uniform Resource Identifier)에 대한 쿼리 부분에 포함된 파라미터

설명

다음 형식의 URI 쿼리 문자열을 생성하려면 QueryParameter 클래스를 사용하십시오.

name1=value1&name2=value2&name3=value3

여기서 각 name=value 세그먼트는 string 메서드를 사용하여 문자열로 변환되는 QueryParameter 객체입니다. QueryParameter 객체의 벡터에 대한 string 메서드는 & 문자를 사용하여 결과를 결합합니다. string 메서드는 값을 문자열로 변환하고 결과에 포함된 특수 문자에 필요한 모든 인코딩을 수행합니다.

클래스 특성

Sealed

true

클래스 특성에 대한 자세한 내용은 클래스 특성 항목을 참조하십시오.

생성

설명

obj = matlab.net.QueryParameter는 빈 쿼리 파라미터를 생성합니다.

obj = matlab.net.QueryParameter(paramName,paramValue)는 paramName,paramValue 쌍 인수로 구성된 쿼리 파라미터 벡터를 생성합니다. paramName1,paramValue1,...,paramNameN,paramValueN과 같이 여러 개의 인수 쌍을 어떤 순서로든 지정할 수 있습니다.

obj = matlab.net.QueryParameter(qStruct)는 구조체에서 쿼리 파라미터 벡터를 생성합니다.

obj = matlab.net.QueryParameter(queryStr)은 queryStr을 쿼리로 구문 분석합니다.

obj = matlab.net.QueryParameter(___,Format)은 비 스칼라 값에 사용되는 형식을 지정하며, 위에 열거된 구문의 입력 인수를 포함할 수 있습니다.

입력 인수

paramName — 파라미터 이름

string형 | 문자형 벡터

파라미터 이름으로, string형이나 문자형 벡터로 지정됩니다.

paramValue — 파라미터 값

paramName에 필요한 유형

파라미터 값으로, paramName에 필요한 유형으로 지정됩니다.

qStruct — 파라미터 이름과 파라미터 값

구조체

파라미터 이름과 값으로, 구조체로 지정됩니다. qStruct의 필드는 파라미터 이름과 값을 정의합니다.

데이터형: struct

queryStr — 파라미터 이름과 파라미터 값

string형 | 문자형 벡터

파라미터 이름과 값으로, string형이나 문자형 벡터로 지정됩니다. queryStr은 URI에 그대로 나타나게 되는 완전하고 인코딩된 쿼리입니다. 선행 문자 ?는 선택적으로 포함할 수 있습니다.

queryStr은 & 문자 위치에서 개별 name=value 쿼리 파라미터로 분할됩니다. Name 속성은 name으로 설정되고 Value 속성은 value로 설정됩니다.

%와 두 자리 16진수로 구성된 문자 모음 3개는 퍼센트로 인코딩된 하나의 바이트를 나타냅니다. 이러한 바이트의 시퀀스는 UTF-8로 인코딩된 문자로 처리되는데, 이러한 문자는 디코딩되어 QueryParameters의 Name 속성과 Value 속성을 구성합니다. queryStr에 포함된 모든 플러스 기호 '+'는 공백 '%20'으로 처리됩니다. QueryParameter가 string형으로 다시 변환되면 인코딩이 필요한 문자에 대해서만 퍼센트 인코딩이 수행됩니다. 이 작업은 해당 문자가 원래 queryStr으로 인코딩되었는지 여부에 관계없이 이루어지므로, string 메서드의 결과는 queryStr과 정확하게 일치하지 않을 수 있습니다. 그러나 URI에서 사용될 때는 그 의미가 동일합니다.

예를 들어, 유로화 기호 €에 대한 UTF-8 인코딩은 E2 82 AC입니다.

q1 = matlab.net.QueryParameter('V=%e2%82%ac')

q1 = 

  QueryParameter with properties:

      Name: "V"
     Value: "€"
    Format: csv

+ 문자와 %20 문자는 공백으로 처리됩니다.

q2 = matlab.net.QueryParameter('V=a+b%20c')

q2 = 

  QueryParameter with properties:

      Name: "V"
     Value: "a b c"
    Format: csv

string 메서드는 인코딩이 필요한 문자에 대해 퍼센트 인코딩을 구현합니다. 예를 들어, €에 대해서는 인코딩이 구현됩니다.

string(q1)

ans = V=%E2%82%AC

그러나, queryStr 인수 'V=a+b%20c'에 포함된 문자는 인코딩이 필요하지 않습니다.

q3 = string(q2)

q3 = V=a+b+c

string 메서드의 결과가 queryStr과 일치하지 않더라도 URI에 사용되는 값은 동일합니다.

속성

Name — 파라미터 이름

string형 | 문자형 벡터

파라미터 이름으로, string형이나 문자형 벡터로 지정됩니다.

Value — 파라미터 값

실수 | 논리형 | datetime형 | string형 | 문자형 벡터

파라미터 값으로, 실수, 논리형, datetime형(NaT가 아닌 값), string형, 문자형 벡터, 또는 이러한 값으로 구성된 벡터나 셀형 벡터로 지정됩니다. Value가 다른 유형인 경우 Value는 값을 문자형 벡터로 변환하는 string 메서드나 char 메서드를 지원해야 합니다. 비어 있는 경우, Value는 빈 문자열로 처리됩니다.

Format — 인코딩 형식

matlab.net.ArrayFormat.csv (디폴트 값) | matlab.net.ArrayFormat 열거형

인코딩 형식으로, 벡터인 경우 Value를 인코딩하는 데 사용할 matlab.net.ArrayFormat 열거형으로 지정됩니다.

메서드

퍼블릭 메서드

char	쿼리 파라미터를 문자형 벡터로 인코딩
string	인코딩된 쿼리 파라미터를 string형으로 반환

예제

구조체를 이용하여 HTTP 쿼리 파라미터 만들기

구조체 필드 이름 this를 생성하고 이 필드 값을 that으로 설정합니다.

qStruct.this = 'that';
QP = matlab.net.QueryParameter(qStruct)

QP = 
  QueryParameter with properties:

      Name: "this"
     Value: 'that'
    Format: csv

문자형 벡터를 이용하여 HTTP 쿼리 파라미터 생성하기

두 개의 쿼리 this=that과 one=2를 포함하는 문자형 벡터를 생성합니다. QueryParameter 메서드는 & 문자를 기준으로 qStr을 두 개의 QueryParameter 객체로 분할합니다.

qStr = '?this=that&one=2';
QPs = matlab.net.QueryParameter(qStr);

qStr에 있는 name=value 쌍은 Name 속성과 Value 속성을 정의합니다.

name1 = QPs(1).Name

name1 = 
"this"

value1 = QPs(1).Value

value1 = 
"that"

name2 = QPs(2).Name

name2 = 
"one"

value2 = QPs(2).Value

value2 = 
"2"

버전 내역

R2016b에 개발됨

참고 항목

matlab.net.ArrayFormat | matlab.net.URI