Merged DEV/SWIFT to HEAD

25629: ALF-7069:
          - changed getNodes to a POST request
          - beefed up unit tests + some performance tests
          ALF-7070:
          - initial checkin, works end-to-end, still work-in-progress
          - unit + performance tests
   25630: ALF-7069: removed files that are no longer needed
   25640: Merged BRANCHES\DEV\SOLR to BRANCHES\DEV\SWIFT
      25079: SOLR check point: ALF-4259: SOLR Integration
      25217: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
      25315: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
      25577: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
      25604: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
      25610: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
   25651: - enabled OpenCMIS server ticket authentication 
          - added OpenCMIS client API (incomplete)
   25667: Merged BRANCHES/DEV/BM to BRANCHES/DEV/SWIFT:
      25030: Repo BM Sprint 1 - example using JMeter (WebDAV & CMIS)
      25054: Repo BM Sprint 1 - milestone 2
      25078: Repo BM sprint 1 - milestone 3 (ALF-6794)
   25675: ALF-7068: SOLR 075 Improved cache rebuild performance - delta + query cache warming
          - fix queries against un-optimized index
   25676: Merged BRANCHES/DEV/BM to BRANCHES/DEV/SWIFT: commit mergeinfo
   25683: RepoBM: OpenCMIS 
          - use shared libs (from 3rd-party project)
          - change default url (from ".../alfresco/opencmis-atom" to ".../alfresco/cmisatom")
   25767: ALF-7339: SOLR 020 Index track and build from SOLR
          - Initial hook up point and proto type for config
   25787: ALF-7070:
          - owner, associations, type conversions
          SOLR Client-side API to call into repository SOLR APIs
   25818: added webscripts root object as an entry point to OpenCMIS client sessions (local and remote)
   25855: Bug fix: keep CMIS connection manager reference

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@28089 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/repo/cmis/client/CMISConnectionManager.java

@@ -0,0 +1,104 @@
+/*
+ * Copyright (C) 2005-2011 Alfresco Software Limited.
+ *
+ * This file is part of Alfresco
+ *
+ * Alfresco 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 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco 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 Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.alfresco.repo.cmis.client;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import org.apache.chemistry.opencmis.client.api.Repository;
+
+/**
+ * Manages all CMIS client connections.
+ */
+public interface CMISConnectionManager
+{
+    // --- connections ---
+
+    /**
+     * Creates a new connection that is only visible to the current user.
+     */
+    CMISConnection createUserConnection(CMISServer server, String connectionId);
+
+    /**
+     * Creates a new connection that is visible to all users.
+     */
+    CMISConnection createSharedConnection(CMISServer server, String connectionId);
+
+    /**
+     * Gets or creates a connection to the local server or a default server.
+     */
+    CMISConnection getConnection();
+
+    /**
+     * Returns all user connections.
+     */
+    Collection<CMISConnection> getUserConnections();
+
+    /**
+     * Returns a specific user connection or <code>null</code> if the connection
+     * id is unknown.
+     */
+    CMISConnection getUserConnections(String connectionId);
+
+    /**
+     * Returns all shared connections.
+     */
+    Collection<CMISConnection> getSharedConnections();
+
+    /**
+     * Returns a specific shared connection or <code>null</code> if the
+     * connection id is unknown.
+     */
+    CMISConnection getSharedConnection(String connectionId);
+
+    // --- servers ---
+
+    /**
+     * Returns all configured server definitions.
+     */
+    Collection<CMISServer> getServerDefinitions();
+
+    /**
+     * Gets a server definitions by name.
+     */
+    CMISServer getServerDefinition(String serverName);
+
+    /**
+     * Creates a new server definition.
+     */
+    CMISServer createServerDefinition(String serverName, Map<String, String> parameters);
+
+    /**
+     * Creates a new server definition from a template.
+     */
+    CMISServer createServerDefinition(CMISServer server, String username, String password);
+
+    /**
+     * Creates a new server definition from a template.
+     */
+    CMISServer createServerDefinition(CMISServer server, String username, String password, String repositoryId);
+
+    // --- repositories ---
+
+    /**
+     * Returns all repositories available at this server.
+     */
+    List<Repository> getRepositories(CMISServer server);
+}