========================================================================
CONSOLE APPLICATION : CSRemotingServer Project Overview
========================================================================
/////////////////////////////////////////////////////////////////////////////
Use:
.NET Remoting is a mechanism for one-way inter-process communication and RPC
between .NET applications in the local machine or across the computers in the
intranet and internet.
.NET Remoting allows an application to make an remotable object available
across remoting boundaries, which includes different appdomains, processes or
even different computers connected by a network. .NET Remoting makes a
reference of a remotable object available to a client application, which then
instantiates and uses a remotable object as if it were a local object.
However, the actual code execution happens at the server-side. Any requests
to the remotable object are proxied by the .NET Remoting runtime over Channel
objects, that encapsulate the actual transport mode, including TCP streams,
HTTP streams and named pipes. As a result, by instantiating proper Channel
objects, a .NET Remoting application can be made to support different
communication protocols without recompiling the application. The runtime
itself manages the act of serialization and marshalling of objects across the
client and server appdomains.
CSRemotingServer is a .NET Remoting server end. It exposes the following
remote objects:
1. RemotingShared.SingleCallObject
URL: tcp://localhost:6100/SingleCallService
SingleCallObject is a server-activated object (SAO) for .NET Remoting, with
the "SingleCall" mode. Such objects are created on each method call and
objects are not shared among clients. State should not be maintained in such
objects because they are destroyed after each method call.
2. RemotingShared.SingletonObject
URL: tcp://localhost:6100/SingletonService
SingletonObject is a server-activated object (SAO) for .NET Remoting, with
the "Singleton" mode. Only one object will be created on the server to
fulfill the requests of all the clients; that means the object is shared, and
the state will be shared by all the clients.
3. RemotingShared.ClientActivatedObject defined in the shared assembly
CSRemotingSharedLibrary.DLL:
URL: tcp://localhost:6100/RemotingService
ClientActivatedObject is a client-activated object (CAO) for .NET Remoting.
Client-activated objects are created by the server and their lifetime is
managed by the client. In contrast to server-activated objects, client-
activated objects are created as soon as the client calls "new" or any other
object creation methods. Client-activated objects are specific to the client,
and objects are not shared among different clients; object instance exists
until the lease expires or the client destroys the object.
There are generally two ways to create the .NET Remoting server: using a
configuration file or writing codes. The RemotingServerByConfig method
demonstrates the former, and the RemotingServerByCode method illustrates the
latter method.
/////////////////////////////////////////////////////////////////////////////
Project Relation:
CSRemotingClient -> CSRemotingServer
CSRemotingClient is the client end of the CSRemotingServer server end.
CSRemotingServer -> CSRemotingSharedLibrary
CSRemotingServer references a shared library for the client-activated
remoting types.
CSRemotingServer - VBRemotingServer
CSRemotingServer and VBRemotingServer are the same .NET Remoting server
implemented in different .NET languages.
/////////////////////////////////////////////////////////////////////////////
Creation:
A. Adding remotable types on the service end
------
For client-activated types, they must be defined in an assembly shared by
both client and server ends, because client-activated types require not only
the same namespace/class name on both sides, but also the same assembly.
Step1. Create a .NET class library project, exposing the type
(ClientActivatedObject) that inherits MarshalByRefObject and implement the
body of the type. MarshalByRefObject marks the type as a remotable type.
Step2. Add the reference to the class library in the server project.
------
For server-activated types, they can be either defined in a shared assembly,
or defined on the server end and have en empty proxy of the type one the
client ends. Please make sure that the server type and the proxy type have
the same namespace/class name though it is not necessary to place them in the
same assembly.
Step1. Add the server-activated types (SingleCallObject, SingletonObject)
that inherits MarshalByRefObject to the server project. Implement the body of
the types.
B. Creating .NET Remoting server using configuration file
Step1. Add an application configuration file to the project.
Step2. Define the channel to transport message.
<system.runtime.remoting>
<application>
<channels>
<channel ref="tcp" port="6100">
<serverProviders>
<formatter ref="binary" typeFilterLevel="Full" />
</serverProviders>
</channel>
</channels>
</application>
</system.runtime.remoting>
The above configuration registers a TCP channel whose port is 6100 and
formatter is binary.
Step3. Register the remotable types.
------
For client-activated types
<system.runtime.remoting>
<application name="RemotingService">
<service>
<activated type="RemotingShared.ClientActivatedObject, CSRemotingSharedLibrary">
</activated>
</service>
</application>
</system.runtime.remoting>
The name of the application (<application name="RemotingService">) is the
service name of the client-activated types. The clients can access this kind
of types through the URI tcp://server:6100/RemotingService.
------
For server-activated types
<system.runtime.remoting>
<application>
<service>
<wellknown mode="SingleCall"
type="RemotingShared.SingleCallObject, CSRemotingServer"
objectUri="SingleCallService">
</wellknown>
<wellknown mode="Singleton"
type="RemotingShared.SingletonObject, CSRemotingServer"
objectUri="SingletonService">
</wellknown>
</service>
</application>
</system.runtime.remoting>
The mode attribute in wellknown specifies the mode of the server-activated
type: SingleCall or Singleton. The objectUri attribute specifies the service
name of the server-activated types. The clients can access this kind of types
through the URI tcp://server:6100/SingleCallService.
Step4. Read the configuration file and configure the remoting infrastructure
for the server end. (RemotingConfiguration.Configure)
C. Creating .NET Remoting server using code
Step1. Specify the formatter of the messages for delivery.
(BinaryClientFormatterSinkProvider, BinaryServerFormatterSinkProvider)
Once message has been formatted, it is transported to other application
domains through the appropriate channel. .NET comes with the SOAP formatter
(System.Runtime.Serialization.Formatters.Soap) and Binary formatter
(System.Runtime.Serialization.Formatters.Binary).
Step2. Create and register the channel to transport message from one end to
another. (TcpChannel/HttpChannel/IpcChannel, ChannelServices.RegisterChannel)
.NET comes with three built-in channels:
TCP channel (System.Runtime.Remoting.Channels.Tcp) - good for binary
HTTP channel (System.Runtime.Remoting.Channels.Http) - good for internet
IPC channel (System.Runtime.Remoting.Channels.Ipc) - based on named pipe
Step3. Register the remotable classes on the service end as server-activated
types (aka well-known types) or client-activated types.
(RemotingConfiguration.RegisterWellKnownServiceType,
RemotingConfiguration.RegisterActivatedServiceType)
------
For client-activated types
RemotingConfiguration.ApplicationName = "RemotingService";
RemotingConfiguration.RegisterActivatedServiceType(
typeof(RemotingShared.ClientActivatedObject));
The name of the application (RemotingConfiguration.ApplicationName) is the
service name of the client-activated types. The clients can access this kind
of types through the URI tcp://server:6100/RemotingService.
------
For server-activated types
RemotingConfiguration.RegisterWellKnownServiceType(
typeof(RemotingShared.SingletonObject), // Server-activated type
"SingletonService", // objectUri
WellKnownObjectMode.Singleton); // Singleton mode
/////////////////////////////////////////////////////////////////////////////
References:
.NET Framework Remoting Architecture
http://msdn.microsoft.com/en-us/library/2e7z38xb(VS.85).aspx
.NET Framework Remoting Overview
http://msdn.microsoft.com/en-us/library/kwdt6w2k(VS.85).aspx
.NET Remoting
http://en.wikipedia.org/wiki/.NET_Remoting
/////////////////////////////////////////////////////////////////////////////