Java ize2

.gitignore

@@ -38,4 +38,6 @@ nbproject
 *.log.*
 *.log
 .sonar-ide.properties
-.clover
+.clover
+.DS_Store
+

api/pom.xml

@@ -25,7 +25,6 @@
     <version>3.0-SNAPSHOT</version>
   </parent>
   <artifactId>application-googleapps-api</artifactId>
-  <version>3.0-SNAPSHOT</version>
   <packaging>jar</packaging>
   <name>Google Apps Integration (API)</name>
   <description>This is the XWiki-API part of the Google Apps which allows to connect Google Apps to XWiki.</description>
@@ -42,11 +41,6 @@
       <artifactId>google-api-client</artifactId>
       <version>1.24.1</version>
     </dependency>
-    <dependency>
-      <groupId>com.google.gdata</groupId>
-      <artifactId>core</artifactId>
-      <version>1.47.1</version>
-    </dependency>
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-people</artifactId>
@@ -57,33 +51,10 @@
       <artifactId>google-api-services-drive</artifactId>
       <version>v2-rev358-1.24.1</version>
     </dependency>
+    <dependency>
+      <groupId>javax.servlet</groupId>
+      <artifactId>javax.servlet-api</artifactId>
+      <scope>provided</scope>
+    </dependency>
   </dependencies>
-  <issueManagement>
-    <system>GitHub</system>
-    <url>https://github.com/xwikisas/application-googleapps/issues</url>
-  </issueManagement>
-  <scm>
-    <connection>scm:git:git://github.com/xwikisas/application-googleapps.git</connection>
-    <developerConnection>scm:git:[email protected]:xwikisas/application-googleapps.git</developerConnection>
-    <url>https://github.com/xwikisas/application-googleapps</url>
-    <tag>HEAD</tag>
-  </scm>
-  <build>
-    <plugins>
-       <plugin>
-            <groupId>org.apache.maven.plugins</groupId>
-            <artifactId>maven-checkstyle-plugin</artifactId>
-            <configuration>
-              <failOnViolation>false</failOnViolation>
-            </configuration>
-            <executions>
-                <execution>
-                    <id>checkstyle-validation</id>
-                    <phase>none</phase>
-                </execution>
-            </executions>
-        </plugin>
-    </plugins>
-  </build>
-
 </project>

api/src/main/java/com/xwiki/googleapps/DriveDocMetadata.java

