WebSphere eXtreme Scale Administration Guide > Configure WebSphere eXtreme Scale

Configure a local eXtreme Scale configuration

A local in-memory eXtreme Scale configuration can be created by using an ObjectGrid descriptor XML file or eXtreme Scale APIs.

The following companyGrid.xml file is an example of an ObjectGrid descriptor XML. The first few lines of the file include the required header for each ObjectGrid XML file. The file defines an ObjectGrid instance named "CompanyGrid" and several BackingMaps named "Customer," "Item," "OrderLine," and "Order."

companyGrid.xml file
<?xml version="1.0" encoding="UTF-8"?>
<objectGridConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://ibm.com/ws/objectgrid/config ../objectGrid.xsd"
    xmlns="http://ibm.com/ws/objectgrid/config">

    <objectGrids>
        <objectGrid name="CompanyGrid">
            <backingMap name="Customer" />
            <backingMap name="Item" />
            <backingMap name="OrderLine" />
            <backingMap name="Order" />
        </objectGrid>
    </objectGrids>

</objectGridConfig>

Pass the XML file to one of the createObjectGrid methods in the ObjectGridManager interface. The following code sample validates the companyGrid.xml file against the XML schema, and creates the ObjectGrid instance named "CompanyGrid." The newly created ObjectGrid instance is not cached.

ObjectGridManager objectGridManager = ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid companyGrid = objectGridManager.createObjectGrid("CompanyGrid", 
    new URL("file:etc/test/companyGrid.xml"), true, false);

As an alternative, you can create ObjectGrid instances programmatically without any XML. For example, you can use the following code snippet in place of the previous XML and code.

ObjectGridManager objectGridManager = ObjectGridManagerFactory.getObjectGridManager();
ObjectGrid companyGrid = objectGridManager.createObjectGrid ("CompanyGrid", false);
BackingMap customerMap= companyGrid.defineMap("Customer");
BackingMap itemMap= companyGrid.defineMap("Item");
BackingMap orderLineMap= companyGrid.defineMap("OrderLine");
BackingMap orderMap = companyGrid.defineMap("Order");

For a complete description of the ObjectGrid XML file, see the eXtreme Scale configuration reference.

• ObjectGrid interface
  The following methods allow you to interact with an ObjectGrid instance.

• BackMap interface
  Each ObjectGrid instance contains a collection of BackingMap objects. Use the defineMap method or the createMap method of the ObjectGrid interface to name and add each BackingMap to an ObjectGrid instance. These methods return a BackingMap instance that is then used to define the behavior of an individual Map.

Parent topic

Configure WebSphere eXtreme Scale

Related tasks

Configure WebSphere eXtreme Scale

+

Search Tips   |   Advanced Search