version 1.15.1

Author: vbarathan

INSTALL.txt

@@ -29,14 +29,14 @@ standard Java installation.
 3. mail.jar in Sun's JavaMail API (version 1.4 or greater).
    Sun's JavaMail package available for download from 
    "http://java.sun.com/products/javamail/downloads/index.html". This is only
-   required for media specific APIs including Document List Data API, Picasa
-   Web Album API and YouTube Data API.
+   required for media specific APIs including Google Base data API, 
+   Document List data API, Picasa Web Album API and YouTube data API.
 4. activation.jar in Sun's JavaBeans Activation Framewrok.
    This is required only if using JDK version 1.5.
    Sun's JavaBeansActivationFramework is available for download from 
    "http://java.sun.com/products/javabeans/jaf/downloads/index.html".  This is
-   only required for media specific APIs including Document List Data API, 
-   Picasa Web Album API and YouTube Data API.
+   only required for media specific APIs including Google Base data API, 
+   Document List data API, Picasa Web Album API and YouTube data API.
 5. servlet.jar in Sun's Servlet API (version 2.3 or greater).
    This is required only if executing code samples in 'sample.authsub' or
    'sample.gbase.recipe' packages.  Sun's Servlet API package can be

RELEASE_NOTES.txt

@@ -1,5 +1,14 @@
 Google Data API - Release Notes
 
+
+Notes for v1.15.1
+-----------------
+Dec 6, 2007
+o  Added support for media feed in Google Base data API.  With the media feed 
+   support you can manage binary attachments to your Google Base items.  With
+   this change you will require Java Mail and Java Activation Framework to
+   use Google Base data API.
+
 Notes for v1.15.0
 -----------------
 Nov 15, 2007

java/build/gbase.xml

@@ -16,13 +16,19 @@
 
 
   <!-- build Google Base API -->
-  <target name="build.gbase" depends="core.build.core.client">
+  <path id="build.gbase.classpath">
+    <pathelement location="${mail.jar}"/>
+    <pathelement location="${activation.jar}"/>
+    <pathelement location="${gdata-media.jar}"/>
+  </path>
+  
+  <target name="build.gbase" depends="core.build.core.media">
     <mkdir dir="${build.classes.base}"/>
     <javac debug="false" sourcepath=""
                          srcdir="${build.src}"
-                         destdir="${build.classes.base}"
-                         classpath="${gdata-client.jar}">
+                         destdir="${build.classes.base}">
       <include name="**/gbase/client/*.java"/>
+      <classpath refid="build.gbase.classpath"/>
     </javac>
     <jar destfile="${gdata-base.jar}"
          basedir="${build.classes.base}"
@@ -65,6 +71,19 @@
   </target>
 
   <!-- samples compile -->
+  <path id="sample.gbase.cmdline.compile.classpath">
+    <pathelement location="${mail.jar}"/>
+    <pathelement location="${activation.jar}"/>
+    <pathelement location="${gdata-base.jar}"/>
+  </path>
+
+  <path id="sample.gbase.recipe.compile.classpath">
+    <pathelement location="${mail.jar}"/>
+    <pathelement location="${activation.jar}"/>     
+    <pathelement location="${servlet.jar}"/>
+    <pathelement location="${gdata-base.jar}"/>
+  </path>
+  
   <target name="sample.gbase.cmdline.compile" depends="sample.gbase.dirs,sample.gbase.dependencies"
    description="Compile Java sources">
     <javac srcdir="${sample.gbase.cmdlinedir}"
@@ -93,17 +112,6 @@
   </target>
 
   <!-- samples build -->
-  <path id="sample.gbase.cmdline.compile.classpath">
-    <pathelement location="${gdata-client.jar}"/>
-    <pathelement location="${gdata-base.jar}"/>
-  </path>
-
-  <path id="sample.gbase.recipe.compile.classpath">
-    <pathelement location="${gdata-client.jar}"/>
-    <pathelement location="${gdata-base.jar}"/>
-    <pathelement location="${servlet.jar}"/>
-  </path>
-
   <target name="sample.gbase.cmdline.build" depends="sample.gbase.cmdline.compile"
     description="build the command-line tools ${gdata-base-cmdline.jar}">
     <jar destfile="${sample.gbase.cmdline.jar}"

java/build/version.properties

@@ -12,10 +12,10 @@ spreadsheet.spec.version=1.0
 youtube.spec.version=1.0
 
 # Implementation version
-client.impl.version=1.15.0
+client.impl.version=1.15.1
 media.impl.version=1.0.0
 appsforyourdomain.impl.version=1.1.0
-base.impl.version=1.0.4
+base.impl.version=1.1.0
 calendar.impl.version=1.0.7
 codesearch.impl.version=1.0.5
 docs.impl.version=1.0.0

java/manifest/base.manifest

@@ -1,5 +1,5 @@
 Manifest-Version: 1.0
-Class-Path: [email protected]@.jar
+Class-Path: [email protected]@.jar [email protected]@.jar
 
 Name: com/google/api/gbase/client/
 Specification-Title: Google Base data API client

java/sample/authsub/dist/authsub_sample.war

@@ -16,6 +16,7 @@
 package sample.gbase.cmdline;
 
 import java.net.MalformedURLException;
