This page was saved using jaction on 2006-09-04 8:33:36.
Address: http://flexdocs.kr/docs/flex2/langref/mx/data/DataStore.html
Title: mx.data.DataStore (Flex™ 2 레퍼런스 가이드)  •  Size: 47414
(Flex Data Services 전용)
Packagemx.data
Classpublic class DataStore
InheritanceDataStore Inheritance EventDispatcher Inheritance Object

DataStore 는, DataService 인스턴스에 대한 트랜잭션(transaction)를 배치처리 합니다. DataStore 는, 서버앞의 보류되고 있는 변경을 관리해, 서버로부터 수신한 경합을 보존합니다. 디폴트에서는, DataService 가 관리 대상이 관련짓고를 가지고 있지 않으면 고유의 DataStore 가 자동적으로 작성됩니다. commit() Methods를 호출하면, 그 DataService 에 대해서 행해진 변경만이 송신됩니다.

관리 대상이 관련짓고를 사용하는 경우는, 디폴트가 변경되어 같은 채널 세트를 공유해, use-transactions 플래그의 값이 같은 모든 DataService 인스턴스가, 같은 DataStore 를 공유하게 됩니다. DataStore 를 공유하고 있는 경우는,commit() Methods를 한 번 호출하는 것만으로, 그 DataStore 를 공유하고 있는 모든 DataService 인스턴스가 간 모든 변경이 대상이 됩니다. 디폴트가 변경되는 것은, 관리 대상이 관련짓고가 있으면, 복수의 행선지의 변경동안에 의존관계(dependencies)가 있어, 메세지를 서버에 송신할 때에, 클라이언트상에서의 조작의 순서를 유지하는 것이 중요한 경우가 있기 (위해)때문에입니다.

디폴트를 변경하는 경우는, 독자적인 DataStore 를 작성해, DataService 의 dataStore property에 수동으로 할당합니다. 이것은, 최초로 DataService 를 초기화했을 때에, fill 나 getItem 등, 다른 DataService API 를 호출하기 전에 실행합니다. 같은 DataStore 를 공유하는 모든 DataServices 는, 같은 채널 세트를 사용해, use-transactions 플래그의 값이 같은 필요가 있습니다.

See also

분산 데이터 어플리케이션의 작성

Public property
 property정의
  autoCommit : Boolean
true 를 설정하면, DataService 에 의해 관리되는 상태를 변경하는 조작은, 곧바로 완료합니다.
DataStore
  autoMerge : Boolean
false 를 설정하면, 서버로부터 클라이언트로 변경이 푸쉬 되었을 때, 변경은 자동적으로 적용되지 않습니다.
DataStore
  commitRequired : Boolean
[read-only] 완료가 필요한 보류중의 갱신이 있을지 어떨지를 나타냅니다.
DataStore
  conflicts : Conflicts
[read-only] 모든 관리 대상 아이템에 대한 경합의 리스트를 돌려줍니다.
DataStore
  connected : Boolean
[read-only] DataStore 가 접속되고 있는지 어떤지를 나타냅니다.
DataStore
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor　 　 함수에의 참조입니다.
Object
  mergeRequired : Boolean
[read-only] 결합이 필요한 보류중의 변경이 있을지 어떨지를 나타냅니다.
DataStore
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
  requestTimeout : int
조작의 타임 아웃 시간 (초단위)에 대한 액세스를 제공합니다.
DataStore
Public Methods
 Methods정의
  DataStore (destination:String , useTransactions:Boolean )
통상 DataStore 는 자동적으로 작성됩니다만, 독자적인 DataStore 를 작성해 DataService 의 dataStore property에 할당할 수도 있습니다.
DataStore
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
  commit ():AsyncToken
현재 이 DataService 로 관리 떠날 수 있어 모든 콜렉션으로 보류 상태의 변경을 완료합니다.
DataStore
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  merge ():void
보류중의 갱신을 관리 대상의 object 세트에 결합합니다.
DataStore
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
  revertChanges ():Boolean
