[Remoting] RecordSet 객체

[채재영]

출처 : macromedia.com/kr
-----------------------


RecordSet (객체)

RecordSet 객체는 Flash Remoting에만 사용할 수 있습니다.

RecordSet 객체를 사용하면 Flash Remoting에서 반환한 RecordSet 객체를 조작하거나 클라이언트측 RecordSet 객체를 생성할 수 있습니다. 레코드세트는 여러 가지 방법으로 레코드 목록을 페치(fetch)하고, 액세스하고 조작하기 위한 함수가 있는 레코드 목록입니다.

응용프로그램 서버에 생성된 레코드세트는 일반적으로 데이터베이스 질의 결과로 구성됩니다. RecordSet 객체의 각 레코드는 유형이 지정되지 않은 ActionScript 객체로 나타납니다. RecordSet 객체에서 개별 레코드는 색인 번호로 식별됩니다. 색인은 0에서 시작합니다. 레코드세트를 정렬하거나 RecordSet에 레코드를 추가하거나 RecordSet에서 레코드를 삭제하면 색인이 변경됩니다.

레코드의 각 필드는 객체의 필드로 나타납니다. 응용프로그램 서버에서 만들어진 RecordSet 객체의 필드 이름은 서버측 RecordSet에 정의된 필드의 이름과 같습니다. 로컬 RecordSet 객체의 필드 이름은 new RecordSet() 함수 호출에서 정의한 필드 이름입니다.

RecordSet 객체를 사용하려면 다음과 같이 include 명령을 사용하여 Flash 동영상의 첫 번째 프레임에 있는 NetServices ActionScript 클래스 파일을 가져와야 합니다. 이 클래스 파일에는 RecordSet ActionScript 클래스도 포함되어 있습니다.

#include "NetServices.as"



RecordSet 객체의 메소드 요약
-------------------------

메소드 : 설명

new RecordSet : 새 로컬 RecordSet 객체를 생성합니다.

RecordSet.addItem : RecordSet 객체에 레코드를 삽입합니다.

RecordSet.addItemAt : RecordSet 객체의 지정한 색인에 레코드를 삽입합니다.

RecordSet.addView : RecordSet 객체가 변경되면 통지를 받을 객체를 정의합니다.

RecordSet.filter : 원래 RecordSet 객체에서 선택한 레코드가 포함된 새 RecordSet 객체를 생성합니다.

RecordSet.getColumnNames : RecordSet 객체의 모든 열 이름을 반환합니다.

RecordSet.getItemAt : 색인이 유효하고 레코드를 즉시 사용할 수 있으면 레코드를 반환합니다.

RecordSet.getItemID : 레코드 ID를 반환합니다.

RecordSet.getLength : RecordSet 객체의 레코드 개수를 반환합니다.

RecordSet.getNumberAvailable : 서버에서 다운로드한 레코드 개수를 반환합니다.

RecordSet.removeAll : RecordSet 객체에서 모든 레코드를 제거합니다.

RecordSet.removeItemAt : RecordSet 객체에서 지정한 레코드를 제거합니다.

RecordSet.replaceItemAt : 지정한 색인의 레코드를 바꿉니다.

RecordSet.setDeliveryMode : 응용프로그램 서버와 연결된 RecordSet의 배달 모드를 변경합니다.

RecordSet.setField : 레코드에 있는 한 필드의 값을 새 값으로 바꿉니다.

RecordSet.sort : 사용자가 지정한 비교 함수를 사용하여 모든 레코드를 정렬합니다.

RecordSet.sortItemsBy : 새 복사본을 만들지 않고 RecordSet 객체의 모든 레코드를 정렬합니다.





RecordSet 객체의 특성 요약
-----------------------

특성(읽기 전용) : 설명

RecordSet.isFullyPopulated : RecordSet 객체가 완전히 채워졌는지 여부를 결정합니다.

RecordSet.isLocal : RecordSet 객체가 로컬에 있는지 아니면 응용프로그램 서버에 연결되어 있는지 여부를 결정합니다.



--------------------------------------------------------------------------------

