appengine-sdk 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. data/COPYING +97 -0
  2. data/appengine-java-sdk-1.2.2/ABOUT +24 -0
  3. data/appengine-java-sdk-1.2.2/COPYING +97 -0
  4. data/appengine-java-sdk-1.2.2/README +98 -0
  5. data/appengine-java-sdk-1.2.2/config/sdk/logging.properties +24 -0
  6. data/appengine-java-sdk-1.2.2/config/user/ant-macros.xml +106 -0
  7. data/appengine-java-sdk-1.2.2/config/user/log4j.properties +24 -0
  8. data/appengine-java-sdk-1.2.2/config/user/logging.properties +28 -0
  9. data/appengine-java-sdk-1.2.2/docs/appengine-web.dtd +34 -0
  10. data/appengine-java-sdk-1.2.2/docs/appengine-web.xsd +85 -0
  11. data/appengine-java-sdk-1.2.2/docs/cron.dtd +7 -0
  12. data/appengine-java-sdk-1.2.2/docs/cron.xsd +20 -0
  13. data/appengine-java-sdk-1.2.2/docs/datastore-indexes.dtd +11 -0
  14. data/appengine-java-sdk-1.2.2/docs/datastore-indexes.xsd +40 -0
  15. data/appengine-java-sdk-1.2.2/docs/javadoc/allclasses-frame.html +163 -0
  16. data/appengine-java-sdk-1.2.2/docs/javadoc/allclasses-noframe.html +163 -0
  17. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Blob.html +341 -0
  18. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DataTypeTranslator.ComparableByteArray.html +308 -0
  19. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DataTypeTranslator.html +419 -0
  20. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DataTypeUtils.html +411 -0
  21. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreConfig.html +248 -0
  22. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreFailureException.html +262 -0
  23. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreNeedIndexException.html +245 -0
  24. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreService.html +787 -0
  25. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreServiceFactory.html +298 -0
  26. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/DatastoreTimeoutException.html +246 -0
  27. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Entity.html +805 -0
  28. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/EntityNotFoundException.html +271 -0
  29. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/EntityTranslator.html +241 -0
  30. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/FetchOptions.Builder.html +305 -0
  31. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/FetchOptions.html +382 -0
  32. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html +351 -0
  33. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Key.html +524 -0
  34. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/KeyFactory.Builder.html +410 -0
  35. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/KeyFactory.html +505 -0
  36. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Link.html +364 -0
  37. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/PreparedQuery.TooManyResultsException.html +247 -0
  38. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/PreparedQuery.html +410 -0
  39. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Query.FilterOperator.html +376 -0
  40. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Query.FilterPredicate.html +373 -0
  41. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Query.SortDirection.html +327 -0
  42. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Query.SortPredicate.html +338 -0
  43. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Query.html +702 -0
  44. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/ShortBlob.html +365 -0
  45. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Text.html +344 -0
  46. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/Transaction.html +287 -0
  47. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/package-frame.html +117 -0
  48. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/package-summary.html +405 -0
  49. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/datastore/package-tree.html +183 -0
  50. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/Composite.Anchor.html +441 -0
  51. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/Composite.html +243 -0
  52. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/CompositeTransform.html +252 -0
  53. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/Image.Format.html +391 -0
  54. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/Image.html +345 -0
  55. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/ImagesService.OutputEncoding.html +327 -0
  56. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/ImagesService.html +452 -0
  57. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/ImagesServiceFactory.html +534 -0
  58. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/ImagesServiceFailureException.html +248 -0
  59. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/Transform.html +234 -0
  60. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/package-frame.html +77 -0
  61. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/package-summary.html +257 -0
  62. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/images/package-tree.html +178 -0
  63. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/MailService.Attachment.html +291 -0
  64. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/MailService.Message.html +763 -0
  65. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/MailService.html +280 -0
  66. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/MailServiceFactory.html +257 -0
  67. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/package-frame.html +47 -0
  68. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/package-summary.html +224 -0
  69. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/mail/package-tree.html +156 -0
  70. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/ErrorHandler.html +251 -0
  71. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/Expiration.html +347 -0
  72. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/InvalidValueException.html +264 -0
  73. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/LogAndContinueErrorHandler.html +297 -0
  74. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/MemcacheService.SetPolicy.html +351 -0
  75. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/MemcacheService.html +808 -0
  76. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/MemcacheServiceException.html +262 -0
  77. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/MemcacheServiceFactory.html +231 -0
  78. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/Stats.html +319 -0
  79. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/StrictErrorHandler.html +291 -0
  80. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/package-frame.html +77 -0
  81. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/package-summary.html +271 -0
  82. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/memcache/package-tree.html +175 -0
  83. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/FetchOptions.Builder.html +305 -0
  84. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/FetchOptions.html +414 -0
  85. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/HTTPHeader.html +292 -0
  86. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/HTTPMethod.html +373 -0
  87. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/HTTPRequest.html +490 -0
  88. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/HTTPResponse.html +286 -0
  89. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/ResponseTooLargeException.html +244 -0
  90. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/URLFetchService.html +260 -0
  91. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/URLFetchServiceFactory.html +250 -0
  92. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/package-frame.html +75 -0
  93. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/package-summary.html +251 -0
  94. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/urlfetch/package-tree.html +177 -0
  95. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/User.html +411 -0
  96. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/UserService.html +318 -0
  97. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/UserServiceFactory.html +223 -0
  98. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/UserServiceFailureException.html +244 -0
  99. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/package-frame.html +56 -0
  100. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/package-summary.html +239 -0
  101. data/appengine-java-sdk-1.2.2/docs/javadoc/com/google/appengine/api/users/package-tree.html +164 -0
  102. data/appengine-java-sdk-1.2.2/docs/javadoc/constant-values.html +274 -0
  103. data/appengine-java-sdk-1.2.2/docs/javadoc/deprecated-list.html +159 -0
  104. data/appengine-java-sdk-1.2.2/docs/javadoc/dev_javadoc.css +109 -0
  105. data/appengine-java-sdk-1.2.2/docs/javadoc/help-doc.html +217 -0
  106. data/appengine-java-sdk-1.2.2/docs/javadoc/index-all.html +1413 -0
  107. data/appengine-java-sdk-1.2.2/docs/javadoc/index.html +39 -0
  108. data/appengine-java-sdk-1.2.2/docs/javadoc/overview-frame.html +52 -0
  109. data/appengine-java-sdk-1.2.2/docs/javadoc/overview-summary.html +179 -0
  110. data/appengine-java-sdk-1.2.2/docs/javadoc/overview-tree.html +194 -0
  111. data/appengine-java-sdk-1.2.2/docs/javadoc/package-list +6 -0
  112. data/appengine-java-sdk-1.2.2/docs/javadoc/resources/inherit.gif +0 -0
  113. data/appengine-java-sdk-1.2.2/docs/javadoc/serialized-form.html +958 -0
  114. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/allclasses-frame.html +97 -0
  115. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/allclasses-noframe.html +97 -0
  116. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/KickStart.html +258 -0
  117. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AdminException.html +263 -0
  118. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AppAdmin.LogSeverity.html +375 -0
  119. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AppAdmin.html +380 -0
  120. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AppAdminFactory.ConnectOptions.html +627 -0
  121. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AppAdminFactory.PasswordPrompt.html +211 -0
  122. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/AppAdminFactory.html +434 -0
  123. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/Application.html +493 -0
  124. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/UpdateFailureEvent.html +269 -0
  125. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/UpdateListener.html +254 -0
  126. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/UpdateProgressEvent.html +272 -0
  127. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/UpdateSuccessEvent.html +226 -0
  128. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/package-frame.html +79 -0
  129. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/package-summary.html +227 -0
  130. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/admin/package-tree.html +173 -0
  131. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/AbstractContainerService.html +497 -0
  132. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocal.html +285 -0
  133. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocalFactory.html +307 -0
  134. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/ApiProxyLocalImpl.html +370 -0
  135. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/ContainerService.EnvironmentVariableMismatchSeverity.html +327 -0
  136. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/ContainerService.html +437 -0
  137. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/DevAppServer.html +459 -0
  138. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/DevAppServerFactory.html +262 -0
  139. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/DevAppServerMain.html +300 -0
  140. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/gwt/AppEngineLauncher.html +262 -0
  141. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/gwt/package-frame.html +32 -0
  142. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/gwt/package-summary.html +155 -0
  143. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/gwt/package-tree.html +153 -0
  144. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/package-frame.html +66 -0
  145. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/package-summary.html +214 -0
  146. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/development/package-tree.html +168 -0
  147. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/Enhance.html +268 -0
  148. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/Enhancer.html +298 -0
  149. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/EnhancerTask.html +505 -0
  150. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/package-frame.html +36 -0
  151. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/package-summary.html +163 -0
  152. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/enhancer/package-tree.html +153 -0
  153. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/LocalVersionFactory.html +256 -0
  154. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/RemoteVersionFactory.html +266 -0
  155. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/SdkInfo.html +419 -0
  156. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/SupportInfo.html +225 -0
  157. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/UpdateCheck.html +349 -0
  158. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/UpdateCheckResults.VersionComparator.html +281 -0
  159. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/UpdateCheckResults.html +374 -0
  160. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/Version.html +329 -0
  161. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/package-frame.html +46 -0
  162. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/package-summary.html +195 -0
  163. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/info/package-tree.html +152 -0
  164. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/package-frame.html +32 -0
  165. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/package-summary.html +155 -0
  166. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/package-tree.html +151 -0
  167. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/util/ApiVersionFinder.html +302 -0
  168. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/util/package-frame.html +32 -0
  169. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/util/package-summary.html +156 -0
  170. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/com/google/appengine/tools/util/package-tree.html +151 -0
  171. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/constant-values.html +196 -0
  172. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/deprecated-list.html +144 -0
  173. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/dev_javadoc.css +109 -0
  174. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/help-doc.html +217 -0
  175. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/index-all.html +784 -0
  176. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/index.html +39 -0
  177. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/overview-frame.html +54 -0
  178. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/overview-summary.html +173 -0
  179. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/overview-tree.html +179 -0
  180. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/package-list +7 -0
  181. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/resources/inherit.gif +0 -0
  182. data/appengine-java-sdk-1.2.2/docs/tools/javadoc/serialized-form.html +461 -0
  183. data/appengine-java-sdk-1.2.2/lib/appengine-tools-api.jar +0 -0
  184. data/appengine-java-sdk-1.2.2/lib/impl/appengine-api-stubs.jar +0 -0
  185. data/appengine-java-sdk-1.2.2/lib/impl/appengine-api.jar +0 -0
  186. data/appengine-java-sdk-1.2.2/lib/impl/appengine-local-runtime.jar +0 -0
  187. data/appengine-java-sdk-1.2.2/lib/shared/appengine-local-runtime-shared.jar +0 -0
  188. data/appengine-java-sdk-1.2.2/lib/shared/geronimo-el_1.0_spec-1.0.1.jar +0 -0
  189. data/appengine-java-sdk-1.2.2/lib/shared/geronimo-jsp_2.1_spec-1.0.1.jar +0 -0
  190. data/appengine-java-sdk-1.2.2/lib/shared/geronimo-servlet_2.5_spec-1.2.jar +0 -0
  191. data/appengine-java-sdk-1.2.2/lib/shared/jsp/LICENSE +203 -0
  192. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-ant-1.6.5.jar +0 -0
  193. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-ant-launcher-1.6.5.jar +0 -0
  194. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-commons-el-1.0.jar +0 -0
  195. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-commons-logging-1.1.1.jar +0 -0
  196. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-jasper-compiler-5.0.28.jar +0 -0
  197. data/appengine-java-sdk-1.2.2/lib/shared/jsp/repackaged-appengine-jasper-runtime-5.0.28.jar +0 -0
  198. data/appengine-java-sdk-1.2.2/lib/tools/jsp/LICENSE +203 -0
  199. data/appengine-java-sdk-1.2.2/lib/tools/jsp/repackaged-appengine-jakarta-jstl-1.1.2.jar +0 -0
  200. data/appengine-java-sdk-1.2.2/lib/tools/jsp/repackaged-appengine-jakarta-standard-1.1.2.jar +0 -0
  201. data/appengine-java-sdk-1.2.2/lib/user/appengine-api-1.0-sdk-1.2.2.jar +0 -0
  202. data/lib/appengine-sdk.rb +96 -0
  203. metadata +256 -0
