autoCommit:Boolean   [read-write]

버퍼에의 변경을 자동적으로 완료할지 어떨지를 나타냅니다. 완료한 변경은, 곧바로 리모트 서비스에 송신됩니다.

Implements
    public function get autoCommit():Boolean
    public function set autoCommit(value:Boolean ):void

autoMerge:Boolean   [read-write]

false 를 설정하면, 리모트 행선지로부터 클라이언트로 변경이 푸쉬 되었을 때에 변경이 즉시에는 적용되지 않게 됩니다. 대신에,mergeRequired property에 true 가 설정됩니다. 이 property에 대해서 변경 이벤트를 릿슨하기 위한 event 핸들러를 등록하는 것으로, 결합을 적용할 필요가 있을 때 통지를 받을 수가 있습니다. 변경을 결합하려면 ,merge() Methods를 호출합니다. 이것에 의해, 모든 변경이 적용됩니다. 결합이 필요한 변경이 있으면, 미완료의 변경을 완료할 수 없습니다. 페이징이 유효하게 되어 있으면, 로컬이 아닌 아이템에 대한 모든 요구는,merge() 가 불려 갈 때까지 캐쉬됩니다. merge() 를 호출하면, 캐쉬되고 있던 요구가 처리됩니다.

Implements
    public function get autoMerge():Boolean
    public function set autoMerge(value:Boolean ):void

commitRequired:Boolean   [read-only]

완료하고 있지 않는 변경이 있어,commit() Methods를 호출할 필요가 있을지 어떨지를 나타냅니다. 이 property가 변경되면, 이벤트가 dispatch됩니다. 이 property를 어플리케이션내에서 사용해, 시각적인 피드백을 제공할 수가 있습니다.

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

Implements
    public function get commitRequired():Boolean

conflictDetector:ConflictDetector   [write-only]

이 DataService 에 푸쉬 된 리모트 조작의 경합을 검출하기 위해서 사용되고 있는, 현재의 Implements에 대한 액세스를 제공합니다.

Implements
    public function set conflictDetector(value:ConflictDetector ):void

conflicts:Conflicts   [read-only]

Conflict 인스턴스의 ArrayList 인 Conflicts object를 돌려줍니다. 경합은,commit() 를 호출하기 전에 해결할 필요가 있습니다. 경합을 해결하려면 , 개개의 경합을 1 개씩 해결하는지, 이 property에 대해서 acceptAllClient() Methods 또는 acceptAllServer() Methods를 호출합니다.

Implements
    public function get conflicts():Conflicts

dataStore:DataStore   [read-write]

mx.data.DataStore 형의 object를 돌려줍니다. DataStore 는, 1 개 또는 복수의 DataService 에 대해서 수신하는 변경과 송신하는 변경세트를 관리합니다. DataService 는 서로 서로 참조하고 있는 일이 있습니다. DataStore 상에서 변경을 완료하면, 그 DataStore 를 사용하고 있는 각 DataService 의 보류 상태의 변경이 모두 완료합니다. 복수의 DataService 가 관리된 관련짓고 property를 가져, 같은 채널 세트를 공유하고 있는 경우, 디폴트에서는 DataService 는 같은 DataStore 를 다른 DataService 와 공유합니다. DataStores 를 공유하고 있는 경우, 어느 DataService 에 대해서 완료 Methods를 호출하면, 그 데이터 스토어를 사용하고 있는 모든 DataService 의 변경이 완료합니다. 완료하고 있지 않는 배치에 의한 변경동안에 의존관계(dependencies)가 있는 경우에 대비해 조작의 순서가 유지됩니다.

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

Implements
    public function get dataStore():DataStore
    public function set dataStore(value:DataStore ):void

destination:String   [read-write]

이 서비스를 관련지을 수 있고 있는 리모트 행선지를 나타냅니다.

Implements
    public function get destination():String
    public function set destination(value:String ):void

mergeRequired:Boolean   [read-only]

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

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

