Fix for CONNECTORS-474. Build Livelink, FileNet, and Documentum conne…

…ctors against stubs. Include WSDL and XSD files directly for Meridio and SharePoint connectors.

git-svn-id: https://svn.apache.org/repos/asf/manifoldcf/trunk@1353842 13f79535-47bb-0310-9956-ffa450edef68

CHANGES.txt

@@ -3,6 +3,13 @@ $Id$
 
 ======================= 0.6-dev =====================
 
+CONNECTORS-474: Make it possible to build a complete release candidate
+and site javadoc without requiring any proprietary libraries or interface
+code installed.  This is accomplished by: (a) including stub non-proprietary
+classes that can be compiled against, and (b) including WSDLs and XSDs
+generated from proprietary .NET libraries, but which are not proprietary
+themselves (according to LEGAL-137).
+
 CONNECTORS-484: The FileNet connector UI has been broken since
 the i18n work was done on it.
 (Joe Becknell, Karl Wright)

LICENSE.txt

@@ -175,3 +175,13 @@
 
    END OF TERMS AND CONDITIONS
 
+
+The Meridio Connector portion of this software includes application
+interface descriptions generated in part from proprietary libraries licensed
+by Meridio, Inc., a division of Autonomy, Inc., a subsidiary of Hewlett
+Packard, Inc.
+
+The SharePoint Connector portion of this software includes application
+interface descriptions generated in part from proprietary libraries licensed
+by Microsoft, Inc.
+

connectors/connector-build.xml

@@ -70,6 +70,7 @@
             <include name="commons-discovery*.jar"/>
         </fileset>
         <fileset dir="../../framework/build/jar"/>
+        <pathelement location="build/stubclasses"/>
         <pathelement location="build/wsdlclasses"/>
         <pathelement location="build/xsdclasses"/>
         <pathelement location="build/interface/classes"/>
@@ -104,6 +105,7 @@
 
     <path id="implementation-classpath">
         <path refid="mcf-connector-build.implementation-classpath"/>
+        <pathelement location="build/stubclasses"/>
     </path>
 
     <path id="mcf-connector-build.interface-classpath">
@@ -125,6 +127,18 @@
 
     <target name="pretest-check" depends="calculate-testcode-condition" unless="canTest"/>
 
+    <target name="has-stubs-check" depends="precompile-check" if="canBuild">
+        <available file="build-stub/src/main/java" property="hasStubs"/>
+    </target>
+
+    <target name="compile-stubs" depends="has-stubs-check" if="hasStubs">
+        <mkdir dir="build/stubclasses"/>
+        <javac srcdir="build-stub/src/main/java" destdir="build/stubclasses" target="1.6" source="1.6" debug="true" debuglevel="lines,vars,source">
+            <classpath>
+            </classpath>
+        </javac>
+    </target>
+
     <target name="has-tests-check" depends="precompile-check" if="canBuild">
         <available file="connector/src/test/java" property="hasTests"/>
     </target>
@@ -328,7 +342,7 @@
         </javac>
     </target>
 
-    <target name="compile-connector" depends="compile-connector-native2ascii,compile-connector-resources,compile-wsdls,compile-xsds,compile-interface,compile-rmic,precompile-check" if="canBuild">
+    <target name="compile-connector" depends="compile-stubs,compile-connector-native2ascii,compile-connector-resources,compile-wsdls,compile-xsds,compile-interface,compile-rmic,precompile-check" if="canBuild">
         <mkdir dir="build/connector/classes"/>
         <javac srcdir="connector/src/main/java" destdir="build/connector/classes" target="1.6" source="1.6" debug="true" debuglevel="lines,vars,source">
             <classpath>
@@ -337,7 +351,7 @@
         </javac>
     </target>
 
-    <target name="compile-implementation" depends="compile-interface,has-RMI-check" if="hasRMI">
+    <target name="compile-implementation" depends="compile-stubs,compile-interface,has-RMI-check" if="hasRMI">
         <mkdir dir="build/implementation/classes"/>
         <javac srcdir="implementation/src/main/java" destdir="build/implementation/classes" target="1.6" source="1.6" debug="true" debuglevel="lines,vars,source">
             <classpath>

connectors/documentum/build-stub/src/main/java/com/documentum/com/DfClientX.java

@@ -0,0 +1,45 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.com;
+
+import com.documentum.fc.client.IDfClient;
+import com.documentum.fc.common.DfObject;
+import com.documentum.fc.common.IDfLoginInfo;
+import com.documentum.fc.common.DfException;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfClientX extends DfObject implements IDfClientX
+{
+  public DfClientX()
+  {
+  }
+
+  public IDfLoginInfo getLoginInfo()
+  {
+    return null;
+  }
+
+  public IDfClient getLocalClient()
+    throws DfException
+  {
+    return null;
+  }
+
+}

connectors/documentum/build-stub/src/main/java/com/documentum/com/IDfClientX.java

@@ -0,0 +1,32 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.com;
+
+import com.documentum.fc.client.IDfClient;
+import com.documentum.fc.common.IDfLoginInfo;
+import com.documentum.fc.common.DfException;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public interface IDfClientX
+{
+  public IDfLoginInfo getLoginInfo();
+  public IDfClient getLocalClient()
+    throws DfException;
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfAuthenticationException.java

@@ -0,0 +1,25 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfAuthenticationException extends DfServiceException
+{
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfDocbaseUnreachableException.java

@@ -0,0 +1,25 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfDocbaseUnreachableException extends DfIOException
+{
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfIOException.java

@@ -0,0 +1,25 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfIOException extends DfServiceException
+{
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfIdentityException.java

@@ -0,0 +1,25 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfIdentityException extends DfServiceException
+{
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfQuery.java

@@ -0,0 +1,45 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+import com.documentum.fc.common.*;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfQuery extends DfObject implements IDfQuery
+{
+  public DfQuery()
+  {
+  }
+
+  public IDfCollection execute(IDfSession session, int type)
+    throws DfException
+  {
+    return null;
+  }
+
+  public void setBatchSize(int size)
+  {
+  }
+
+  public void setDQL(String dql)
+  {
+  }
+
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/DfServiceException.java

@@ -0,0 +1,27 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+import com.documentum.fc.common.*;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public class DfServiceException extends DfException
+{
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/IDfClient.java

@@ -0,0 +1,26 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public interface IDfClient
+{
+  public IDfSessionManager newSessionManager();
+}

connectors/documentum/build-stub/src/main/java/com/documentum/fc/client/IDfCollection.java

@@ -0,0 +1,33 @@
+/* $Id$ */
+
+/**
+* Licensed to the Apache Software Foundation (ASF) under one or more
+* contributor license agreements. See the NOTICE file distributed with
+* this work for additional information regarding copyright ownership.
+* The ASF licenses this file to You 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 com.documentum.fc.client;
+
+import com.documentum.fc.common.*;
+
+/** Stub interface to allow the connector to build fully.
+*/
+public interface IDfCollection
+{
+  public String getString(String attribute)
+    throws DfException;
+  public boolean next()
+    throws DfException;
+  public void close()
+    throws DfException;
+}