+import java.util.Arrays;
 
 /**
  * Creates and initializes commands given command-line
@@ -61,6 +62,16 @@ public static Command createCommand(String[] args) {
       return createGetCommand(args);
     } else if("batch".equals(commandName)) {
       return createBatchCommand(args);
+    } else if("query-media".equals(commandName)) {
+      return createQueryMediaCommand(args);
+    } else if("insert-media".equals(commandName)) {
+      return createInsertMediaCommand(args);      
+    } else if("update-media".equals(commandName)) {
+      return createUpdateMediaCommand(args);      
+    } else if("delete-media".equals(commandName)) {
+      return createDeleteMediaCommand(args);      
+    } else if("get-media".equals(commandName)) {
+      return createGetMediaCommand(args);      
     } else {
       throw error("Unknown command: " + commandName +
                   ". Available commands: " + ALL_COMMANDS);
@@ -83,7 +94,7 @@ private static Command createQueryCommand(String[] args) {
   }
 
   /**
-   * Creates and initializes a {@link QueryCommand}.
+   * Creates and initializes a {@link InsertCommand}.
    */
   private static Command createInsertCommand(String[] args) {
     InsertCommand command = new InsertCommand();
@@ -122,7 +133,7 @@ private static Command createUpdateCommand(String[] args) {
   private static Command createDeleteCommand(String[] args) {
     DeleteCommand command = new DeleteCommand();
     args = parseAndSetCommonArguments(command, args);
-
+    
     command.setItemId(getItemId(args));
 
     return command;
@@ -134,11 +145,86 @@ private static Command createDeleteCommand(String[] args) {
   private static Command createGetCommand(String[] args) {
     GetCommand command = new GetCommand();
     args = parseAndSetCommonArguments(command, args);
+    
     command.setItemId(getItemId(args));
 
+    return command;
+  }  
+  
+  /**
+   * Creates and initializes a {@link QueryMediaCommand}.
+   */
+  private static Command createQueryMediaCommand(String[] args) {
+    QueryMediaCommand command = new QueryMediaCommand();
+    args = parseAndSetCommonArguments(command, args);
+
+    if (args.length == 1) {
+      command.setItemMediaUrl(args[0]);
+    } else {
+      throw error("Expected [item_media_feed_url], got " + Arrays.toString(args));
+    }
+    
     return command;
   }
 
+  /**
+   * Creates and initializes a {@link InsertMediaCommand}.
+   */
+  private static Command createInsertMediaCommand(String[] args) {
+    InsertMediaCommand command = new InsertMediaCommand();
+    args = parseAndSetCommonArguments(command, args);
+    
+    if (args.length < 3 || args.length > 4) {
+      throw error("Expected four arguments: [item_media_feed_url attachment_path_to_file " +
+      		"attachment_mime_type caption?], got " + Arrays.toString(args));
+    }
+    
+    command.setItemMediaUrl(args[0]);
+    command.setAttachmentFile(args[1]);
+    command.setAttachmentMimeType(args[2]);
+    if (args.length == 4) {
+      command.setCaption(args[3]);
+    }
+
+    return command;
+  }
+
+  /**
+   * Creates and initializes a {@link UpdateMediaCommand}.
+   */
+  private static Command createUpdateMediaCommand(String[] args) {
+    UpdateMediaCommand command = new UpdateMediaCommand();
+    args = parseAndSetCommonArguments(command, args);
+
+    command.setAttachmentId(getItemId(args));
+
+    return command;
+  }
+
+  /**
+   * Creates and initializes a {@link DeleteMediaCommand}.
+   */
+  private static Command createDeleteMediaCommand(String[] args) {
+    DeleteMediaCommand command = new DeleteMediaCommand();
+    args = parseAndSetCommonArguments(command, args);
+
+    command.setAttachmentId(getItemId(args));
+
+    return command;
+  }
+
+  /**
+   * Creates and initializes a {@link GetMediaCommand).
+   */
+  private static Command createGetMediaCommand(String[] args) {
+    GetMediaCommand command = new GetMediaCommand();
+    args = parseAndSetCommonArguments(command, args);
+    
+    command.setAttachmentId(getItemId(args));
+
+    return command;
+  }
+  
   /**
    * Get the item id from the command line and make sure it's the
    * only argument left.

java/sample/gbase/cmdline/CommandFactory.java

@@ -0,0 +1,44 @@
+/* Copyright (c) 2007 Google Inc.
+ *
+ * Licensed 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.
+ */
+
+package sample.gbase.cmdline;
+
+import com.google.gdata.client.Service;
+
+/**
+ * Deletes a media attachment from an item.
+ * This command is called from {@link CustomerTool}.
+ */
+public class DeleteMediaCommand extends Command {
+
+  private String attachmentId;
+
+  @Override
+  public void execute() throws Exception {
+    Service service = createService();
+    Service.GDataRequest request =
+        service.createDeleteRequest(fixEditUrl(attachmentId));
+
+    // Send the request (HTTP DELETE)
+    request.execute();
+
+    System.out.println("Item deleted successfully.");
+  }
+
+  /** Sets the Id of the media attachment, which is also its URL. */
+  public void setAttachmentId(String attachmentId) {
+    this.attachmentId = attachmentId;
+  }
+}

java/sample/gbase/cmdline/DeleteMediaCommand.java

@@ -0,0 +1,47 @@
+/* Copyright (c) 2007 Google Inc.
+ *
+ * Licensed 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.
+ */
+
+package sample.gbase.cmdline;
+
+import com.google.gdata.client.Service;
+
+import java.net.URL;
+
+/**
+ * Displays the media entry (meta-data) of one attachment.
+ * This command is called from {@link CustomerTool}.
+ */
+public class GetMediaCommand extends Command {
+
+  private String attachmentId;
+
+  @Override
+  public void execute() throws Exception {
+    Service service = createService();
+    Service.GDataRequest request =
+      service.createEntryRequest(new URL(attachmentId));
+
+    // Send the request (HTTP GET)
+    request.execute();
+
+    // Save the response
+    outputRawResponse(request);
+  }
+
+  /** Sets the id/URL of the media attachment to display. */
+  public void setAttachmentId(String attachmentId) {
+    this.attachmentId = attachmentId;
+  }
+}