Implements
    public function get mergeRequired():Boolean

pageSize:int   [read-write]

모든 콜렉션에 대한 현재의 페이지 크기 설정에의 액세스를 제공합니다.

Implements
    public function get pageSize():int
    public function set pageSize(value:int ):void

pagingEnabled:Boolean   [read-only]

리모트 행선지가 페이징 요구를 허가하도록(듯이) 설정되어 있는지 어떤지를 나타냅니다.

Implements
    public function get pagingEnabled():Boolean

requestTimeout:int   [read-write]

조작의 타임 아웃 시간 (초단위)에 대한 액세스를 제공합니다. 제로 이하의 값을 설정하면, 요구는 타임 아웃이 되지 않습니다. requestTimeout 의 제한에 이른 것에 의해 현재의 조작이 타임 아웃이 되면, 그 조작에 관해서, 요구가 타임 아웃이 된 것을 나타내는 fault가 dispatch됩니다.

Implements
    public function get requestTimeout():int
    public function set requestTimeout(value:int ):void

public 함수 DataService(dest:String = null)

지정된 행선지를 가지는 DataService 의 인스턴스를 작성합니다. 행선지는, services-config.xml 파일로 설정된 행선지에 대한 참조인 것이 필요합니다.

Parameters

dest:String (default = null) — 이 서비스가 접속하는 리모트 행선지의 이름이 포함되는 string입니다.

public override function commit():AsyncToken

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

반환값

AsyncToken — ResultEvent.RESULT 또는 FaultEvent.FAULT 의 callproperty로 돌려주어지는 AsyncToken 입니다. custom 데이터를 이 object에 관련지어 나중에 event 처리 국면으로 조사할 수가 있습니다.

public override function count(... args):AsyncToken

리모트 행선지에 대해서 count Methods를 호출합니다. 불려 가는 count Methods는, 관련지을 수 있고 있는 <count-method> 태그라고 건네받은 Parameters에 근거합니다. 예를 들어,count("firstName", "Bob") 를 호출했을 경우를 생각합니다. 관련지을 수 있고 있는 행선지의 services-config.xml 중에, <count-method> 태그가 존재하든가 참조되고 있다고 합니다.

            <count-method>
                <name>getCount</name>
                <params>java.lang.String, java.lang.String</params>
                <security-run-as name="freddie" password="nightmare" />
            </count-method>
            
            <count-method>
                <name>getCount</name>
                <security-constraint ref="sample-users" />
            </count-method>
      

run-as 시큐러티 설정이 있는 최초의 <count-method> 는, 2 개의 Parameters를 포함하고 있어 <params> 태그의 형태와 개수가 일치합니다. 이 때문에, 이 <count-method> 가 불려 갑니다.

Parameters

... args — 리모트 행선지에 건네주는 Parameters의 리스트입니다.

반환값

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

public override function createItem(item:Object ):ItemReference

지정한 아이템을 리모트 스토어에 작성하는 것을 요구합니다. 에러가 발생하면,DataConflictEvent 가 dispatch됩니다.

Parameters

item:Object — 리모트 스토어에 작성하는 object입니다.

반환값

ItemReference — ItemReference (AsyncToken 를 확장합니다). 이 참조는,ResultEvent.RESULT 또는 FaultEvent.FAULT 의 token property로 돌려주어집니다. custom 데이터를 이 object에 관련지어 나중에 event 처리 국면으로 조사할 수가 있습니다. 이 object의 result property는 바인드 가능해, 돌려주어진 아이템을 바인드 하기 위해서 사용할 수 있습니다. 아이템이 다른 클라이언트에 의해 삭제되었을 경우, 이 결과의 object에는 null 가 설정됩니다. 어플리케이션으로 ItemReference object를 보관 유지하는 경우는, 아이템에 대한 이 참조를 사용해 끝내면,ItemReference 의 releaseItem() Methods를 호출할 필요가 있습니다. ItemReferences 를 보관 유지하지 않는 경우는, DataService 에 대해서 releaseItem() Methods를 실행할 수가 있습니다. 이 Methods는, 해방하는 아이템의 인스턴스 자체를 받습니다.

