MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER 2 Manual de usuario descargar pdf (Pagina 139)

136

SERVER-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR ADOBE MEDIA SERVER 5.0.1

Server-Side ActionScript Language Reference

Last updated 7/2/2013

Details

There are two types of shared objects, persistent and nonpersistent, and they have separate namespaces. This means

that a persistent and a nonpersistent shared object can have the same name and exist as two distinct shared objects.

Shared objects are scoped to the namespace of the application instance and are identified by a string. 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 namespace 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 is converted to a proxied shared object. All shared object messages

for clients that are 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 reestablish 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 operation 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().

Example

The following example creates a shared object named foo in the function onProcessCmd(). The function is passed a

parameter,

cmd, that is assigned to a property in the shared object.

function onProcessCmd(cmd){

// Insert code here.

var shObj = SharedObject.get("foo", true);

propName = cmd.name;

shObj.getProperty (propName, cmd.newAddress);

}

The following example uses a proxied shared object. A proxied shared object resides on a server or in an application

instance (called master) that is different from the server or application instance that the client connects to (called

proxy). When the client connects to the proxy and gets a remote shared object, the proxy connects to the master and

gives the client a reference to this shared object. The following code is in the main.asc file:

1 2 ... 134 135 136 137 138 139 140 141 142 143 144 ... 171 172

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER 2 Manual de usuario Pagina 139

Comentarios a estos manuales

MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER 2 Manual de usuario Pagina 139

Comentarios a estos manuales

Relacionado con productos y manuales para Servidores MACROMEDIA FLASH MEDIA SERVER 2-CLIENT-SIDE ACTIONSCRIPT LANGUAGE REFERENCE FOR FLASH MEDIA SERVER 2