new RecordSet


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

new RecordSet (colunmNames)


[매개변수 ]

columnNames 각 문자열이 RecordSet 열 중 한 열의 이름인 문자열 배열입니다.



[반환 값]

새 로컬 RecordSet 객체를 반환합니다.


[설명]

방법: 새 로컬 RecordSet을 생성합니다. 처음에는 RecordSet이 비어 있습니다. 로컬 RecordSet 객체는 응용프로그램 서버에서 데이터를 다운로드하지 않으므로 데이터 배달과 관련된 RecordSet 함수는 로컬 RecordSet 객체에 사용할 수 없습니다.


[예]

다음 예는 새 로컬 RecordSet 객체를 생성합니다.

#include "NetServices.as"
var productList = new RecordSet(["ProductName", "Price", "Color"]);


--------------------------------------------------------------------------------

RecordSet.getColumnNames


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSetObject.getColumnNames()


[반환 값]

문자열 배열을 반환합니다. 이 배열은 RecordSet 생성자에 전달한 것과 같은 배열이거나 응용프로그램 서버와 연결된 RecordSet에 대한 배열과 같습니다.


[설명]


방법: RecordSet 객체의 모든 열 이름을 문자열 배열로 반환합니다.


[예]

다음 예는 getColumnNames 함수를 보여 줍니다.

#include "NetServices.as"
var productList = new RecordSet(["ProductName", "Price", "Color"]);
var titles = productList.getColumnNames(productList);
_root.firstColumnTitle.text = titles[0];
_root.secondColumnTitle.text = titles[1];

--------------------------------------------------------------------------------


RecordSet.addView


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.addView(object)


[매개변수]

object RecordSet 객체가 변경되면 통지를 받을 ActionScript 객체입니다.


[반환 값]

없음


[설명]

방법: RecordSet 객체가 변경되면 통지를 받을 ActionScript 객체를 정의합니다. 이 객체에는 매개변수 한 개와 이벤트 설명자 객체 한 개를 사용하는 modelChanged 함수가 포함되어 있어야 합니다. 다음 테이블에서는 이벤트 설명자 메시지와 메시지에 대한 설명이 나옵니다.

메시지 : 설명

{event:"sort"} : RecordSet이 정렬되었습니다.

{event:"updateAll"} : RecordSet이 변경되었습니다(예: 새 뷰 추가).

{event:"addRows", firstRow:xxx, lastRow:yyy} : xxx부터 yyy까지의 행이 추가되었습니다.

{event:"updateRows", firstRow:xxx, lastRow:yyy} : xxx부터 yyy까지의 행이 변경되었습니다.

{event:"allRows"} : 서버에서 모든 레코드가 도착했습니다. 즉, recordSet이 완전히 채워졌습니다.

{event:"fetchrows", firstRow:xxx, lastRow:yyy} : 서버에서 xxx부터 yyy까지의 행을 요청했지만 아직 도착하지 않았습니다.

{event:"updateRows", firstRow:xxx, lastRow:yyy} : xxx부터 yyy까지의 행이 변경되었습니다.




[예]


#include "NetServices.as"

function modelChanged(info)
{
trace(info.event);
}

var productList = new RecordSet(["Name","Price","Color"]);

// productList가 변경될 때마다 modelChanged()를 호출합니다.
productList.addView(this);

// RecordSet 객체를 수정하고, "modelChanged"가 호출되었는지 확인합니다.
productList.addItem({Name:"우유", Price:3.50, Color:"0xffffff"});
productList.addItem({Name:"달걀", Price:1.75, Color:"0xffffff"});


--------------------------------------------------------------------------------

RecordSet.getLength

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSetObject.getLength()


[설명]

방법: RecordSet 객체의 레코드 개수를 반환합니다.



[반환 값]

RecordSet 객체의 레코드 개수를 반환합니다.


[예]

다음 예는 getLength 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
productList.addItem({ProductName :"수저",Price :77,Color :0x987654});
productList.addItem({ProductName :"니블릭",Price :33,Color :660000});
trace("백화점에 " + productList.getLength() + " 제품이 있습니다.");