public override function deleteItem(item:Object ):AsyncToken

지정한 아이템을 리모트 스토어로부터 삭제하는 것을 요구합니다. 에러가 발생하면,DataConflictEvent 가 dispatch됩니다.

Parameters

item:Object — 리모트 스토어로부터 삭제하는 object입니다.

반환값

AsyncToken — ResultEvent.RESULT 또는 FaultEvent.FAULT 의 token property로 돌려주어지는 AsyncToken 입니다. custom 데이터를 이 object에 관련지어 나중에 event 처리 국면으로 조사할 수가 있습니다.

public override function disconnect():void

DataService 의 네트워크 접속을 절단 합니다. 이 Methods는, 미처리의 네트워크 조작이 완료할 때까지 기다리는 것은 하지 않습니다.

public override function fill(value:ListCollectionView , ... args):AsyncToken

관련지을 수 있고 있는 <fill-method> 요소에 근거해, 지정된 ListCollectionView 를 발라 잡습니다. 예를 들어, 이하의 <fill-method> 요소가 존재하는지, 관련지을 수 있고 있는 행선지의 services-config.xml 로 참조되고 있다고 합니다.

<fill-method>
<name>loadPersons</name>
<params>java.lang.String, java.lang.String</params>
<security-run-as name="freddie" password="nightmare" />
</fill-method>
            
<fill-method>
<name>loadPersons</name>
<security-constraint ref="sample-users" />
</fill-method>
      

이 경우,fill(myCollection, ["firstName", "Bob"]) 를 호출하면, <params> 태그의 형태와 개수가 일치하는 2 개의 Parameters가 포함되어 있기 (위해)때문에, run-as 시큐러티 설정이 있는 최초의 <fill-method> 가 불려 갑니다. 같이fill(myCollection) 를 호출하면, <params> 태그가 포함되지 않은 2 번째의 <fill-method> 태그가 불려 갑니다. 보류중의 변경이나 데이터는, fill 의 호출 중(안)에서 클리어 됩니다.

Parameters

	value:ListCollectionView — 지정한 Parameters로 발라 잡는 콜렉션에의 참조입니다.
	... args — rest: 리모트 행선지에 건네주는 Parameters의 배열 변수 리스트입니다.

반환값

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

public override function getItem(identity:Object , defaultValue:Object = null):ItemReference

지정한 ID 에 일치하는 아이템에 대해서 비동기 요구를 실시합니다. defaultValue 를 지정해, 아이템이 존재하지 않으면defaultValue 의 정보를 사용해 아이템이 작성됩니다. 이 Methods는 ItemReference 를 돌려줍니다. getItem() Methods 호출로부터 유효한 인스턴스를 받으면,releaseItem() Methods를 호출해 아이템의 인스턴스를 해방할 필요가 있습니다. ItemReference 를 보관 유지하는 경우는, 참조에 대해서 releaseItem() Methods를 호출해, 올바른 참조를 확실히 해방해 주세요. 이것은, 같은 아이템에 대해서 클라이언트가 복수의 getItem() Methods 호출을 실시하고 있었을 경우에 대비한 일입니다. ItemReference 를 보관 유지하지 않는 경우는, DataService 의 releaseItem() Methods를, 아이템 자체를 지정해 호출할 수가 있습니다.

Parameters

	identity:Object — 목적의 object의 ID property가 포함된 object입니다.
	defaultValue:Object (default = null) — 인스턴스가 존재하지 않는 경우에 작성되는, 디폴트치를 가진 인스턴스입니다.

반환값

