MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT DICTIONARY Manual page 45

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
method. If the object requested is not found, a new instance is created.
SharedObject.get
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 to get a reference to a shared object that is in a name space
SharedObject.get
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 method to connect to the
NetConnection.connect
application instance that owns the shared object. Pass the NetConnection object as the
parameter of the method. The server-side script must get a
netConnection SharedObject.get
reference to a proxied shared object before there is a request for the shared object from any client.
To do this, call in the handler.
SharedObject.get application.onAppStart
If you call with a parameter and the local application
SharedObject.get netConnection
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 , which changes the state of the proxied shared object from
SharedObject.get
idle to connected.
If you call with a new NetConnection object on a proxied shared object that
SharedObject.get
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
46