Update App Engine API dependencies and build configurations. Corrected Javadoc tags in Blobstore API. Added missing imports in BlobstoreService as well as in appengine-stub-apis. Simplified Javadoc link in Datastore. Removed an unused Guava dependency. Added the maven-source-plugin to several modules (protobuf, runtime_shared, sessiondata, utils) to ensure source jars are attached during the build. Also fixed mockito warnings during the Maven build.

PiperOrigin-RevId: 850130894
Change-Id: I705ce1e3e3baab4a89379c3fa23cf963fe1dbb87

Author: ludoch

api/src/main/java/com/google/appengine/api/blobstore/UploadOptions.java

@@ -57,7 +57,7 @@ public boolean hasMaxUploadSizeBytesPerBlob() {
   }
 
   /**
-   * @returns the maximum upload size per blob.
+   * @return the maximum upload size per blob.
    */
   public long getMaxUploadSizeBytesPerBlob() {
     if (maxUploadSizeBytesPerBlob == null) {
@@ -86,7 +86,7 @@ public boolean hasMaxUploadSizeBytes() {
   }
 
   /**
-   * @returns the maximum upload size.
+   * @return the maximum upload size.
    */
   public long getMaxUploadSizeBytes() {
     if (maxUploadSizeBytes == null) {
@@ -106,7 +106,7 @@ public boolean hasGoogleStorageBucketName() {
   }
 
   /**
-   * @returns the storage bucket name.
+   * @return the storage bucket name.
    */
   public String getGoogleStorageBucketName() {
     if (gsBucketName == null) {

api/src/main/java/com/google/appengine/api/blobstore/jakarta/BlobstoreService.java

@@ -18,8 +18,11 @@
 
 import com.google.appengine.api.blobstore.BlobInfo;
 import com.google.appengine.api.blobstore.BlobKey;
+import com.google.appengine.api.blobstore.BlobstoreFailureException;
 import com.google.appengine.api.blobstore.ByteRange;
 import com.google.appengine.api.blobstore.FileInfo;
+import com.google.appengine.api.blobstore.RangeFormatException;
+import com.google.appengine.api.blobstore.UnsupportedRangeFormatException;
 import com.google.appengine.api.blobstore.UploadOptions;
 import jakarta.servlet.http.HttpServletRequest;
 import jakarta.servlet.http.HttpServletResponse;

api/src/main/java/com/google/appengine/api/datastore/EntityProtoComparators.java

@@ -38,7 +38,7 @@ public final class EntityProtoComparators {
       BaseEntityComparator.MULTI_TYPE_COMPARATOR;
 
   /**
-   * A comparator for {@link com.google.storage.onestore.v3.OnestoreEntity.EntityProto} objects with
+   * A comparator for {@link EntityProto} objects with
    * the same ordering as {@link EntityComparator}.
    */
   public static final class EntityProtoComparator

api_dev/src/main/java/com/google/appengine/api/datastore/dev/DefaultHighRepJobPolicy.java

@@ -38,7 +38,8 @@ public class DefaultHighRepJobPolicy implements HighRepJobPolicy {
       "datastore.default_high_rep_job_policy_random_seed";
 
   /**
-   * A float >= 0 and <= 100 representing the percentage of job application attempts that will fail.
+   * A float &gt;= 0 and &lt;= 100 representing the percentage of job application
+   * attempts that will fail.
    * Must be parsable via {@link Float#parseFloat(String)}. Any portion of the value beyond two
    * decimal places will be truncated. If not provided we set the percentage to 0.
    */

api_dev/src/main/java/com/google/appengine/api/datastore/dev/PropertyType.java

@@ -34,7 +34,7 @@
  * with the field for the given type set to minimum and human-readable
  * placeholder values.
  *
- * @see OnestoreEntity.PropertyValue
+ * @see PropertyValue
  *
  */
 public enum PropertyType {

api_dev/src/main/java/com/google/appengine/tools/development/BackendContainer.java

@@ -37,7 +37,6 @@ public interface BackendContainer {
   /**
    * Start all backend instances.
    *
-   * @param backendsXml Parsed backends.xml file with servers configuration
    * @throws Exception
    */
   public void startupAll() throws Exception;

api_dev/src/main/java/com/google/appengine/tools/development/ContainerService.java

@@ -23,8 +23,9 @@
 import java.util.Map;
 
 /**
- * Provides the backing servlet container support for the {@link DevAppServer},
- * as discovered via {@link ServiceProvider}.
+ * Provides the backing servlet container support for the {@link
+ * com.google.appengine.tools.development.DevAppServer}, as discovered via
+ * ServiceProvider.
  * <p>
  * More specifically, this interface encapsulates the interactions between the
  * {@link DevAppServer} and the underlying servlet container, which by default

api_dev/src/main/java/com/google/appengine/tools/development/ContainerServiceEE8.java

@@ -22,8 +22,9 @@
 import javax.servlet.http.HttpServletResponse;
 
 /**
- * Provides the backing servlet container support for the {@link DevAppServer}, as discovered via
- * {@link ServiceProvider}.
+ * Provides the backing servlet container support for the {@link
+ * com.google.appengine.tools.development.DevAppServer}, as discovered via
+ * ServiceProvider.
  *
  * <p>More specifically, this interface encapsulates the interactions between the {@link
  * DevAppServer} and the underlying servlet container, which by default uses Jetty.

api_dev/src/main/java/com/google/appengine/tools/development/DelegatingModulesFilterHelper.java

@@ -18,7 +18,7 @@
 
 /**
  * A {@link ModulesFilterHelper} for delegating requests to either
- * {@link BackendServers} for backends or {@link Modules} for module instances.
+ * {@link BackendServersBase} for backends or {@link Modules} for module instances.
  */
 public class DelegatingModulesFilterHelper implements ModulesFilterHelper {
 

api_dev/src/main/java/com/google/appengine/tools/development/LocalHttpRequestEnvironment.java

@@ -27,7 +27,8 @@
  * This sets {@link LocalEnvironment#getAttributes()} from
  * <ol>
  * <li> Authentication details from the cookie that is maintained
- *      by the stub implementation of {@link UserService}
+ *      by the stub implementation of {@link
+ *      com.google.appengine.api.users.UserService}
  * </li>
  * <li> The passed in {@link ModulesFilterHelper}. </li>
  * </ol>