ItemReference — 취득하는 아이템의 ItemReference 입니다. ItemReference 는 AsyncToken 를 확장하기 위해(때문에), 이것을 사용해, 아이템이 취득되었을 경우나 이 호출이 장해가 되었을 경우에 통지를 받을 수가 있습니다. ItemReference 는, DataService object에 대해서 이벤트를 릿슨 하고 있는 경우,ResultEvent.RESULT 또는 FaultEvent.FAULT 의 token property로서 돌려주어집니다. custom 데이터를 이 object에 관련지어 나중에 event 처리 국면으로 조사할 수가 있습니다. 데이터 바인딩을 사용해 ItemReference 의 result property에 바인드 할 수가 있습니다. 아이템이 리모트 행선지로부터 값을 설정되고 바인드 가능한 경우, 이 property에 유효한 값이 설정됩니다. 그 때문에, 유저 인터페이스 컨트롤을 ItemReference 의 result property에 바인드 할 수가 있습니다. 아이템이 서버 또는 다른 클라이언트로부터 삭제되었을 경우, 이 참조에는 null 가 설정됩니다. ItemReference 에는 invalid property도 있습니다. 아이템을 돌려줄 때에 에러가 되었는지, 아이템에 대해서 서버가 null 를 돌려주면, 이 property에 true 가 설정됩니다.

public override function getPendingOperation(item:IManaged ):uint

지정된 아이템의 메세지 캐쉬중에 보류되고 있는 조작을 돌려줍니다. 이 Methods는, 아이템에 대해서 어떠한 종류의 변경을 했는지를 유저에게 시각적으로 피드백하기 위해서 사용합니다.

Parameters

item:IManaged — 검사의 기준입니다.

반환값

uint — 실행된 보류중의 조작을 나타내는 uint 입니다. 아이템에 대해서 유효한 조작은 이하대로입니다. DataMessage.CREATE_OPERATION - 지정된 아이템에 대해서 작성이 보류중인 것을 나타냅니다. DataMessage.DELETE_OPERATION - 지정된 아이템에 대해서 삭제가 보류중인 것을 나타냅니다. DataMessage.UPDATE_OPERATION - 지정된 아이템에 대해서 갱신이 보류중인 것을 나타냅니다. DataMessage.UNKNOWN_OPERATION - 지정된 아이템에 대해서 보류중의 조작이 없는 것을 나타냅니다.

public override function logout():void

유저를 DataService 의 행선지로부터 로그아웃 합니다. 행선지의 로그아웃은, 서버 설정으로 지정되고 있는 것과 같은 ChannelSet 를 사용해 접속되고 있는 모든 것에 적용됩니다. 예를 들어, my-rtmp 채널상에서 접속하고 있어, DataService 인스턴스의 1 개를 사용해 로그아웃 하면, 같은 ChannelSet 상에서 접속하고 있던 모든 유저가 로그아웃 됩니다.

public override function merge():void

보류중의 갱신을 관리 대상의 object 세트에 결합합니다. 변경을 결합하는 처리로 경합이 검출되어 보류중의 아이템 요구가 모두 처리됩니다. 이것에 의해, 이 같은 데이터 스토어를 공유하고 있는 다른 모든 DataService 인스턴스의 모든 메세지가 결합됩니다.

public override function release():void

DataService 의 모든 관리 대상 콜렉션과 아이템을 해방합니다.

public override function releaseCollection(view:ListCollectionView , clear:Boolean = false):void

지정한 콜렉션내의 모든 아이템을, 이 서비스에 의한 관리로부터 해방합니다. 아이템이 복수의 콜렉션에 존재하는 경우는, 아이템의 복사가 작성됩니다. 이 콜렉션인 만큼 존재하는 아이템에 대한 완료하고 있지 않는 변경은, 삭제, 작성, 갱신을 포함해 모두 해방됩니다.

Parameters

	view:ListCollectionView — 더 이상 리모트 갱신을 받지 않는 ListCollectionView 의 참조입니다.
	clear:Boolean (default = false) — 모든 아이템을 리스트로부터 삭제할지 어떨지를 나타내는 불리언 값입니다. 또, 어느 아이템의 복사도 작성되지 않습니다.