이 DataStore 로 관리 떠날 수 있어 모든 DataServices 에 대한, 보류중에서 아직 완료하고 있지 않는 변경을 모두 취소합니다.
DataStore
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
이벤트
 이벤트일람정의
  conflict 이 클라이언트상에서 보류중의 변경과 다른 클라이언트에 의해 송신된 변경동안에 경합이 검출되었을 경우인가, 이 클라이언트가 송신한 변경이 리모트 행선지상에서 경합 에러가 되었을 경우에 dispatch됩니다. DataStore
  fault FaultEvent.FAULT 이벤트는, commit 호출이 에러를 돌려줄 때 dispatch됩니다. DataStore
  result ResultEvent.RESULT 이벤트는, commit 호출이 정상적으로 돌아갈 때 dispatch됩니다. DataStore
property의 상세
autoCommitproperty
autoCommit:Boolean   [read-write]

true 를 설정하면, DataService 에 의해 관리되는 상태를 변경하는 조작은, 곧바로 완료합니다. false 를 설정하면, 변경을 서버에 송신하려면 commit() Methods를 명시적으로 호출할 필요가 있습니다.

Implements
    public function get autoCommit():Boolean
    public function set autoCommit(value:Boolean ):void
autoMergeproperty 
autoMerge:Boolean   [read-write]

false 를 설정하면, 서버로부터 클라이언트로 변경이 푸쉬 되었을 때, 변경은 자동적으로 적용되지 않습니다. 대신에,mergeRequired property에 true 가 설정됩니다. 이 property에 대해서 변경 이벤트를 릿슨 하는 것으로, 결합을 적용할 필요가 있을 때 통지를 받을 수가 있습니다. 변경을 결합하려면 ,merge() Methods를 호출합니다. 이것에 의해, 모든 변경이 적용됩니다. 결합이 필요한 변경이 있으면, 변경을 완료할 수 없습니다.

Implements
    public function get autoMerge():Boolean
    public function set autoMerge(value:Boolean ):void
commitRequiredproperty 
commitRequired:Boolean   [read-only]

완료가 필요한 보류중의 갱신이 있을지 어떨지를 나타냅니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
    public function get commitRequired():Boolean
conflictsproperty 
conflicts:Conflicts   [read-only]

모든 관리 대상 아이템에 대한 경합의 리스트를 돌려줍니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
    public function get conflicts():Conflicts
connectedproperty 
connected:Boolean   [read-only]

DataStore 가 접속되고 있는지 어떤지를 나타냅니다.

Implements
    public function get connected():Boolean
mergeRequiredproperty 
mergeRequired:Boolean   [read-only]

결합이 필요한 보류중의 변경이 있을지 어떨지를 나타냅니다.

이 property는 데이터 바인딩의 소스로서 사용할 수 있습니다.

Implements
    public function get mergeRequired():Boolean
requestTimeoutproperty 
requestTimeout:int   [read-write]

조작의 타임 아웃 시간 (초단위)에 대한 액세스를 제공합니다. 제로 이하의 값을 설정하면, 요구는 타임 아웃이 되지 않습니다.

Implements
    public function get requestTimeout():int
    public function set requestTimeout(value:int ):void
constructor　 　 의 상세
DataStore()constructor　 　
public 함수 DataStore(destination:String , useTransactions:Boolean )

통상 DataStore 는 자동적으로 작성됩니다만, 독자적인 DataStore 를 작성해 DataService 의 dataStore property에 할당할 수도 있습니다. 그 때문에(위해)는, 같은 데이터 스토어를 공유하는 모든 데이터 서비스가 같은 채널 세트를 사용해, use-transactions 설정의 값이 같다라고 하는 것이 필요합니다. DataStore 를 작성하려면 이 constructor　 　 을 사용합니다. 행선지 Parameters에는, 이 데이터 스토어를 사용하고 있는 DataServices 의 1 개를 지정합니다. 이것은, 채널 세트를 검색하기 위해(때문에)인 만큼 사용됩니다. 또, 이 데이터 스토어의 use-transactions 플래그의 값을 지정할 필요가 있습니다.

Parameters
destination:String
 
useTransactions:Boolean
Methods의 상세
commit()Methods
public function commit():AsyncToken

현재 이 DataService 로 관리 떠날 수 있어 모든 콜렉션으로 보류 상태의 변경을 완료합니다. autoCommit property가 true 의 경우, 트랜잭션(transaction)는사용되지 않습니다. 트랜잭션(transaction)를 사용하려면 ,autoCommit property에 false 를 설정해, 이 Methods를 직접 호출합니다.

