The Java™ client application
uses the eXtreme Scale EntityManager
API to insert data into the grid.
About this task
The previous sections described how to create an
eXtreme Scale data grid and configure
and start the
eXtreme Scale REST
data service. The Java client
application uses the
eXtreme Scale EntityManager
API to insert data into the grid. It does not demonstrate how to
use the REST interfaces. The purpose of this client is to demonstrate
how the EntityManager API is used to interact with the
eXtreme Scale data grid, and allow
modifying data in the grid. To view data in the grid using the REST
data service,
use a web browser or
use the Visual Studio 2008 client
application.
Procedure
To quickly add content
to the eXtreme Scale data grid,
run the
following command:
- Open a command-line or
terminal window and set the JAVA_HOME
environment variable:
![[Linux]](./icons/nglinux.gif)
export JAVA_HOME=java_home
set JAVA_HOME=java_home
- cd restservice_home/gettingstarted
- Insert some data into the grid. The data that is inserted
will be retrieved later using a Web browser and the REST data service.
If the data grid was started withouteXtreme Scale security, use the
following commands.
![[Unix]](./icons/ngunix.gif)
./runclient.sh load default
runclient.bat load default
If the data grid was started witheXtreme Scale security, use
the
following commands.
![[Unix]](./icons/ngunix.gif)
./runclient_secure.sh load
default
runclient_secure.bat load default
For a Java client, use
the following command syntax:![[Unix]](./icons/ngunix.gif)
runclient.sh command
runclient.bat command
The following commands are available:- load default
Loads a predefined
set of
Customer, Category and Product entities into the data grid and creates
a random set of Orders for each customer.
- load
category categoryId categoryName firstProductId num_products
Creates
a product Category and a fixed number of Product entities in the data
grid. The firstProductId parameter identifies the id number of the
the first product and each subsequent product is assigned the next
id until the specified number of products is created.
- load customer companyCode contactNamecompanyName numOrders firstOrderIdshipCity maxItems discountPct
Loads
a new Customer into the data grid and creates a fixed set of Order
entities for any random product currently loaded in the grid. The
number of Orders is determined by setting the <numOrders> parameter.
Each Order will have a random number of OrderDetail entities up to
<maxItems>
- display customer companyCode
Display
a Customer entity and the associated Order and OrderDetail entities.
- display category categoryId
Display
a product Category entity and the associated Product entities.
Results
- runclient.bat
load default
- runclient.bat load customer
IBM "John Doe" "IBM Corporation"
5 5000 Rochester 5 0.05
- runclient.bat
load category 5 "Household Items" 100
5
- runclient.bat display customer IBM
- runclient.bat display category 5
Running and building the sample data
grid and Java client with Eclipse
The
REST data service getting started sample can be updated and enhanced
using Eclipse. For details on how to setup your Eclipse environment
see the text document: restservice_home/gettingstarted/ECLIPSE_README.txt.
After
the WXSRestGettingStarted project is imported into Eclipse and is
building successfully, the sample will automatically re-compile and
the script files used to start the container server and client will
automatically pick up the class files and XML files. The REST data
service will also automatically detect any changes since the Web server
is configured to read the Eclipse build directories automatically.
Important: When changing source or configuration files, both
the eXtreme Scale container
server and the REST data service application must be restarted. The eXtreme Scale container server
must be started before the REST data service Web application.