@@ -0,0 +1,351 @@
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
+ <!--NewPage-->
3
+ <HTML>
4
+ <HEAD>
5
+ <!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:56 CDT 2009 -->
6
+ <TITLE>
7
+ ImplicitTransactionManagementPolicy
8
+ </TITLE>
9
+
10
+ <META NAME="date" CONTENT="2009-07-12">
11
+
12
+ <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">
13
+
14
+ <SCRIPT type="text/javascript">
15
+ function windowTitle()
16
+ {
17
+ if (location.href.indexOf('is-external=true') == -1) {
18
+ parent.document.title="ImplicitTransactionManagementPolicy";
19
+ }
20
+ }
21
+ </SCRIPT>
22
+ <NOSCRIPT>
23
+ </NOSCRIPT>
24
+
25
+ </HEAD>
26
+
27
+ <BODY BGCOLOR="white" onload="windowTitle();">
28
+ <HR>
29
+
30
+
31
+ <!-- ========= START OF TOP NAVBAR ======= -->
32
+ <A NAME="navbar_top"><!-- --></A>
33
+ <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
34
+ <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
35
+ <TR>
36
+ <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
37
+ <A NAME="navbar_top_firstrow"><!-- --></A>
38
+ <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
39
+ <TR ALIGN="center" VALIGN="top">
40
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
41
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
42
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
43
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
44
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
45
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
46
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
47
+ </TR>
48
+ </TABLE>
49
+ </TD>
50
+ <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
51
+ </EM>
52
+ </TD>
53
+ </TR>
54
+
55
+ <TR>
56
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/FetchOptions.Builder.html" title="class in com.google.appengine.api.datastore"><B>PREV CLASS</B></A>&nbsp;
58
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore"><B>NEXT CLASS</B></A></FONT></TD>
59
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
60
+ <A HREF="../../../../../index.html?com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" target="_top"><B>FRAMES</B></A> &nbsp;
61
+ &nbsp;<A HREF="ImplicitTransactionManagementPolicy.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
62
+ &nbsp;<SCRIPT type="text/javascript">
63
+ <!--
64
+ if(window==top) {
65
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
66
+ }
67
+ //-->
68
+ </SCRIPT>
69
+ <NOSCRIPT>
70
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
71
+ </NOSCRIPT>
72
+
73
+
74
+ </FONT></TD>
75
+ </TR>
76
+ <TR>
77
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
78
+ SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#enum_constant_summary">ENUM CONSTANTS</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
79
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
80
+ DETAIL:&nbsp;<A HREF="#enum_constant_detail">ENUM CONSTANTS</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
81
+ </TR>
82
+ </TABLE>
83
+ <A NAME="skip-navbar_top"></A>
84
+ <!-- ========= END OF TOP NAVBAR ========= -->
85
+
86
+ <HR>
87
+ <!-- ======== START OF CLASS DATA ======== -->
88
+ <H2>
89
+ <FONT SIZE="-1">
90
+ com.google.appengine.api.datastore</FONT>
91
+ <BR>
92
+ Enum ImplicitTransactionManagementPolicy</H2>
93
+ <PRE>
94
+ java.lang.Object
95
+ <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by ">java.lang.Enum&lt;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A>&gt;
96
+ <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>com.google.appengine.api.datastore.ImplicitTransactionManagementPolicy</B>
97
+ </PRE>
98
+ <DL>
99
+ <DT><B>All Implemented Interfaces:</B> <DD>java.io.Serializable, java.lang.Comparable&lt;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A>&gt;</DD>
100
+ </DL>
101
+ <HR>
102
+ <DL>
103
+ <DT><PRE>public enum <B>ImplicitTransactionManagementPolicy</B><DT>extends java.lang.Enum&lt;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A>&gt;</DL>
104
+ </PRE>
105
+
106
+ <P>
107
+ Describes the various policies the datastore can follow for implicit
108
+ transaction management. When deciding which policy to use, keep the
109
+ following in mind: The datastore will automatically retry operations
110
+ that fail due to concurrent updates to the same entity group if the
111
+ operation is not part of a transaction. The datastore will not retry
112
+ operations that fail due to concurrent updates to the same entity group
113
+ if the operation is part of a transaction, and will instead immediately
114
+ throw a <CODE>ConcurrentModificationException</CODE>. If your application
115
+ needs to perform any sort of intelligent merging when concurrent attempts
116
+ are made to update the same entity group you probably want <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#AUTO"><CODE>AUTO</CODE></A>,
117
+ otherwise <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#NONE"><CODE>NONE</CODE></A> is probably acceptable.
118
+
119
+ See <A HREF="../../../../../com/google/appengine/api/datastore/DatastoreService.html" title="interface in com.google.appengine.api.datastore"><CODE>DatastoreService</CODE></A> for a list of operations that perform implicit
120
+ transaction management.
121
+ <P>
122
+
123
+ <P>
124
+ <HR>
125
+
126
+ <P>
127
+ <!-- =========== ENUM CONSTANT SUMMARY =========== -->
128
+
129
+ <A NAME="enum_constant_summary"><!-- --></A>
130
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
131
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
132
+ <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
133
+ <B>Enum Constant Summary</B></FONT></TH>
134
+ </TR>
135
+ <TR BGCOLOR="white" CLASS="TableRowColor">
136
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#AUTO">AUTO</A></B></CODE>
137
+
138
+ <BR>
139
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If a current transaction exists, use it, otherwise create one.</TD>
140
+ </TR>
141
+ <TR BGCOLOR="white" CLASS="TableRowColor">
142
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#NONE">NONE</A></B></CODE>
143
+
144
+ <BR>
145
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If a current transaction exists, use it, otherwise execute without a
146
+ transaction.</TD>
147
+ </TR>
148
+ </TABLE>
149
+ &nbsp;
150
+ <!-- ========== METHOD SUMMARY =========== -->
151
+
152
+ <A NAME="method_summary"><!-- --></A>
153
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
154
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
155
+ <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
156
+ <B>Method Summary</B></FONT></TH>
157
+ </TR>
158
+ <TR BGCOLOR="white" CLASS="TableRowColor">
159
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
160
+ <CODE>static&nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A></CODE></FONT></TD>
161
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#valueOf(java.lang.String)">valueOf</A></B>(java.lang.String&nbsp;name)</CODE>
162
+
163
+ <BR>
164
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the enum constant of this type with the specified name.</TD>
165
+ </TR>
166
+ <TR BGCOLOR="white" CLASS="TableRowColor">
167
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
168
+ <CODE>static&nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A>[]</CODE></FONT></TD>
169
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html#values()">values</A></B>()</CODE>
170
+
171
+ <BR>
172
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns an array containing the constants of this enum type, in
173
+ the order they are declared.</TD>
174
+ </TR>
175
+ </TABLE>
176
+ &nbsp;<A NAME="methods_inherited_from_class_java.lang.Enum"><!-- --></A>
177
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
178
+ <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
179
+ <TH ALIGN="left"><B>Methods inherited from class java.lang.Enum</B></TH>
180
+ </TR>
181
+ <TR BGCOLOR="white" CLASS="TableRowColor">
182
+ <TD><CODE>compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf</CODE></TD>
183
+ </TR>
184
+ </TABLE>
185
+ &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
186
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
187
+ <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
188
+ <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
189
+ </TR>
190
+ <TR BGCOLOR="white" CLASS="TableRowColor">
191
+ <TD><CODE>getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
192
+ </TR>
193
+ </TABLE>
194
+ &nbsp;
195
+ <P>
196
+
197
+ <!-- ============ ENUM CONSTANT DETAIL =========== -->
198
+
199
+ <A NAME="enum_constant_detail"><!-- --></A>
200
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
201
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
202
+ <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
203
+ <B>Enum Constant Detail</B></FONT></TH>
204
+ </TR>
205
+ </TABLE>
206
+
207
+ <A NAME="NONE"><!-- --></A><H3>
208
+ NONE</H3>
209
+ <PRE>
210
+ public static final <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A> <B>NONE</B></PRE>
211
+ <DL>
212
+ <DD>If a current transaction exists, use it, otherwise execute without a
213
+ transaction.
214
+ <P>
215
+ <DL>
216
+ </DL>
217
+ </DL>
218
+ <HR>
219
+
220
+ <A NAME="AUTO"><!-- --></A><H3>
221
+ AUTO</H3>
222
+ <PRE>
223
+ public static final <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A> <B>AUTO</B></PRE>
224
+ <DL>
225
+ <DD>If a current transaction exists, use it, otherwise create one.
226
+ The transaction will be committed before the method returns if the
227
+ datastore operation completes successfully and rolled back if the
228
+ datastore operation does not complete successfully. No matter the type
229
+ or quantity of entities provided, only one transaction will be created.
230
+ This means that if you pass entities that belong to multiple entity groups
231
+ into one of these methods and you have this policy enabled, you will
232
+ receive an exception because transactions do not function across entity
233
+ groups.
234
+ <P>
235
+ <DL>
236
+ </DL>
237
+ </DL>
238
+
239
+ <!-- ============ METHOD DETAIL ========== -->
240
+
241
+ <A NAME="method_detail"><!-- --></A>
242
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
243
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
244
+ <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
245
+ <B>Method Detail</B></FONT></TH>
246
+ </TR>
247
+ </TABLE>
248
+
249
+ <A NAME="values()"><!-- --></A><H3>
250
+ values</H3>
251
+ <PRE>
252
+ public static <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A>[] <B>values</B>()</PRE>
253
+ <DL>
254
+ <DD>Returns an array containing the constants of this enum type, in
255
+ the order they are declared. This method may be used to iterate
256
+ over the constants as follows:
257
+ <pre>
258
+ for (ImplicitTransactionManagementPolicy c : ImplicitTransactionManagementPolicy.values())
259
+ &nbsp; System.out.println(c);
260
+ </pre>
261
+ <P>
262
+ <DD><DL>
263
+
264
+ <DT><B>Returns:</B><DD>an array containing the constants of this enum type, in
265
+ the order they are declared</DL>
266
+ </DD>
267
+ </DL>
268
+ <HR>
269
+
270
+ <A NAME="valueOf(java.lang.String)"><!-- --></A><H3>
271
+ valueOf</H3>
272
+ <PRE>
273
+ public static <A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore">ImplicitTransactionManagementPolicy</A> <B>valueOf</B>(java.lang.String&nbsp;name)</PRE>
274
+ <DL>
275
+ <DD>Returns the enum constant of this type with the specified name.
276
+ The string must match <I>exactly</I> an identifier used to declare an
277
+ enum constant in this type. (Extraneous whitespace characters are
278
+ not permitted.)
279
+ <P>
280
+ <DD><DL>
281
+ <DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of the enum constant to be returned.
282
+ <DT><B>Returns:</B><DD>the enum constant with the specified name
283
+ <DT><B>Throws:</B>
284
+ <DD><CODE>java.lang.IllegalArgumentException</CODE> - if this enum type has no constant
285
+ with the specified name
286
+ <DD><CODE>java.lang.NullPointerException</CODE> - if the argument is null</DL>
287
+ </DD>
288
+ </DL>
289
+ <!-- ========= END OF CLASS DATA ========= -->
290
+ <HR>
291
+
292
+
293
+ <!-- ======= START OF BOTTOM NAVBAR ====== -->
294
+ <A NAME="navbar_bottom"><!-- --></A>
295
+ <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
296
+ <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
297
+ <TR>
298
+ <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
299
+ <A NAME="navbar_bottom_firstrow"><!-- --></A>
300
+ <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
301
+ <TR ALIGN="center" VALIGN="top">
302
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
303
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
304
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
305
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
306
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
307
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
308
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
309
+ </TR>
310
+ </TABLE>
311
+ </TD>
312
+ <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
313
+ </EM>
314
+ </TD>
315
+ </TR>
316
+
317
+ <TR>
318
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
319
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/FetchOptions.Builder.html" title="class in com.google.appengine.api.datastore"><B>PREV CLASS</B></A>&nbsp;
320
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore"><B>NEXT CLASS</B></A></FONT></TD>
321
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
322
+ <A HREF="../../../../../index.html?com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" target="_top"><B>FRAMES</B></A> &nbsp;
323
+ &nbsp;<A HREF="ImplicitTransactionManagementPolicy.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
324
+ &nbsp;<SCRIPT type="text/javascript">
325
+ <!--
326
+ if(window==top) {
327
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
328
+ }
329
+ //-->
330
+ </SCRIPT>
331
+ <NOSCRIPT>
332
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
333
+ </NOSCRIPT>
334
+
335
+
336
+ </FONT></TD>
337
+ </TR>
338
+ <TR>
339
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
340
+ SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#enum_constant_summary">ENUM CONSTANTS</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
341
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
342
+ DETAIL:&nbsp;<A HREF="#enum_constant_detail">ENUM CONSTANTS</A>&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
343
+ </TR>
344
+ </TABLE>
345
+ <A NAME="skip-navbar_bottom"></A>
346
+ <!-- ======== END OF BOTTOM NAVBAR ======= -->
347
+
348
+ <HR>
349
+
350
+ </BODY>
351
+ </HTML>
@@ -0,0 +1,524 @@
1
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
+ <!--NewPage-->
3
+ <HTML>
4
+ <HEAD>
5
+ <!-- Generated by javadoc (build 1.6.0-google-internal) on Sun Jul 12 08:39:56 CDT 2009 -->
6
+ <TITLE>
7
+ Key
8
+ </TITLE>
9
+
10
+ <META NAME="date" CONTENT="2009-07-12">
11
+
12
+ <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../dev_javadoc.css" TITLE="Style">
13
+
14
+ <SCRIPT type="text/javascript">
15
+ function windowTitle()
16
+ {
17
+ if (location.href.indexOf('is-external=true') == -1) {
18
+ parent.document.title="Key";
19
+ }
20
+ }
21
+ </SCRIPT>
22
+ <NOSCRIPT>
23
+ </NOSCRIPT>
24
+
25
+ </HEAD>
26
+
27
+ <BODY BGCOLOR="white" onload="windowTitle();">
28
+ <HR>
29
+
30
+
31
+ <!-- ========= START OF TOP NAVBAR ======= -->
32
+ <A NAME="navbar_top"><!-- --></A>
33
+ <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
34
+ <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
35
+ <TR>
36
+ <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
37
+ <A NAME="navbar_top_firstrow"><!-- --></A>
38
+ <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
39
+ <TR ALIGN="center" VALIGN="top">
40
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
41
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
42
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
43
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
44
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
45
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
46
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
47
+ </TR>
48
+ </TABLE>
49
+ </TD>
50
+ <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
51
+ </EM>
52
+ </TD>
53
+ </TR>
54
+
55
+ <TR>
56
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore"><B>PREV CLASS</B></A>&nbsp;
58
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/KeyFactory.html" title="class in com.google.appengine.api.datastore"><B>NEXT CLASS</B></A></FONT></TD>
59
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
60
+ <A HREF="../../../../../index.html?com/google/appengine/api/datastore/Key.html" target="_top"><B>FRAMES</B></A> &nbsp;
61
+ &nbsp;<A HREF="Key.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
62
+ &nbsp;<SCRIPT type="text/javascript">
63
+ <!--
64
+ if(window==top) {
65
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
66
+ }
67
+ //-->
68
+ </SCRIPT>
69
+ <NOSCRIPT>
70
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
71
+ </NOSCRIPT>
72
+
73
+
74
+ </FONT></TD>
75
+ </TR>
76
+ <TR>
77
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
78
+ SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
79
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
80
+ DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
81
+ </TR>
82
+ </TABLE>
83
+ <A NAME="skip-navbar_top"></A>
84
+ <!-- ========= END OF TOP NAVBAR ========= -->
85
+
86
+ <HR>
87
+ <!-- ======== START OF CLASS DATA ======== -->
88
+ <H2>
89
+ <FONT SIZE="-1">
90
+ com.google.appengine.api.datastore</FONT>
91
+ <BR>
92
+ Class Key</H2>
93
+ <PRE>
94
+ java.lang.Object
95
+ <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by "><B>com.google.appengine.api.datastore.Key</B>
96
+ </PRE>
97
+ <DL>
98
+ <DT><B>All Implemented Interfaces:</B> <DD>java.io.Serializable, java.lang.Comparable&lt;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A>&gt;</DD>
99
+ </DL>
100
+ <HR>
101
+ <DL>
102
+ <DT><PRE>public final class <B>Key</B><DT>extends java.lang.Object<DT>implements java.io.Serializable, java.lang.Comparable&lt;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A>&gt;</DL>
103
+ </PRE>
104
+
105
+ <P>
106
+ The primary key for a datastore entity.
107
+
108
+ A datastore GUID. A Key instance uniquely identifies an entity
109
+ across all apps, and includes all information necessary to fetch
110
+ the entity from the datastore with <code>DatastoreService.get(Key)</code>.
111
+ <p>
112
+ You can create <code>Key</code> objects directly by using <A HREF="../../../../../com/google/appengine/api/datastore/KeyFactory.html#createKey(java.lang.String, long)"><CODE>KeyFactory.createKey(java.lang.String, long)</CODE></A> or <A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getChild(java.lang.String, long)"><CODE>getChild(java.lang.String, long)</CODE></A>.
113
+ <p>
114
+ You can also retrieve the <code>Key</code> automatically created when you
115
+ create a new <A HREF="../../../../../com/google/appengine/api/datastore/Entity.html" title="class in com.google.appengine.api.datastore"><CODE>Entity</CODE></A>, or serialize <code>Key</code> objects, or
116
+ use <A HREF="../../../../../com/google/appengine/api/datastore/KeyFactory.html" title="class in com.google.appengine.api.datastore"><CODE>KeyFactory</CODE></A> to convert them to and from websafe String
117
+ values.
118
+
119
+ <p>
120
+ TODO(schwardo): Disable serialization if !isComplete().
121
+ TODO(maxr): Reconsider storing a full-fledged Key as the parent.
122
+ appId actually only appears once inside each Key so having one
123
+ appId member per path component is misleading.
124
+ <P>
125
+
126
+ <P>
127
+ <DL>
128
+ <DT><B>See Also:</B><DD><A HREF="../../../../../com/google/appengine/api/datastore/KeyFactory.html" title="class in com.google.appengine.api.datastore"><CODE>KeyFactory</CODE></A>,
129
+ <A HREF="../../../../../serialized-form.html#com.google.appengine.api.datastore.Key">Serialized Form</A></DL>
130
+ <HR>
131
+
132
+ <P>
133
+
134
+ <!-- ========== METHOD SUMMARY =========== -->
135
+
136
+ <A NAME="method_summary"><!-- --></A>
137
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
138
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
139
+ <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
140
+ <B>Method Summary</B></FONT></TH>
141
+ </TR>
142
+ <TR BGCOLOR="white" CLASS="TableRowColor">
143
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
144
+ <CODE>&nbsp;int</CODE></FONT></TD>
145
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#compareTo(com.google.appengine.api.datastore.Key)">compareTo</A></B>(<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A>&nbsp;other)</CODE>
146
+
147
+ <BR>
148
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares two <code>Key</code> objects.</TD>
149
+ </TR>
150
+ <TR BGCOLOR="white" CLASS="TableRowColor">
151
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
152
+ <CODE>&nbsp;boolean</CODE></FONT></TD>
153
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#equals(java.lang.Object)">equals</A></B>(java.lang.Object&nbsp;object)</CODE>
154
+
155
+ <BR>
156
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Compares two <code>Key</code> objects by comparing ids, kinds, parent
157
+ and appIdNamespace.</TD>
158
+ </TR>
159
+ <TR BGCOLOR="white" CLASS="TableRowColor">
160
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
161
+ <CODE>&nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A></CODE></FONT></TD>
162
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getChild(java.lang.String, long)">getChild</A></B>(java.lang.String&nbsp;kind,
163
+ long&nbsp;id)</CODE>
164
+
165
+ <BR>
166
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new key having <code>this</code> as parent and the given numeric
167
+ identifier.</TD>
168
+ </TR>
169
+ <TR BGCOLOR="white" CLASS="TableRowColor">
170
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
171
+ <CODE>&nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A></CODE></FONT></TD>
172
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getChild(java.lang.String, java.lang.String)">getChild</A></B>(java.lang.String&nbsp;kind,
173
+ java.lang.String&nbsp;name)</CODE>
174
+
175
+ <BR>
176
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new key having <code>this</code> as parent and the given name.</TD>
177
+ </TR>
178
+ <TR BGCOLOR="white" CLASS="TableRowColor">
179
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
180
+ <CODE>&nbsp;long</CODE></FONT></TD>
181
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getId()">getId</A></B>()</CODE>
182
+
183
+ <BR>
184
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the numeric identifier of this <code>Key</code>.</TD>
185
+ </TR>
186
+ <TR BGCOLOR="white" CLASS="TableRowColor">
187
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
188
+ <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
189
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getKind()">getKind</A></B>()</CODE>
190
+
191
+ <BR>
192
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the kind of the <code>Entity</code> represented by this <code>Key</code>.</TD>
193
+ </TR>
194
+ <TR BGCOLOR="white" CLASS="TableRowColor">
195
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
196
+ <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
197
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getName()">getName</A></B>()</CODE>
198
+
199
+ <BR>
200
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
201
+ </TR>
202
+ <TR BGCOLOR="white" CLASS="TableRowColor">
203
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
204
+ <CODE>&nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A></CODE></FONT></TD>
205
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#getParent()">getParent</A></B>()</CODE>
206
+
207
+ <BR>
208
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If this <code>Key</code> has a parent, return a <code>Key</code> that
209
+ represents it.</TD>
210
+ </TR>
211
+ <TR BGCOLOR="white" CLASS="TableRowColor">
212
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
213
+ <CODE>&nbsp;int</CODE></FONT></TD>
214
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#hashCode()">hashCode</A></B>()</CODE>
215
+
216
+ <BR>
217
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
218
+ </TR>
219
+ <TR BGCOLOR="white" CLASS="TableRowColor">
220
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
221
+ <CODE>&nbsp;boolean</CODE></FONT></TD>
222
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#isComplete()">isComplete</A></B>()</CODE>
223
+
224
+ <BR>
225
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns true if this Key has a name specified or has been assigned an identifier.</TD>
226
+ </TR>
227
+ <TR BGCOLOR="white" CLASS="TableRowColor">
228
+ <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
229
+ <CODE>&nbsp;java.lang.String</CODE></FONT></TD>
230
+ <TD><CODE><B><A HREF="../../../../../com/google/appengine/api/datastore/Key.html#toString()">toString</A></B>()</CODE>
231
+
232
+ <BR>
233
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</TD>
234
+ </TR>
235
+ </TABLE>
236
+ &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
237
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
238
+ <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
239
+ <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH>
240
+ </TR>
241
+ <TR BGCOLOR="white" CLASS="TableRowColor">
242
+ <TD><CODE>getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
243
+ </TR>
244
+ </TABLE>
245
+ &nbsp;
246
+ <P>
247
+
248
+ <!-- ============ METHOD DETAIL ========== -->
249
+
250
+ <A NAME="method_detail"><!-- --></A>
251
+ <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
252
+ <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
253
+ <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
254
+ <B>Method Detail</B></FONT></TH>
255
+ </TR>
256
+ </TABLE>
257
+
258
+ <A NAME="getKind()"><!-- --></A><H3>
259
+ getKind</H3>
260
+ <PRE>
261
+ public java.lang.String <B>getKind</B>()</PRE>
262
+ <DL>
263
+ <DD>Returns the kind of the <code>Entity</code> represented by this <code>Key</code>.
264
+ <P>
265
+ <DD><DL>
266
+ </DL>
267
+ </DD>
268
+ <DD><DL>
269
+ </DL>
270
+ </DD>
271
+ </DL>
272
+ <HR>
273
+
274
+ <A NAME="getParent()"><!-- --></A><H3>
275
+ getParent</H3>
276
+ <PRE>
277
+ public <A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A> <B>getParent</B>()</PRE>
278
+ <DL>
279
+ <DD>If this <code>Key</code> has a parent, return a <code>Key</code> that
280
+ represents it. If not, simply return null.
281
+ <P>
282
+ <DD><DL>
283
+ </DL>
284
+ </DD>
285
+ <DD><DL>
286
+ </DL>
287
+ </DD>
288
+ </DL>
289
+ <HR>
290
+
291
+ <A NAME="hashCode()"><!-- --></A><H3>
292
+ hashCode</H3>
293
+ <PRE>
294
+ public int <B>hashCode</B>()</PRE>
295
+ <DL>
296
+ <DD><DL>
297
+ <DT><B>Overrides:</B><DD><CODE>hashCode</CODE> in class <CODE>java.lang.Object</CODE></DL>
298
+ </DD>
299
+ <DD><DL>
300
+ </DL>
301
+ </DD>
302
+ </DL>
303
+ <HR>
304
+
305
+ <A NAME="toString()"><!-- --></A><H3>
306
+ toString</H3>
307
+ <PRE>
308
+ public java.lang.String <B>toString</B>()</PRE>
309
+ <DL>
310
+ <DD><DL>
311
+ <DT><B>Overrides:</B><DD><CODE>toString</CODE> in class <CODE>java.lang.Object</CODE></DL>
312
+ </DD>
313
+ <DD><DL>
314
+ </DL>
315
+ </DD>
316
+ </DL>
317
+ <HR>
318
+
319
+ <A NAME="equals(java.lang.Object)"><!-- --></A><H3>
320
+ equals</H3>
321
+ <PRE>
322
+ public boolean <B>equals</B>(java.lang.Object&nbsp;object)</PRE>
323
+ <DL>
324
+ <DD>Compares two <code>Key</code> objects by comparing ids, kinds, parent
325
+ and appIdNamespace.
326
+ If both keys are assigned names rather than ids, compares names instead
327
+ of ids. If neither key has an id or a name, the keys are only equal if
328
+ they reference the same object.
329
+ <P>
330
+ <DD><DL>
331
+ <DT><B>Overrides:</B><DD><CODE>equals</CODE> in class <CODE>java.lang.Object</CODE></DL>
332
+ </DD>
333
+ <DD><DL>
334
+ </DL>
335
+ </DD>
336
+ </DL>
337
+ <HR>
338
+
339
+ <A NAME="getId()"><!-- --></A><H3>
340
+ getId</H3>
341
+ <PRE>
342
+ public long <B>getId</B>()</PRE>
343
+ <DL>
344
+ <DD>Returns the numeric identifier of this <code>Key</code>.
345
+ <P>
346
+ <DD><DL>
347
+ </DL>
348
+ </DD>
349
+ <DD><DL>
350
+ </DL>
351
+ </DD>
352
+ </DL>
353
+ <HR>
354
+
355
+ <A NAME="getName()"><!-- --></A><H3>
356
+ getName</H3>
357
+ <PRE>
358
+ public java.lang.String <B>getName</B>()</PRE>
359
+ <DL>
360
+ <DD><DL>
361
+ </DL>
362
+ </DD>
363
+ <DD><DL>
364
+ </DL>
365
+ </DD>
366
+ </DL>
367
+ <HR>
368
+
369
+ <A NAME="getChild(java.lang.String, long)"><!-- --></A><H3>
370
+ getChild</H3>
371
+ <PRE>
372
+ public <A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A> <B>getChild</B>(java.lang.String&nbsp;kind,
373
+ long&nbsp;id)</PRE>
374
+ <DL>
375
+ <DD>Creates a new key having <code>this</code> as parent and the given numeric
376
+ identifier. The parent key must be complete.
377
+ <P>
378
+ <DD><DL>
379
+ </DL>
380
+ </DD>
381
+ <DD><DL>
382
+ <DT><B>Parameters:</B><DD><CODE>kind</CODE> - the kind of the child key to create<DD><CODE>id</CODE> - the numeric identifier of the key in <code>kind</code>, unique
383
+ for this parent</DL>
384
+ </DD>
385
+ </DL>
386
+ <HR>
387
+
388
+ <A NAME="getChild(java.lang.String, java.lang.String)"><!-- --></A><H3>
389
+ getChild</H3>
390
+ <PRE>
391
+ public <A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A> <B>getChild</B>(java.lang.String&nbsp;kind,
392
+ java.lang.String&nbsp;name)</PRE>
393
+ <DL>
394
+ <DD>Creates a new key having <code>this</code> as parent and the given name. The
395
+ parent key must be complete.
396
+ <P>
397
+ <DD><DL>
398
+ </DL>
399
+ </DD>
400
+ <DD><DL>
401
+ <DT><B>Parameters:</B><DD><CODE>kind</CODE> - the kind of the child key to create<DD><CODE>name</CODE> - the name of the key in <code>kind</code>, as an arbitrary string
402
+ unique for this parent</DL>
403
+ </DD>
404
+ </DL>
405
+ <HR>
406
+
407
+ <A NAME="isComplete()"><!-- --></A><H3>
408
+ isComplete</H3>
409
+ <PRE>
410
+ public boolean <B>isComplete</B>()</PRE>
411
+ <DL>
412
+ <DD>Returns true if this Key has a name specified or has been assigned an identifier.
413
+ <P>
414
+ <DD><DL>
415
+ </DL>
416
+ </DD>
417
+ <DD><DL>
418
+ </DL>
419
+ </DD>
420
+ </DL>
421
+ <HR>
422
+
423
+ <A NAME="compareTo(com.google.appengine.api.datastore.Key)"><!-- --></A><H3>
424
+ compareTo</H3>
425
+ <PRE>
426
+ public int <B>compareTo</B>(<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A>&nbsp;other)</PRE>
427
+ <DL>
428
+ <DD>Compares two <code>Key</code> objects. The algorithm proceeds as follows:
429
+ Turn each <code>Key</code> into an iterator where the first element returned
430
+ is the top-most ancestor, the next element is the child
431
+ of the previous element, and so on. The last element will
432
+ be the <code>Key</code> we started with. Once we have assembled these two
433
+ iterators (one for 'this' and one for the <code>Key</code> we're comparing to),
434
+ consume them in parallel, comparing the next element from each iterator.
435
+ If at any point the comparison of these two elements yields a non-zero
436
+ result, return that as the result of the overall comparison. If we
437
+ exhaust the iterator built from 'this' before we exhaust
438
+ the iterator built from the other <code>Key</code>, we return less than. An
439
+ example:
440
+
441
+ app1.type1.4.app1.type2.9 < app1.type1.4.app1.type2.9.app1.type3.2
442
+
443
+ If we exhaust the iterator built from the other <code>Key</code> before we
444
+ exhaust the iterator built from 'this', we return greater than. An
445
+ example:
446
+
447
+ app1.type1.4.app1.type2.9.app1.type3.2 > app1.type1.4.app1.type2.9
448
+
449
+ The relationship between individual <code>Key Keys</code> is performed
450
+ by comparing app followed by kind followed by id. If both keys are
451
+ assigned names rather than ids, compares names instead of ids. If neither
452
+ key has an id or a name we return an arbitrary but consistent result.
453
+ Assuming all other components are equal, all ids are less than all names.
454
+ <P>
455
+ <DD><DL>
456
+ <DT><B>Specified by:</B><DD><CODE>compareTo</CODE> in interface <CODE>java.lang.Comparable&lt;<A HREF="../../../../../com/google/appengine/api/datastore/Key.html" title="class in com.google.appengine.api.datastore">Key</A>&gt;</CODE></DL>
457
+ </DD>
458
+ <DD><DL>
459
+ </DL>
460
+ </DD>
461
+ </DL>
462
+ <!-- ========= END OF CLASS DATA ========= -->
463
+ <HR>
464
+
465
+
466
+ <!-- ======= START OF BOTTOM NAVBAR ====== -->
467
+ <A NAME="navbar_bottom"><!-- --></A>
468
+ <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
469
+ <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
470
+ <TR>
471
+ <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
472
+ <A NAME="navbar_bottom_firstrow"><!-- --></A>
473
+ <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
474
+ <TR ALIGN="center" VALIGN="top">
475
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
476
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
477
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
478
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
479
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
480
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
481
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
482
+ </TR>
483
+ </TABLE>
484
+ </TD>
485
+ <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
486
+ </EM>
487
+ </TD>
488
+ </TR>
489
+
490
+ <TR>
491
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
492
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/ImplicitTransactionManagementPolicy.html" title="enum in com.google.appengine.api.datastore"><B>PREV CLASS</B></A>&nbsp;
493
+ &nbsp;<A HREF="../../../../../com/google/appengine/api/datastore/KeyFactory.html" title="class in com.google.appengine.api.datastore"><B>NEXT CLASS</B></A></FONT></TD>
494
+ <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
495
+ <A HREF="../../../../../index.html?com/google/appengine/api/datastore/Key.html" target="_top"><B>FRAMES</B></A> &nbsp;
496
+ &nbsp;<A HREF="Key.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
497
+ &nbsp;<SCRIPT type="text/javascript">
498
+ <!--
499
+ if(window==top) {
500
+ document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
501
+ }
502
+ //-->
503
+ </SCRIPT>
504
+ <NOSCRIPT>
505
+ <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
506
+ </NOSCRIPT>
507
+
508
+
509
+ </FONT></TD>
510
+ </TR>
511
+ <TR>
512
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
513
+ SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
514
+ <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
515
+ DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
516
+ </TR>
517
+ </TABLE>
518
+ <A NAME="skip-navbar_bottom"></A>
519
+ <!-- ======== END OF BOTTOM NAVBAR ======= -->
520
+
521
+ <HR>
522
+
523
+ </BODY>
524
+ </HTML>