--------------------------------------------------------------------------------

RecordSet.getItemAt


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.getItemAt(index)


[매개변수]

index 검색할 레코드 번호입니다.


[반환 값]

레코드를 반환합니다.


[설명]

방법: 색인이 유효하고 레코드를 즉시 사용할 수 있으면 레코드를 반환합니다. 요청한 레코드 색인 번호가 0보다 작거나 가장 큰 레코드 번호보다 크면 null을 반환합니다. 색인 번호는 유효하지만 요청한 레코드가 아직 다운로드되지 않았으면 "진행 중"이라는 문자열을 반환합니다. RecordSet 색인을 정렬하거나 레코드를 삭제 또는 제거하면 RecordSet 색인이 변경됩니다.

에러 처리

에러 조건
발생하는 작업
에러 메시지

범위를 벗어난 색인
Null이 반환되고, Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다.
GETITEMAT: RecordSet 색인이 범위를 벗어났습니다.





[예]


다음 예는 getItemAt 함수를 보여 줍니다.

#include "NetServices.as"
var productList = new RecordSet(["ProductName","Price","Color"]);
productList.addItem({ProductName :"수저",Price :77,Color :"0x987654"});
var record = productList.getItemAt(0);


--------------------------------------------------------------------------------

RecordSet.getItemID

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.getItemID(index)


[매개변수]

index 레코드의 색인 번호입니다.


[반환 값]

지정한 색인의 레코드에 해당하는 고유 ID로 색인이 범위를 벗어나면 null을 반환합니다.



[설명]


방법: 지정한 색인의 레코드에 해당하는 고유 ID를 반환합니다. RecordSet 객체는 각 레코드에 고유한 ID를 할당합니다. ID는 RecordSet 객체 내에 있는 레코드와 연결된 별도의 항목이며 레코드의 일부가 아닙니다. 레코드 색인과 달리 레코드 ID는 RecordSet을 정렬하거나 레코드를 추가 또는 삭제하더라도 변경되지 않습니다. 레코드를 삭제하면 레코드 ID가 폐기되어 해당 RecordSet에는 다시 사용되지 않습니다. 또한 ID는 RecordSet이 변경될 때 최종 사용자가 선택한 항목을 유지하기 위해 ListBox 객체가 사용합니다.



[예]


다음 예는 RecordSet에서 레코드 ID를 검색합니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
productList.addItem({ProductName :"수저",Price :77,Color :"0x987654"});
var recordID =productList.getItemID(0);


--------------------------------------------------------------------------------

RecordSet.addItemAt


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.addItemAt(index, record)


[매개변수]

index 레코드의 색인 번호입니다.

record 추가할 레코드입니다.


[반환 값]

없음



[설명]


방법: RecordSet 객체의 지정한 색인에 레코드를 삽입합니다. addItemAt 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

색인이 0보다 작습니다. : RecordSet 객체가 변경되지 않습니다.


색인이 RecordSet 객체의 길이보다 큽니다. : RecordSet 객체의 길이가 늘어나고 RecordSet 객체에 레코드가 추가됩니다.


레코드 매개변수가 객체가 아닙니다. : RecordSet 객체에 레코드가 추가됩니다.


레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다. : RecordSet 객체에 레코드가 추가됩니다.


RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.


에러 처리


[예]


다음 예는 addItemAt 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"마술 풍선", Price:1, Color:"0x987654"};
productList.addItemAt(0,itemToAdd);


--------------------------------------------------------------------------------

RecordSet.addItem

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.addItem(record)


[매개변수]

record 추가할 레코드입니다.


[반환 값]

없음


[설명]


방법: RecordSet에 레코드를 삽입합니다. addItem 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

레코드 매개변수가 객체가 아닙니다. : RecordSet 객체에 레코드가 추가됩니다.


레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다. : RecordSet 객체에 레코드가 추가됩니다.


RecordSet 객체가 서버와 연결되어 있는데 완전히 채워지지 않았습니다. : RecordSet에 레코드가 추가되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.


