blob: 050f2494348de8a27abd4b45dc6f52eb6b3e3c33 [file] [log] [blame]
---
title: Creating a Proxy Client-Side Region
---
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
This section provides code examples for creating and customizing proxy client-side regions.
**Note:**
Creating a region through the client API creates only a proxy client-side region. A corresponding region with the same name and path should also exist on the servers that have been configured for client connections and upon which the client will perform its operations.
To create a region, you create a `RegionFactory` using the `RegionShortcut` that most closely fits your region configuration. From that, create your region, customizing the settings as region attributes as needed.
## Creating a CACHING\_PROXY Region
This example creates a region using a CACHING\_PROXY `RegionShortcut` with no further modifications:
``` pre
RegionFactoryPtr regionFactory =
cachePtr->createRegionFactory(CACHING_PROXY);
regionPtr = regionFactory ->create("exampleRegion");
```
## Creating a CACHING\_PROXY Region with LRU
This example creates a region based on the CACHING\_PROXY RegionShortcut with two additional region attributes settings. For information on the settings, see [Region Attributes Descriptions](../client-cache/region-attributes-desc.html#region-attributes-desc).
``` pre
RegionFactoryPtr regionFactory =
cachePtr->createRegionFactory(CACHING_PROXY);
regionPtr = regionFactory->setLruEntriesLimit( 20000 )
->setInitialCapacity( 20000 )
->create("exampleRegion");
```