|
7 | 7 |
|
8 | 8 | This library is intended to make it easier for you to get started with and to use Datastore in your applications.
|
9 | 9 |
|
10 |
| -## 2.0 BETA 2 ## |
11 |
| - |
12 |
| -**Please note, this 2.0-series (dev-master) is in BETA and not suitable (yet) for production** |
13 |
| - |
14 |
| -The documentation is not yet fully representative of 2.x implementation. |
15 |
| - |
16 | 10 | ## Table of Contents ##
|
17 | 11 |
|
18 | 12 | - [Examples](#examples)
|
@@ -104,6 +98,7 @@ New features in 2.0 include
|
104 | 98 | * **Local development** - Using the Protocol Buffers allows us to access the development server Datastore
|
105 | 99 | * **Local GQL support** - By default, the local development server does not support GQL. I've included a basic GQL parser that makes this work.
|
106 | 100 | * **Data Migrations** - leverage multiple Gateways to ship data between local and live Datastore
|
| 101 | +* **Contention Exceptions** - standardised Exception for handling Datastore transaction contention` |
107 | 102 | * **Unit tests**
|
108 | 103 | * Optional drop-in JSON API Gateway for remote or non-AppEngine environments (this was the only Gateway in 1.x)
|
109 | 104 |
|
@@ -136,9 +131,13 @@ If you want to use the JSON API from remote or non-App Engine environments, you
|
136 | 131 |
|
137 | 132 | To install using Composer, use this require line, for production
|
138 | 133 |
|
| 134 | +`"tomwalder/php-gds": "v2.0.0"` |
| 135 | + |
| 136 | +For older, version 1 series |
| 137 | + |
139 | 138 | `"tomwalder/php-gds": "v1.2.1"`
|
140 | 139 |
|
141 |
| -and for bleeding-edge features, 2.0 dev-master |
| 140 | +and for bleeding-edge features, dev-master |
142 | 141 |
|
143 | 142 | `"tomwalder/php-gds": "dev-master"`
|
144 | 143 |
|
@@ -342,6 +341,8 @@ $obj_store->upsert($obj_entity);
|
342 | 341 | $obj_store->delete($obj_entity);
|
343 | 342 | ```
|
344 | 343 |
|
| 344 | +Watch out for `GDS\Exception\Contention` exceptions - they should be thrown by the library if you manage to hit Datastore contention locally in development or through the live Gateways. |
| 345 | + |
345 | 346 | ## Custom Entity Classes and Stores ##
|
346 | 347 |
|
347 | 348 | Whilst you can use the `GDS\Entity` and `GDS\Store` classes directly, as per the examples above, you may find it useful to extend one or the other.
|
|
0 commit comments