ObjectHttpCollection

HttpCollection은 처리를 위한 일반 컨테이너입니다.http메시지의 헤더, 쿼리, 양식, 쿠키 데이터

HttpCollection의 사용을 설명하기 위해 헤더를 예로 들겠습니다.

HttpCollection은 세 가지 형태의 데이터 추가를 지원합니다.

1. 키-값 데이터를 추가합니다. 데이터를 추가해도 기존 키-값 데이터는 수정되지 않습니다.add

1
2
3
4
headers.add({
    'Content-Type': 'text/plain',
    'User-Agent': 'fibjs'
});

1. 키 값을 사용하여 데이터 세트를 추가합니다. 데이터를 추가해도 기존 키 값의 데이터는 수정되지 않습니다.add

1
2
3
4
headers.add('Set-Cookie', [
    'a=10',
    'b=20'
]);

1. 키-값 데이터를 추가합니다. 데이터를 추가해도 기존 키-값 데이터는 수정되지 않습니다.add

1
headers.add('Accept-Encoding', 'gzip');

HttpCollection 데이터를 설정하는 형태는 추가와 동일하며, 사용하는 방법은 입니다 set.

has지정된 키 값을 가진 데이터가 컨테이너에 존재하는지 확인하는 데 사용할 수 있습니다.

1
const contentTypeExists = headers.has('Content-Type');

first컨테이너의 키에 해당하는 첫 번째 값을 가져오는 데 사용합니다 .

1
const contentType = headers.first('Content-Type');

all지정된 키 값의 모든 값을 쿼리하고 배열을 반환하는 데 사용합니다 . 빈 문자열 인수가 전달되면 전체 값이 반환됩니다.

1
2
const cookieArray = headers.all('Set-Cookie');
const alls = headers.all();

지정된 키 값의 모든 데이터를 삭제하고 표현을 delete반환하는 메서드를 사용합니다 .true

상속관계

운영자

operator[String]

키-값 첨자를 사용하여 값에 직접 액세스할 수 있습니다.

1
Variant HttpCollection[String];

멤버 함수

clear

컨테이너 데이터 지우기

1
HttpCollection.clear();

---

has

컨테이너에 지정된 키 값을 가진 데이터가 존재하는지 확인

1
Boolean HttpCollection.has(String name);

호출 매개변수:

• name: 문자열, 확인할 키 값을 지정합니다.

결과 반환:

• Boolean, 키 값이 존재하는지 여부를 반환합니다.

---

first

지정된 키 값의 첫 번째 값을 쿼리합니다.

1
Variant HttpCollection.first(String name);

호출 매개변수:

• name: 문자열, 쿼리할 키 값을 지정합니다.

결과 반환:

• Variant, 키 값에 해당하는 값을 반환하고, 존재하지 않으면 정의되지 않음을 반환합니다.

---

get

지정된 키 값의 첫 번째 값을 쿼리합니다. 이는 first와 동일합니다.

1
Variant HttpCollection.get(String name);

호출 매개변수:

• name: 문자열, 쿼리할 키 값을 지정합니다.

결과 반환:

• Variant, 키 값에 해당하는 값을 반환하고, 존재하지 않으면 정의되지 않음을 반환합니다.

---

all

지정된 키 값의 모든 값을 쿼리합니다.

1
NObject HttpCollection.all(String name = "");

호출 매개변수:

• name: 문자열, 쿼리할 키 값을 지정하고, 빈 문자열을 전달하여 모든 키 값의 결과를 반환합니다.

결과 반환:

• NObject, 키 값에 해당하는 모든 값의 배열을 반환하며, 데이터가 존재하지 않으면 null을 반환합니다.

---

add

키-값 데이터를 추가합니다. 데이터를 추가해도 기존 키-값 데이터는 수정되지 않습니다.

1
HttpCollection.add(Object map);

호출 매개변수:

• map: 객체, 추가할 키-값 데이터 사전을 지정합니다.

---

키 값에 대한 데이터 집합을 추가합니다. 데이터를 추가해도 기존 키 값의 데이터는 수정되지 않습니다.

1
2
HttpCollection.add(String name,
    Array values);

호출 매개변수:

• name: 문자열, 추가할 키 값을 지정합니다.
• values: 배열, 추가할 데이터 세트를 지정합니다.

---

키-값 데이터를 추가합니다. 데이터를 추가해도 기존 키-값 데이터는 수정되지 않습니다.

1
2
HttpCollection.add(String name,
    Variant value);

호출 매개변수:

• name: 문자열, 추가할 키 값을 지정합니다.
• value: Variant, 추가할 데이터를 지정합니다.

---

set

키 값 데이터를 설정합니다. 데이터를 설정하면 해당 키 값에 해당하는 첫 번째 값이 수정되고 동일한 키 값으로 나머지 데이터가 지워집니다.

1
HttpCollection.set(Object map);

호출 매개변수:

• map: 객체, 설정할 키-값 데이터 사전을 지정합니다.

---

키 값에 대한 데이터 세트를 설정합니다. 데이터를 설정하면 키 값에 해당하는 값이 수정되고 동일한 키 값으로 나머지 데이터가 지워집니다.

1
2
HttpCollection.set(String name,
    Array values);

호출 매개변수:

• name: 문자열, 설정할 키 값을 지정합니다.
• values: 배열, 설정할 데이터 세트를 지정합니다.

---

키 값 데이터를 설정합니다. 데이터를 설정하면 해당 키 값에 해당하는 첫 번째 값이 수정되고 동일한 키 값으로 나머지 데이터가 지워집니다.

1
2
HttpCollection.set(String name,
    Variant value);

호출 매개변수:

• name: 문자열, 설정할 키 값을 지정합니다.
• value: 변형, 설정할 데이터를 지정합니다.

---

remove

지정된 키의 모든 값 삭제

1
HttpCollection.remove(String name);

호출 매개변수:

• name: 문자열, 삭제할 키 값을 지정합니다.

---

delete

지정된 키의 모든 값 삭제

1
HttpCollection.delete(String name);

호출 매개변수:

• name: 문자열, 삭제할 키 값을 지정합니다.

---

sort

키 값을 기준으로 컨테이너 내용 정렬

1
HttpCollection.sort();

---

keys

컨테이너의 키 값 쿼리

1
NArray HttpCollection.keys();

결과 반환:

• NArray, 모든 키 값을 포함하는 배열을 반환합니다.

---

values

컨테이너의 값 쿼리

1
NArray HttpCollection.values();

결과 반환:

• NArray, 모든 값을 포함하는 배열을 반환합니다.

---

toString

객체의 문자열 표현을 반환하며 일반적으로 "[Native Object]"를 반환하며 객체 자체의 특성에 따라 다시 구현될 수 있습니다.

1
String HttpCollection.toString();

결과 반환:

• String, 객체의 문자열 표현을 반환합니다.

---

toJSON

객체의 JSON 형식 표현을 반환하며 일반적으로 객체에 의해 정의된 읽을 수 있는 속성 컬렉션을 반환합니다.

1
Value HttpCollection.toJSON(String key = "");

호출 매개변수:

• key: 문자열, 사용되지 않음

결과 반환:

• Value, 직렬화 가능한 JSON을 포함하는 값을 반환합니다.