public override function releaseItem(item:IManaged , allowCopy:Boolean = true):IManaged

지정된 아이템을 이 서비스에 의한 관리로부터 해방합니다. ItemReferences 를 보관 유지하는 경우는, ItemReference 에 대해서 releaseItem() Methods를 호출해, 올바른 참조를 확실히 해방해 주세요. 이것은, 클라이언트 어플리케이션이 다른 부분으로부터 getItem 를 여러 차례 호출해, 같은 아이템을 취득하고 있었을 경우에 대비한 일입니다.

이 호출에 의해, 네스트 한 property를 포함해 관련 붙일 수 있어 모든 리소스가 해방됩니다. 지정된 아이템은 리모트 행선지로부터의 갱신은 받지 않게 됩니다. 또, 이 아이템에 대해서 완료하고 있지 않는 변경이 있어, 다른 콜렉션에 나타나지 않는 경우는, 이러한 변경도 해방됩니다. 지정된 아이템이 복수의 콜렉션에 존재하는 경우는,allowCopy Parameters에 false 를 설정하지 않는 한, 돌려주어지는 값은 원의 복사가 됩니다.

Parameters

	item:IManaged — 해방하는 아이템에의 IManaged 참조입니다.
	allowCopy:Boolean (default = true) — 옵션의 Parameters로, 디폴트는 true 입니다. true 의 경우, 아이템이 다른 관리되고 있는 참조로 사용되고 있으면, 아이템의 복사가 작성됩니다. false 를 설정할 수도 있습니다만, 다른 참조에 의해 관리되고 있었을 경우는, object는 서버로부터 계속해 갱신될 가능성이 있는 것을 의미합니다.

반환값

IManaged — 해방된 아이템. allowCopy=false 의 경우는 복사가 되어, 아이템은 다른 참조에 의해 관리되고 있습니다.

public override function revertChanges(item:IManaged = null):Boolean

지정한 아이템에 대한 완료하고 있지 않는 변경을 모두 바탕으로 되돌립니다. 아이템을 지정하지 않으면 완료하고 있지 않는 변경이 모두 삭제됩니다. 작성 조작을 취소하면, 아이템이 삭제됩니다. 삭제를 취소하면, 아이템이 복원됩니다. 갱신을 취소하면, 변경을 개시하기 전의 아이템의 원의 property에 돌아옵니다.

이 Methods를 사용하는 1 개의 상황은, 장해가 발생한 다음에. 그 경우, 실패한 변경은 미완료 변경 리스트에 되돌려집니다. 그 시점에서, 이러한 변경을 수정해 문제를 해결하는지, 이 Methods를 사용해 이러한 변경이 재차 송신되지 않게 합니다.

아이템이 지정되어 그 아이템이 변경되어 있지 않은 경우는, 이 Methods는 false 를 돌려줍니다. 아이템이 지정되지 않고, 변경이 없는 경우는, 이 Methods는 false 를 돌려줍니다. 그 이외의 경우는, true 를 돌려줍니다.

Parameters

item:IManaged (default = null) — 변경을 취소하는 대상이 되는 참조입니다. 모든 변경을 취소하는 경우는 null 를 지정합니다.

반환값

Boolean — 변경이 삭제되었는지 어떠했는지를 나타내는 불리언 값입니다.

public override function setCredentials(username:String , password:String ):void

이 DataService 의 행선지에 대해서 자격 정보를 설정합니다. 증명서는, 같은 ChannelSet 상에서 접속 떠날 수 있어 모든 서비스에 적용됩니다.

Parameters

	username:String — 행선지의 유저명입니다.
	password:String — 행선지의 패스워드입니다.

public override function setRemoteCredentials(username:String , password:String ):void

이 DataService 의 행선지의 써드파티의 자격 정보를 설정합니다.

Parameters

	username:String — 행선지의 유저명입니다.
	password:String — 행선지의 패스워드입니다.