반환값
AsyncToken — ResultEvent.RESULT 또는 FaultEvent.FAULT 의 call property로 돌려주어지는 object입니다. custom 데이터를 이 object에 관련지어 나중에 event 처리 국면으로 조사할 수가 있습니다.
merge()Methods 
public function merge():void

보류중의 갱신을 관리 대상의 object 세트에 결합합니다. 변경을 결합하는 처리로 경합이 검출되는 일이 있습니다.

revertChanges()Methods 
public function revertChanges():Boolean

이 DataStore 로 관리 떠날 수 있어 모든 DataServices 에 대한, 보류중에서 아직 완료하고 있지 않는 변경을 모두 취소합니다.

반환값
Boolean — 변경이 삭제되었을 경우는 true 가 됩니다.
이벤트의 상세
conflictevent 
Event object type: mx.data.events.DataConflictEvent
DataConflictEvent.type property = mx.data.events.DataConflictEvent.CONFLICT

이 클라이언트상에서 보류중의 변경과 다른 클라이언트에 의해 송신된 변경동안에 경합이 검출되었을 경우인가, 이 클라이언트가 송신한 변경이 리모트 행선지상에서 경합 에러가 되었을 경우에 dispatch됩니다. DataStore 는, DataStore 를 공유하는 모든 행선지에 대해서 경합 이벤트를 dispatch합니다. 또, DataService 에 대해서 특정의 종류의 경합 이벤트를 릿슨 할 수도 있습니다. 관련짓고를 가지는 object가 있는 경우는 DataStore 를 사용해 주세요. 그 이유는, 이것들 관련짓고의 사이의 정합성을 유지하기 위해서, 특정의 순서로 경합을 해결할 필요가 있는 것을 생각되기 (위해)때문에입니다.

CONFLICT 이벤트형.

event object의 각 property에는 다음의 값이 설정됩니다.

PropertyValue
bubblesfalse
cancelablefalse
currentTarget이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다.
conflict 발생한 경합을 보관 유지하는 Conflict object입니다.
message 이 이벤트에 관련지을 수 있었던 메세지.
target이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요.
faultevent  
Event object type: mx.rpc.events.FaultEvent
FaultEvent.type property = mx.rpc.events.FaultEvent.FAULT

FaultEvent.FAULT 이벤트는, commit 호출이 에러를 돌려줄 때 dispatch됩니다.

FAULT event 타입입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

PropertyValue
bubblesfalse
cancelabletrue. 관련지을 수 있었던 토큰의 responder.fault Methods로부터 preventDefault()를 호출하면, 서비스 또는 처리가 이 이벤트를 dispatch하지 않게 됩니다.
currentTarget이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다.
fault이 이벤트의 원인에 대한 상세가 포함되는 Fault object입니다.
message이 이벤트에 관련지을 수 있었던 메세지.
target이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요.
tokenMethods의 호출을 나타내는 토큰. Asynchronous Completion Token 패턴으로 사용됩니다.
resultevent  
Event object type: mx.rpc.events.ResultEvent
ResultEvent.type property = mx.rpc.events.ResultEvent.RESULT

ResultEvent.RESULT 이벤트는, commit 호출이 정상적으로 돌아갈 때 dispatch됩니다.

RESULT event 타입입니다.

event object의 각 property에는 다음의 값이 설정됩니다.

PropertyValue
bubblesfalse
cancelabletrue. 관련지을 수 있었던 토큰의 responder.result Methods로부터 preventDefault()를 호출하면, 서비스 또는 처리가 이 이벤트를 dispatch하지 않게 됩니다.
currentTarget이벤트를 처리하는 event listener를 정의하는 object. 예를 들어, event listener의 등록에 myButton.addEventListener() 를 사용하면,currentTarget 의 값은 "myButton" 가 됩니다.
message 이 이벤트에 관련지을 수 있었던 메세지.
target이벤트를 dispatch한 object를 나타냅니다. 이 object는 반드시 이벤트를 받는 object라고는 할 수 없습니다. 이벤트를 받는 object에 항상 액세스 하려면 ,currentTarget property를 사용해 주세요.
resultRPC 호출이 돌려주는 결과입니다.
tokenMethods의 개개의 호출을 나타내는 토큰. Asynchronous Completion Token 패턴으로 사용됩니다.



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08. 17, 오후 11:21, GMT-07:00


 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/data/DataStore.html