에러 처리


[예]


다음 예는 addItem 함수를 보여 줍니다.

#include "NetServices.as"
var productList = new RecordSet(["ProductName", "Price", "Color"]);
var itemToAdd = {ProductName:"마술 풍선"; Price:1, Color:0x987654);
productList.addItem(itemToAdd);


--------------------------------------------------------------------------------

RecordSet.replaceItemAt


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.addItem(index, record)


[매개변수]

index 레코드의 색인 번호입니다.

record 추가할 레코드입니다.


[반환 값]

없음


[설명]

방법: RecordSet 객체의 지정한 색인에 있는 레코드를 바꿉니다. 지정한 색인은 기존 레코드를 식별해야 합니다. 레코드의 내용이 레코드 매개변수의 내용으로 바뀝니다. 레코드 ID는 변경되지 않습니다. replaceItemAt 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

범위를 벗어난 색인 : RecordSet 객체가 변경되지 않습니다.


RecordSet 객체가 서버와 연결되어 있는데 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.

레코드 매개변수가 객체가 아닙니다. : RecordSet 객체에 레코드가 추가됩니다.


레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다. : RecordSet 객체에 레코드가 추가됩니다.



에러 처리


[예]

다음 예는 replaceItemAt 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"마술 풍선",Price:1,Color:"0xb00fed"};
productList.addItem(itemToAdd);
myListBox.setDataProvider(productList);
var replacementItem ={ProductName:"샴푸", Price:2, Color:"0xd00d1e"};
productList.replaceItemAt(0,replacementItem);



--------------------------------------------------------------------------------

RecordSet.setField


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.setField(index, fieldName, value)


[매개변수]

index 레코드의 색인 번호입니다.

fieldName 바꿀 필드의 이름입니다.

value 필드에 삽입할 값입니다.



[반환 값]

없음


[설명]

방법: 레코드에 있는 한 필드의 값을 새 값으로 바꿉니다. setField 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

RecordSet 객체가 서버와 연결되어 있는데 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.

범위를 벗어난 색인 : RecordSet 객체가 변경되지 않습니다.


알 수 없는 필드 이름 : RecordSet 객체가 변경되지 않습니다.



에러 처리


[예]

다음 예는 setField 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd ={ProductName:"마술 풍선",Price:1,Color:"0x987654"};
productList.addItem(itemToAdd);
var replacementValue ="flashmx";
productList.setField(0,"ProductName",replacementValue);


--------------------------------------------------------------------------------

RecordSet.removeItemAt


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.removeItemAt(index)


[매개변수]

index 레코드의 색인 번호입니다.


[반환 값]

없음


[설명]

방법: 지정한 레코드를 제거합니다. 연결된 레코드 ID는 해당 RecordSet 객체에서 다시 사용되지 않습니다. removeItemAt 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

RecordSet 객체가 서버와 연결되어 있는데 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.

범위를 벗어난 색인 : RecordSet 객체가 변경되지 않습니다.



에러 처리


[예]

다음 예는 removeItemAt 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"마술 풍선",Price:1,Color:"0x987654"};
productList.addItem(itemToAdd);
productList.removeItemAt(0);


--------------------------------------------------------------------------------

RecordSet.removeAll

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.removeAll()


[반환 값]

없음


[설명]


방법: RecordSet에서 모든 레코드를 제거합니다. removeAll 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

RecordSet 객체가 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.


에러 처리


[예]


다음 예는 removeAll 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd ={ProductName:"마술 풍선",Price:1,Color:"0x987654"};
productList.addItem(itemToAdd);
productList.removeAll();

--------------------------------------------------------------------------------

RecordSet.sortItemsBy


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.sortItemsBy(fieldName, direction)


[매개변수]

fieldName 정렬 키에 해당하는 레코드 필드의 이름입니다.

direction (선택 사항) 정렬 방향을 지정합니다. "d"나 "D"로 시작하는 문자열은 내림차순 정렬을 지정합니다. 이 외 다른 값은 오름차순 정렬로 간주됩니다.


[반환 값]

