View source for DataSnap.Basic DataSnap Client and Server Sample

This sample shows how to create a DataSnap Server and a DataSnap Client.

==Location==
You can find the '''Basic DataSnap Client and Server Sample''' sample project at:
* {{SamplesMenu}} and then navigate to '''Object Pascal\DataSnap\Basic'''.
* '''Subversion Repository:'''
** You can find Delphi code samples in {{CodeSamplesRepositories}}. Search by name into the samples repositories according to your RAD Studio version.
__TOC__

==Description==
The Basic DataSnap Client and Server application demonstrates: 
* How to create a DataSnap Server application.
* How to create a DataSnap Client application.

==How to Use the Sample==
There are three projects in subdirectories of the '''Basic''' directory:
* [[#Server Project| Server Project]]
* [[#Client Project| Client Project]]
* [[#DataSnap Server Methods Example Project| DataSnap Server Methods Example Project]]

===Server Project===
# Navigate to {{SamplesMenu}} and go to '''Object Pascal\DataSnap\Basic\Server'''.
# Open the '''DataSnapTestServer.dproj''' project.
# Build the '''DataSnapTestServer.dproj''' project.
# Run the application by clicking <font color="#598527">'''Run &gt; Run''' </font> in the IDE or by pressing '''F9'''.
# The Server's interface shows you an Event Log and an Active Connections chart. These auto-populate when the Client attempts to connect to the Server.

===Client Project===
# Navigate to {{SamplesMenu}} and go to '''Object Pascal\DataSnap\Basic\Client'''.
# Open the '''DataSnapTestClient.dproj''' project.
# Build the '''DataSnapTestClient.dproj''' project.
# Run the application by clicking <font color="#598527">'''Run &gt; Run''' </font> in the IDE or by pressing '''F9'''.
# The Client application enables you to test the server method class, the server method component, and the provider.

===DataSnap Server Methods Example Project===
This client application is a collection of '''dunit''' tests. These are not rigorous tests. They provide easy to read examples of how to use DataSnap features.

The server and client are included in this project. Normally these would be in separate projects and executed in separate processes. The client and server are combined into the same project and execute in the same process for the purpose of providing a simple example. Units that would normally execute in a server process have '''Server''' in their name. Units that would normally execute in a client process have '''Client''' in their name.

# Navigate to {{SamplesMenu}} and go to '''Object Pascal\DataSnap\Basic\Examples'''.
# Open the '''DataSnapExamples.dproj''' project inside the same project group as the Server.
# Build the '''DataSnapExamples.dproj''' project.
# Run the application by clicking <font color="#598527">'''Run &gt; Run''' </font> in the IDE or by pressing '''F9'''. Make sure you have the '''DataSnapExamples.dproj''' project selected in the Project Group.

==Files==
The files used by this sample are:
* [[#Server Files | Server Files]]
* [[#Client Files | Client Files]]
* [[#DataSnap Server Methods Example Files | DataSnap Server Methods Example Files]]

===Server Files===
{| border="1" frame="hsides" rules="rows" frame="hsides" rules="rows"
! ''' File '''
! ''' Contains '''
|-
| align="left" valign="top" |
'''DataSnapTestServer'''
| align="left" valign="top" |
The Basic DataSnap Server project.
|-
| align="left" valign="top" |
'''MethodsServerModule'''
| align="left" valign="top" |
The DataSnap Server module.
|-
| align="left" valign="top" |
'''ParametersServerModule'''
| align="left" valign="top" |
The parameters Server module.
|-
| align="left" valign="top" |
'''ProviderServerModule'''
| align="left" valign="top" |
The provider Server module.
|-
| align="left" valign="top" |
'''ServerContainerForm'''
| align="left" valign="top" |
The main form that is the user interface for the Basic DataSnap Server application.
|}

===Client Files===
{| border="1" frame="hsides" rules="rows" frame="hsides" rules="rows"
! ''' File '''
! ''' Contains '''
|-
| align="left" valign="top" |
'''ClientClasses'''
| align="left" valign="top" |
Client classes created by the DataSnap proxy generator.
|-
| align="left" valign="top" |
'''ClientForm'''
| align="left" valign="top" |
The main form that is the user interface for the Basic DataSnap Client application.
|-
| align="left" valign="top" |
'''DataSnapTestClient'''
| align="left" valign="top" |
The Basic DataSnap Client project.
|}

===DataSnap Server Methods Example Files===
{| border="1" frame="hsides" rules="rows" frame="hsides" rules="rows"
! ''' File '''
! ''' Contains '''
|-
| align="left" valign="top" |
'''This client is a collection of dunit tests.'''
| align="left" valign="top" |
Client classes created by the DataSnap proxy generator.
|-
| align="left" valign="top" |
'''ClientTestClasses'''
| align="left" valign="top" |
Client test classes created by the DataSnap proxy generator.
|-
| align="left" valign="top" |
'''DataSnapExamples'''
| align="left" valign="top" |
The Basic DataSnap Server Methods Example project.
|-
| align="left" valign="top" |
'''DataSnapTestData'''
| align="left" valign="top" |
Various methods and classes used in the testing process.
|-
| align="left" valign="top" |
'''TestServerContainer'''
| align="left" valign="top" |
The DataSnap server container.
|-
| align="left" valign="top" |
'''TestServerModule'''
| align="left" valign="top" |
The DataSnap server module.
|}

==Uses==
* [[lib_en:Data.DB|DB Unit]]
* [[lib_en:Data.SqlExpr|SqlExpr Unit]]
* [[lib_en:Data.DBXCommon|DBXCommon Unit]]

==See Also==
* [[rad_en:Developing DataSnap Applications|Developing DataSnap Applications]]
* [[rad_en:DataSnap Server Application|DataSnap Server Application]]
* [[rad_en:DataSnap Client Application|DataSnap Client Application]]
*[http://www.embarcadero.com/rad-in-action/delphi-labs Videos: Delphi Labs, by Paweł Głowacki]

[[Category:Delphi]]
[[Category:Sample]]