MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY Specifikace stáhnout pdf (Strana 346)

Description

Static method; returns a reference to a shared object instance. To perform any operation on a

shared object, the server-side script must get a reference to the named shared object using the

SharedObject.get method. If the object requested is not found, a new instance is created.

There are two types of shared objects, persistent and nonpersistent, and they are in separate name

spaces. This means that a persistent and a local shared object can have the same name, but they

are two distinct shared objects. Shared objects are scoped to the name space of the application

instance and are identified by a string name. The shared object names should conform to the URI

specification.

You can also call

SharedObject.get to get a reference to a shared object that is in a name space

of another application instance. This instance can be on the same server or on a different server

and is called a proxied shared object. To get a reference to a shared object from another instance,

create a NetConnection object and use the

NetConnection.connect method to connect to the

application instance that owns the shared object. Pass the NetConnection object as the

netConnection parameter of the SharedObject.get method. The server-side script must get a

reference to a proxied shared object before there is a request for the shared object from any client.

To do this, call

SharedObject.get in the application.onAppStart handler.

If you call

SharedObject.get with a netConnection parameter and the local application

instance already has a shared object with the same name, the shared object converts to a proxied

shared object. All shared object messages for clients connected to a proxied shared object are sent

to the master instance.

If the connection state of the NetConnection object that was used as the

netConnection

parameter changes state from connected to disconnected, the proxied shared object is set to idle

and any messages received from subscribers are discarded. The

NetConnection.onStatus

handler is called when a connection is lost. You can then re-establish a connection to the remote

instance and call

SharedObject.get, which changes the state of the proxied shared object from

idle to connected.

If you call

SharedObject.get with a new NetConnection object on a proxied shared object that

is already connected and if the URI of the new NetConnection object doesn’t match the current

NetConnection object, the proxied shared object unsubscribes from the previous shared object,

sends a “clear” event to all subscribers, and subscribes to the new shared object instance. When a

subscribe to a proxied shared object is successful, all subscribers are reinitialized to the new state.

This process lets you migrate a shared object from one application instance to another without

disconnecting the clients.

Updates received by proxied shared objects from subscribers are checked to see if the update can

be rejected based on the current state of the proxied shared object version and the version of the

subscriber. If the change can be rejected, the proxied shared object doesn’t forward the message to

the remote instance; the reject message is sent to the subscriber.

The corresponding client-side ActionScript method is

SharedObject.getRemote.

1 2 ... 341 342 343 344 345 346 347 348 349 350 351 ... 368 369

Komentáře k této Příručce

Žádné komentáře

MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY Specifikace Strana 346

Komentáře k této Příručce

Související produkty a manuály pro Servery MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY