========================================================================
    CONSOLE APPLICATION : VBRemotingClient 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.

VBRemotingClient is a .NET Remoting client end. It accesses the remote 
objects exposed by the .NET Remoting server end, VBRemotingServer.

There are generally two ways to create the .NET Remoting client: using a 
configuration file or writing codes. The RemotingClientByConfig method 
demonstrates the former, and the RemotingClientByCode method illustrates the 
latter method.


/////////////////////////////////////////////////////////////////////////////
Project Relation:

VBRemotingClient -> VBRemotingServer
VBRemotingClient is the client end of the VBRemotingServer server end.

VBRemotingClient -> CSRemotingSharedLibrary
VBRemotingClient references a shared library for the client-activated 
remoting types.

VBRemotingClient - CSRemotingClient
VBRemotingClient and CSRemotingClient are the same .NET Remoting client 
implemented in different .NET languages.


/////////////////////////////////////////////////////////////////////////////
Creation:

A. Adding remotable types on the client 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. Add the reference to the .NET class library shared by the .NET 
Remoting server. The class library exposes the client-activated type 
(ClientActivatedObject) that inherits MarshalByRefObject.

------
For server-activated types, they can be either defined in a shared assembly, 
or defined in the server end and have en empty proxy of the type in 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. Empty the root namespace of the VB.NET project.
VB.NET projects are special in that their root namespace setting is prefixed 
on all existing namespaces within the assembly at compile time. This offends 
the rule that the server type and the proxy type must have the same namespace
/class name, especially when the server is also a VB.NET project. In Visual 
Studio 2008, the only way of defining a type without the prefix of the root 
namespace is to empty the root namespace in the Project Property setting. 
Please note that doing this affects all existing namespaces within the 
assembly. If it is not wanted, you need to define the server-activated types 
in a shared assembly separately.

Step2. Add the proxy of the server-activated types (SingleCallObject, 
SingletonObject) that inherits MarshalByRefObject to the client project. 
There is no need to implement the body of the types.

B. Accessing .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">
				<clientProviders>
					<formatter ref="binary" />
				</clientProviders>
				<serverProviders>
					<formatter ref="binary" typeFilterLevel="Full" />
				</serverProviders>
			</channel>
		</channels>
	</application>
</system.runtime.remoting>

The above configuration registers a TCP channel whose formatter is binary on 
both server and client sides.

Step3. Register the remotable types.

------
For client-activated types

<system.runtime.remoting>
	<application>
		<client url="tcp://localhost:6100/RemotingService">
			<activated type="RemotingShared.ClientActivatedObject, CSRemotingSharedLibrary">
			</activated>
		</client>
	</application>
</system.runtime.remoting>

The url attribute in <client> is only required for client-activated types. It 
specifies the URL that will be used to locate the activator for the attribute.
"tcp://localhost:6100/RemotingService" corresponds to the application name of 
the server end (<application name="RemotingService">).

------
For server-activated types

<system.runtime.remoting>
	<application>
		<client>
			<wellknown type="RemotingShared.SingleCallObject, VBRemotingClient"
                   url="tcp://localhost:6100/SingleCallService">
			</wellknown>
			<wellknown type="RemotingShared.SingletonObject, VBRemotingClient"
					   url="tcp://localhost:6100/SingletonService">
			</wellknown>
		</client>
	</application>
</system.runtime.remoting>

Step4. Read the configuration file and configure the remoting infrastructure 
for the client end. (RemotingConfiguration.Configure)

Step5. Create the remotable object.

	' Create a SingleCall server-activated object
	Dim remoteObj As New SingleCallObject()

	' [-or-] a Singleton server-activated object
	Dim remoteObj As New SingletonObject()

	' [-or-] a client-activated object
	Dim remoteObj As New ClientActivatedObject()

Step6. Use the remotable object as if it were a local object. For example,

	Console.WriteLine(remoteObj.GetRemoteObjectType())

C. Accessing .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 according to the 
channel on the server end. (TcpChannel/HttpChannel/IpcChannel, 
ChannelServices.RegisterChannel)

Step3. Create the remotable object.

------
For client-activated types

	RemotingConfiguration.RegisterActivatedClientType( _
	GetType(ClientActivatedObject), "tcp://localhost:6100/RemotingService")
	Dim remoteObj As New ClientActivatedObject()

------
For server-activated types

	Dim remoteObj As SingletonObject = Activator.GetObject( _
	GetType(SingletonObject), "tcp://localhost:6100/SingletonService")

Step4. Use the remotable object as if it were a local object. For example,

	Console.WriteLine(remoteObj.GetRemoteObjectType())


/////////////////////////////////////////////////////////////////////////////
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


/////////////////////////////////////////////////////////////////////////////