@@ -0,0 +1,284 @@
+/*
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+package com.xwiki.googleapps;
+
+import java.util.LinkedList;
+import java.util.List;
+
+import org.xwiki.stability.Unstable;
+
+/**
+ * Simple pojo for metadata about a doc in Google Drive.
+ *
+ * @version $Id$
+ * @since 3.0
+ */
+@Unstable
+public class DriveDocMetadata
+{
+    /**
+     * Google's internal id to find the document again.
+     */
+    private String id;
+
+    /**
+     * URL to direct the user to for editing.
+     */
+    private String editLink;
+
+    /**
+     * URL to pull from in order to fetch the document.
+     */
+    private String exportLink;
+
+    /**
+     * URL to use to show an embedded view.
+     */
+    private String embedLink;
+
+    /**
+     * A stringified version number.
+     */
+    private String version;
+
+    /**
+     * The name of the file in case it is an uploaded file.
+     */
+    private String fileName;
+
+    /**
+     * The email-address of the user with which this document's connection was created.
+     */
+    private String user;
+
+    /**
+     * A list of export possibilities.
+     */
+    private List<ExportAlternative> exportLinksAlternatives = new LinkedList<>();
+
+    /**
+     * @return the internal Google Id of the document.
+     */
+    public String getId()
+    {
+        return id;
+    }
+
+    /**
+     * Sets the Google ID of the document having requested this document.
+     * @param id The id of the document.
+     * */
+    public void setId(String id)
+    {
+        this.id = id;
+    }
+
+    /**
+     * @return the version number
+     */
+    public String getVersion()
+    {
+        return version;
+    }
+
+    /**
+     * Set a designation of the version of the document.
+     * @param version The version (a number, expectedly)
+     */
+    public void setVersion(String version)
+    {
+        this.version = version;
+    }
+
+    /**
+     * @return the URL to direct the user to for editing.
+     */
+    public String getEditLink()
+    {
+        return editLink;
+    }
+
+    /**
+     * Sets the link where this document can be edited.
+     * @param link The link where it can be edited.
+     */
+    public void setEditLink(String link)
+    {
+        this.editLink = link;
+    }
+
+    /**
+     * @return the URL to pull from in order to fetch the document.
+     */
+    public String getExportLink()
+    {
+        return exportLink;
+    }
+
+    /**
+     * Sets the link from which this document can be exported (and thus saved to XWiki).
+     * @param link The link where it can be exported.
+     */
+    public void setExportLink(String link)
+    {
+        this.exportLink = link;
+    }
+
+    /**
+     * @return a list of export alternatives.
+     */
+    public List<ExportAlternative> getExportLinksAlternatives()
+    {
+        return exportLinksAlternatives;
+    }
+
+    /**
+     * Inserts one of the information about one of the export-alternatives.
+     *
+     * @param extension   the filename extension (understood as a name of the file-type)
+     * @param newFileName the filename when this file is stored on a desktop with this type
+     * @param exportUrl   the url to pull from.
+     */
+    public void addExportAlternative(String extension, String newFileName, String exportUrl)
+    {
+        ExportAlternative ea = new ExportAlternative();
+        ea.extension = extension;
+        ea.exportUrl = exportUrl;
+        ea.newFileName = newFileName;
+        if (ea.newFileName == null) {
+            ea.newFileName = "unnamed";
+        }
+        exportLinksAlternatives.add(ea);
+    }
+
+    /**
+     * @return the name of the file in case it is an uploaded file.
+     */
+    public String getFileName()
+    {
+        return fileName;
+    }
+
+    /**
+     * Sets the name of the file when it was uploaded.
+     * @param fileName The name of the file.
+     */
+    public void setFileName(String fileName)
+    {
+        this.fileName = fileName;
+    }
+
+    /**
+     * @return the same as {#getFileName}.
+     */
+    public String getTitle()
+    {
+        return fileName;
+    }
+
+    /**
+     * @return a useful string representation
+     */
+    public String toString()
+    {
+        return "id " + id + " edit: " + editLink + " export " + exportLink;
+    }
+
+    /**
+     * The link of the iframe where it can be embedded.
+     * @return The link.
+     */
+    public String getEmbedLink()
+    {
+        return embedLink;
+    }
+
+    /**
+     * Sets the link with which the document can be embedded.
+     * @param link The link.
+     */
+    public void setEmbedLink(String link)
+    {
+        this.embedLink = link;
+    }
+
+    /**
+     * The Google user that was used to include this document.
+     * @return The google user email.
+     */
+    public String getUser()
+    {
+        return user;
+    }
+
+    /**
+     * The Google user that was used to include this document.
+     * @param emailAddress  The user email.
+     */
+    public void setUser(String emailAddress)
+    {
+        this.user = emailAddress;
+    }
+
+    /**
+     * A class to denote export possibilities of a drive file.
+     */
+    public static class ExportAlternative
+    {
+        /**
+         * a short nickname of the file type, typically the file-ending.
+         */
+        private String extension;
+
+        /**
+         * the revised filename if exported to this extension.
+         */
+        private String newFileName;
+
+        /**
+         * the URL to pull from.
+         */
+        private String exportUrl;
+
+        /**
+         * @return a short nickname of the file type, typically the file-ending.
+         */
+        public String getExtension()
+        {
+            return extension;
+        }
+
+        /**
+         * @return the revised filename if exported to this extension.
+         */
+        public String getNewFileName()
+        {
+            return newFileName;
+        }
+
+        /**
+         * @return the URL to pull from.
+         */
+        public String getExportUrl()
+        {
+            return exportUrl;
+        }
+    }
+}