정렬이 제대로 수행되면 true를 반환하고 에러가 발생하면 false를 반환합니다.


[설명]

방법: 새 복사본을 만들지 않고 RecordSet 객체의 모든 레코드를 정렬합니다. 각 레코드에 대한 정렬 키 값은 필드 ID로 식별되는 필드의 내용입니다. 원래 순서는 저장되지 않습니다.

큰 RecordSet 객체를 정렬할 때는 시간이 많이 걸릴 수 있습니다. Pentium 3 프로세서가 장착된 컴퓨터에서는 레코드가 2000개 미만인 RecordSet 객체를 정렬하는 데 1초도 걸리지 않습니다. 레코드 개수가 늘어나면 정렬 시간도 늘어납니다.

두 개 이상의 레코드의 정렬 키 값이 같더라도 특수하게 정렬되지 않습니다. 원래 레코드 순서는 유지되지 않습니다.

fieldName 매개변수가 하나 이상의 레코드에 없는 필드를 나타낼 때는 해당 필드의 키 값으로 null이 사용됩니다. Null 값은 다른 값보다 낮은 값으로 정렬됩니다.

sortItemsBy 함수는 완전히 채워진 RecordSet 객체에만 사용할 수 있습니다.

등록된 모든 뷰는 다음 콜백을 받습니다.

View.modelChanged("sort", 1, lastRecordNumber);
setField 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.



에러 조건 : 발생하는 작업 : 에러 메시지

RecordSet 객체가 서버와 연결되어 있는데 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.


에러 처리


[예]

다음 예는 sortItemsBy 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"마술 풍선",Price:1,Color:"0x987654"};
var itemToAdd2 = {ProductName:"샴푸",Price:7,Color:"0x876543"};
var itemToAdd3 = {ProductName:"접시",Price:2,Color:"0x098763"};
productList.addItem(itemToAdd);
productList.addItem(itemToAdd2);
productList.addItem(itemToAdd3);
productList.sortItemsBy("ProductName");
productList.sortItemsBy("Price","DESC");


--------------------------------------------------------------------------------

RecordSet.isLocal


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.isLocal()


[반환 값]

RecordSet 객체가 로컬에 있으면 true를 반환하고 응용프로그램 서버와 연결되어 있으면 false를 반환합니다.


[설명]

읽기 전용 특성: RecordSet 객체가 로컬에 있는지 아니면 응용프로그램 서버에 연결되어 있는지 여부를 결정합니다.


[예]


다음 예는 isLocal 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
if (productList.isLocal())
{
_root.tellUser.text ="이 RecordSet 객체는 서버와 연결되지 않습니다.";
}


--------------------------------------------------------------------------------

RecordSet.isFullyPopulated

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.isFullyPopulated()


[반환 값]

RecordSet 객체가 완전히 채워졌으면 true를 반환하고 완전히 채워지지 않았으면 false를 반환합니다.


[설명]

읽기 전용 특성: RecordSet이 완전히 채워졌는지 여부를 결정합니다. 다음 데이터 편집 및 조작 함수를 사용하려면 RecordSet 객체가 완전히 채워져 있어야 합니다.

addItemAt

addItem

replaceItemAt

setField

removeItem

removeAll

filter

sort


로컬 RecordSet 객체는 항상 완전히 채워져 있습니다. 응용프로그램 서버와 연결된 RecordSet 객체는 객체의 모든 레코드가 응용프로그램 서버에서 다운로드되면 완전히 채워집니다.



[예]

다음 예는 로컬 RecordSet을 사용하는 isFullyPopulated 함수를 보여 줍니다.

#include "NetServices.as"
var productList =new RecordSet(["ProductName","Price","Color"]);
var itemToAdd = {ProductName:"마술 풍선",Price:1,Color:"0x987654"};
var itemToAdd2 = {ProductName:"샴푸",Price:7,Color:"0x876543"};
productList.addItem(itemToAdd);
productList.addItem(itemToAdd2);
if (productList.isFullyPopulated())
{
editButton.enable();
}


--------------------------------------------------------------------------------

RecordSet.getNumberAvailable

[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.getNumberAvailable()


[반환 값]

0과 RecordSet 전체 크기 사이의 정수 값을 반환합니다.


[설명]

방법: 서버에서 다운로드한 레코드 개수를 반환합니다. 요청했지만 아직 도착하지 않은 레코드는 이 개수에 포함되지 않습니다. 로컬 RecordSet 객체에 대해서는 항상 getLength() 함수가 반환하는 값과 같은 값을 반환합니다.


[예]


다음 예는 로컬 RecordSet을 사용하는 getNumberAvailable 함수를 보여 줍니다.

#include "NetServices.as"
// 함수
function reportDownloadStatus(aRecordSet)
{
trace(aRecordSet.getLength()+ "의" + aRecordSet.getNumberAvailable() + "레코드가 다운로드되었습니다.");
}


--------------------------------------------------------------------------------

RecordSet.setDeliveryMode


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.setDeliveryMode = function(mode, pagesize, numPrefetchPages)


[매개변수]

mode 배달 모드를 식별합니다. 사용할 수 있는 옵션은 ondemand(기본 값), fetchall 및 page입니다.

pagesize (선택 사항) fetchall 모드에서 페이지 크기에 해당하는 항목이 page 모드에서는 각 서버 요청에서 페치(fetch)할 레코드 개수입니다.

numPrefetchPages (선택 사항) page 모드에서 사전에 페치(fetch)할 페이지 개수입니다.


[반환 값]

없음


[설명]

방법: 응용프로그램 서버와 연결된 RecordSet의 배달 모드를 변경합니다. 응용프로그램 서버와 연결된 RecordSet은 특정 데이터 배달 모드에서 언제든지 작동합니다. 지연 중인 응용프로그램 서버 요청이 완료되도록 할 때를 제외하고 새 모드 설정은 즉시 적용됩니다. 모드 설정은 변경할 수 있습니다.

RecordSet 객체에 대해 이 함수를 호출하기 전에는 ondemand 모드에서 작동합니다. ondemand 모드를 사용할 때는 다른 매개변수가 필요하지 않습니다. fetchall 모드를 사용할 때는 pagesize 매개변수를 제공해야 합니다. 전체 RecordSet이 일련의 요청으로 응용프로그램 서버에서 페치(fetch)됩니다. 각 요청은pagesize 매개변수에 지정된 레코드 개수만 페치(fetch)합니다.

page 모드를 사용할 때는 pagesize와 preFetchPages 매개변수를 제공해야 합니다. page 모드에서 getItemAt 함수를 사용하여 레코드를 요청하면 RecordSet 객체는 요청된 레코드가 포함된 페이지 뒤의 preFetchPages 페이지를 클라이언트에서 사용할 수 있는지 또는 서버에서 요청되었는지 확인합니다. numPrefetch 페이지가 0이면 현재 페이지만 페치(fetch)됩니다.

RecordSet이 완전히 채워진 경우에는 setDeliveryMode 함수가 적용되지 않습니다.

에러 처리

에러 조건 : 발생하는 작업 : 에러 메시지

알 수 없는 모드 문자열 : RecordSet 객체가 변경되지 않고 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : SETDELIVERYMODE: 알 수 없는 모드 문자열



[예]

다음 예는 setDeliveryMode 함수를 보여 줍니다.

myRecordSet.setDeliveryMode("fetchall");
myRecordSet.setDeliveryMode("prefetch", 25, 2);


--------------------------------------------------------------------------------

RecordSet.filter


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.filter(filterFunction, context)


[매개변수]

filterFunction 두 개의 매개변수를 사용하고 true나 false를 반환하는 ActionScript 함수입니다. 첫 번째 매개변수는 RecordSet 객체의 단일 레코드입니다. 레코드가 결과 RecordSet 객체에 포함되어야 할 때는 이 함수가 true를 반환합니다.

context 호출자가 제공한 문맥 값입니다.


[반환 값]

복사본이 아닌 filter 함수가 선택한 모든 레코드에 대한 참조가 있는 새 RecordSet 객체입니다.


[설명]

방법: Record 객체의 각 레코드에 대해 한 번씩 filter 함수를 호출하고, filter 함수가 true를 반환한 모든 레코드를 새 RecordSet 객체에 수집하여 새 Record 객체를 생성합니다. 새 RecordSet 객체의 레코드 순서는 원래 Record 객체의 레코드 순서와 같습니다. 필터링하는 동안 원래 RecordSet 객체가 통과되는 순서는 정의되지 않습니다.

완전히 채워지지 않은 RecordSet 객체에 사용하면 현재 사용할 수 있는 레코드만 필터링됩니다. 새 RecordSet 객체는 원래 RecordSet 객체의 뷰 목록이나 서버측 RecordSet 객체와의 연결을 상속하지 않습니다.


[예]

다음 예는 RecordSet 객체의 필터된 뷰를 보여 주는 목록 상자 UI 구성 요소를 작성하는 방법을 보여 줍니다.

#include "NetServices.as"
var allFlights =new RecordSet(["flight","numberOfStops"]);
allFlights.addItem({flight:"123", numberOfStops: 0});
allFlights.addItem({flight:"321", numberOfStops: 3});
allFlights.addItem({flight:"456", numberOfStops: 1});
allFlights.addItem({flight:"654", numberOfStops: 2});
function flightFilter(aRecord, requestedNumberOfStops)
{
return (aRecord.numberOfStops <= requestedNumberOfStops);
}
myListBox.setDataProvider(allFlights.filter(flightFilter, 2));


--------------------------------------------------------------------------------

RecordSet.sort


[사용 가능 여부]

Flash 플레이어 6.

Flash Remoting


[용도]

RecordSet.sort(compareFunction)


[매개변수]

compareFunction 정렬 순서를 결정하는 ActionScript 비교 함수입니다. 인수 A와 B를 지정하면 비교 함수는 다음과 같이 값을 반환합니다.

정렬된 순서에서 A가 B 앞에 나오면 -1을 반환합니다.

A = B이면 0을 반환합니다.

정렬된 순서에서 A가 B 뒤에 나오면 1을 반환합니다.


[반환 값]

없음


[설명]


방법: 사용자가 지정한 비교 함수를 사용하여 모든 레코드를 정렬합니다. 비교 함수는 새 복사본을 만들지 않고 모든 레코드를 적절히 정렬합니다. 이 순서는 사용자가 제공한 compareFunction이 결정합니다. 원래 순서는 유지되지 않습니다.

sort 함수는 sortItemsBy 함수보다 10배 가량 느립니다.

등록된 모든 뷰는 다음 콜백을 받습니다.

View.modelChanged("sort");
sort 함수를 사용할 때는 다음과 같은 상황이 발생하지 않도록 하십시오.

범위를 벗어난 색인

레코드 매개변수가 객체가 아닙니다.

레코드 매개변수에 알 수 없는 필드가 있거나 필드가 누락되었습니다.

RecordSet 객체가 응용프로그램 서버와 연결되어 있는데 아직 완전히 채워지지 않았습니다.


[에러 처리]

에러 조건 : 발생하는 작업 : 에러 메시지

RecordSet 객체가 완전히 채워지지 않았습니다. : RecordSet 객체가 변경되지 않고 Flash MX 출력 창과 디버그 콘솔에 에러 메시지가 보고됩니다. : 일부 RecordSet 객체에 대해 작업할 수 없습니다.



[예]

다음 예는 여러 키를 사용하여 employeeList RecordSet 객체를 정렬하는 방법을 보여 줍니다.

function orderBySeveralKeys(aRecord, bRecord)
{

var aKey = aRecord.location ‎+ aRecord.department + aRecord.lastName;
var bKey = bRecord.location ‎+ bRecord.department + bRecord.lastName;
if (aKey < bKey)
{
return -1;
}
else if (aKey > bKey)
{
return 1;
}
else
{
return 0;
}
}
employeeList.sort(orderBySeveralKeys);


--------------------------------------------------------------------------------