chemistry-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From f...@apache.org
Subject svn commit: r1537341 [2/2] - in /chemistry/opencmis/trunk: chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/ chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chem...
Date Wed, 30 Oct 2013 23:24:34 GMT
Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipProperties.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipProperties.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipProperties.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipProperties.java
Wed Oct 30 23:24:33 2013
@@ -26,16 +26,24 @@ package org.apache.chemistry.opencmis.cl
 public interface RelationshipProperties {
 
     /**
-     * Returns the source id of this CMIS relationship (CMIS property
-     * <code>cmis:sourceId</code>).
+     * Returns the source ID of this CMIS relationship (CMIS property
+     * {@code cmis:sourceId}).
+     * 
+     * @return the source ID or {@code null} if the property hasn't been
+     *         requested, hasn't been provided by the repository, or the
+     *         property value isn't set
      * 
      * @cmis 1.0
      */
-    ObjectId getSourceId(); // cmis:sourceId
+    ObjectId getSourceId();
 
     /**
-     * Returns the target id of this CMIS relationship (CMIS property
-     * <code>cmis:targetId</code>).
+     * Returns the target ID of this CMIS relationship (CMIS property
+     * {@code cmis:targetId}).
+     * 
+     * @return the target ID or {@code null} if the property hasn't been
+     *         requested, hasn't been provided by the repository, or the
+     *         property value isn't set
      * 
      * @cmis 1.0
      */

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipType.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipType.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipType.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/RelationshipType.java
Wed Oct 30 23:24:33 2013
@@ -30,7 +30,7 @@ public interface RelationshipType extend
      * Get the list of object types, allowed as source for relationships of this
      * type.
      * 
-     * @return the allowed source types for this relationship type.
+     * @return the allowed source types for this relationship type
      * 
      * @cmis 1.0
      */
@@ -40,7 +40,7 @@ public interface RelationshipType extend
      * Get the list of object types, allowed as target for relationships of this
      * type.
      * 
-     * @return the allowed target types for this relationship type.
+     * @return the allowed target types for this relationship type
      * 
      * @cmis 1.0
      */

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Rendition.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Rendition.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Rendition.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Rendition.java
Wed Oct 30 23:24:33 2013
@@ -29,34 +29,52 @@ import org.apache.chemistry.opencmis.com
 public interface Rendition extends RenditionData {
 
     /**
-     * Returns the size of the rendition in byte if available.
+     * Returns the size of the rendition in bytes if available.
+     * 
+     * @return the size of the rendition in bytes or -1 if the size is not
+     *         available
      */
     long getLength();
 
     /**
      * Returns the height in pixels if the rendition is an image.
+     * 
+     * @return the height in pixels or -1 if the height is not available or the
+     *         rendition is not an image
      */
     long getHeight();
 
     /**
      * Returns the width in pixels if the rendition is an image.
+     * 
+     * @return the width in pixels or -1 if the width is not available or the
+     *         rendition is not an image
      */
     long getWidth();
 
     /**
      * Returns the rendition document if the rendition is a stand-alone
      * document.
+     * 
+     * @return the rendition document or {@code null} if there is no rendition
+     *         document
      */
     Document getRenditionDocument();
 
     /**
      * Returns the rendition document using the provides
      * {@link OperationContext} if the rendition is a stand-alone document.
+     * 
+     * @return the rendition document or {@code null} if there is no rendition
+     *         document
      */
     Document getRenditionDocument(OperationContext context);
 
     /**
      * Returns the content stream of the rendition.
+     * 
+     * @return the content stream of the rendition or {@code null} if the
+     *         rendition has no content
      */
     ContentStream getContentStream();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Repository.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Repository.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Repository.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Repository.java
Wed Oct 30 23:24:33 2013
@@ -27,6 +27,8 @@ public interface Repository extends Repo
 
     /**
      * Creates a session for this repository.
+     * 
+     * @return the created session object
      */
     <T extends Session> T createSession();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Session.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Session.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Session.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/Session.java
Wed Oct 30 23:24:33 2013
@@ -41,32 +41,35 @@ import org.apache.chemistry.opencmis.com
 
 /**
  * A session is a connection to a CMIS repository with a specific user.
- * 
  * <p>
- * Not all operations might be supported the connected repository. Either
- * OpenCMIS or the repository will throw an exception if an unsupported
- * operation is called. The capabilities of the repository can be discovered by
- * evaluating the repository info (see {@link #getRepositoryInfo()}).
- * </p>
- * 
+ * CMIS itself is stateless. OpenCMIS uses the concept of a session to cache
+ * data across calls and to deal with user authentication. The session object is
+ * also used as entry point to all CMIS operations and objects. Because a
+ * session is only a client side concept, the session object needs not to be
+ * closed or released when it's not needed anymore.
+ * <p>
+ * Not all operations provided by this API might be supported by the connected
+ * repository. Either OpenCMIS or the repository will throw an exception if an
+ * unsupported operation is called. The capabilities of the repository can be
+ * discovered by evaluating the repository info (see
+ * {@link #getRepositoryInfo()}).
  * <p>
  * Almost all methods might throw exceptions derived from
- * {@link CmisBaseException} which is a runtime exception.
- * </p>
- * 
+ * {@link CmisBaseException} which is a runtime exception. See the CMIS
+ * specification for a list of all operations and their exceptions. Note that
+ * some incompliant repositories might throw other exception than you expect.
  * <p>
- * (Please refer to the <a
- * href="http://docs.oasis-open.org/cmis/CMIS/v1.0/os/">CMIS specification</a>
- * for details about the domain model, terms, concepts, base types, properties,
- * IDs and query names, query language, etc.)
+ * Refer to the <a href="http://docs.oasis-open.org/cmis/CMIS/v1.0/os/">CMIS 1.0
+ * specification</a> or the <a
+ * href="http://docs.oasis-open.org/cmis/CMIS/v1.0/os/">CMIS 1.1
+ * specification</a> for details about the domain model, terms, concepts, base
+ * types, properties, IDs and query names, query language, etc.
  * </p>
  */
 public interface Session extends Serializable {
 
     /**
-     * Clears all cached data. This implies that all data will be reloaded from
-     * the repository (depending on the implementation, reloading might be done
-     * immediately or be deferred).
+     * Clears all cached data.
      */
     void clear();
 
@@ -114,6 +117,33 @@ public interface Session extends Seriali
     /**
      * Creates a new operation context object with the given properties.
      * 
+     * @param filter
+     *            the property filter, a comma separated string of
+     *            <em>query names</em> or "*" for all properties or {@code null}
+     *            to let the repository determine a set of properties
+     * @param includeAcls
+     *            indicates whether ACLs should be included or not
+     * @param includeAllowableActions
+     *            indicates whether Allowable Actions should be included or not
+     * @param includePolicies
+     *            indicates whether policies should be included or not
+     * @param includeRelationships
+     *            enum that indicates if and which relationships should be
+     *            includes
+     * @param renditionFilter
+     *            the rendition filter or {@code null} for no renditions
+     * @param includePathSegments
+     *            indicates whether path segment or the relative path segment
+     *            should be included or not
+     * @param orderBy
+     *            the object order, a comma-separated list of
+     *            <em>query names</em> and the ascending modifier "ASC" or the
+     *            descending modifier "DESC" for each query name
+     * @param cacheEnabled
+     *            flag that indicates if the object cache should be used
+     * @param maxItemsPerPage
+     *            the max items per batch
+     * 
      * @return the newly created operation context object
      * 
      * @see OperationContext
@@ -161,10 +191,11 @@ public interface Session extends Seriali
     // types
 
     /**
-     * Returns the type definition of the given type ID.
+     * Gets the definition of a type.
      * 
      * @param typeId
-     *            the type ID
+     *            the ID of the type
+     * 
      * @return the type definition
      * 
      * @throws CmisObjectNotFoundException
@@ -175,12 +206,13 @@ public interface Session extends Seriali
     ObjectType getTypeDefinition(String typeId);
 
     /**
-     * Returns the type children of the given type ID.
+     * Gets the type children of a type.
      * 
      * @param typeId
      *            the type ID or {@code null} to request the base types
      * @param includePropertyDefinitions
-     *            indicates if the property definitions should be included
+     *            indicates whether the property definitions should be included
+     *            or not
      * @return the type iterator, not {@code null}
      * 
      * @throws CmisObjectNotFoundException
@@ -191,14 +223,16 @@ public interface Session extends Seriali
     ItemIterable<ObjectType> getTypeChildren(String typeId, boolean includePropertyDefinitions);
 
     /**
-     * Returns the type descendants of the given type ID.
+     * Gets the type descendants of a type.
      * 
      * @param typeId
      *            the type ID or {@code null} to request the base types
      * @param includePropertyDefinitions
-     *            indicates if the property definitions should be included
+     *            indicates whether the property definitions should be included
+     *            or not
      * @param depth
-     *            the tree depth, must be >0 or -1 for infinite depth
+     *            the tree depth, must be greater than 0 or -1 for infinite
+     *            depth
      * 
      * @throws CmisObjectNotFoundException
      *             if a type with the given type ID doesn't exist
@@ -212,6 +246,7 @@ public interface Session extends Seriali
      * 
      * @param type
      *            the type definition
+     * 
      * @return the new type definition
      * 
      * @cmis 1.1
@@ -223,6 +258,7 @@ public interface Session extends Seriali
      * 
      * @param type
      *            the type definition updates
+     * 
      * @return the updated type definition
      * 
      * @cmis 1.1
@@ -283,10 +319,20 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the cache is turned off per default {@link OperationContext}, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param objectId
      *            the object ID
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @see #getObject(String)
      * 
      * @cmis 1.0
@@ -297,12 +343,22 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the given {@link OperationContext} has caching turned off, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param objectId
      *            the object ID
      * @param context
      *            the {@link OperationContext} to use
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @see #getObject(String, OperationContext)
      * 
      * @cmis 1.0
@@ -313,10 +369,20 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the cache is turned off per default {@link OperationContext}, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param objectId
      *            the object ID
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @see #getObject(ObjectId)
      * 
      * @cmis 1.0
@@ -327,12 +393,22 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the given {@link OperationContext} has caching turned off, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param objectId
      *            the object ID
      * @param context
      *            the {@link OperationContext} to use
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @see #getObject(ObjectId, OperationContext)
      * 
      * @cmis 1.0
@@ -343,10 +419,20 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the cache is turned off per default {@link OperationContext}, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param path
      *            the object path
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @cmis 1.0
      */
     CmisObject getObjectByPath(String path);
@@ -355,12 +441,22 @@ public interface Session extends Seriali
      * Returns a CMIS object from the session cache. If the object is not in the
      * cache or the given {@link OperationContext} has caching turned off, it
      * will load the object from the repository and puts it into the cache.
+     * <p>
+     * This method might return a stale object if the object has been found in
+     * the cache and has been changed in or removed from the repository. Use
+     * {@link CmisObject#refresh()} and {@link CmisObject#refreshIfOld(long)} to
+     * update the object if necessary.
      * 
      * @param path
      *            the object path
      * @param context
      *            the {@link OperationContext} to use
      * 
+     * @return the requested object
+     * 
+     * @throws CmisObjectNotFoundException
+     *             if an object with the given ID doesn't exist
+     * 
      * @cmis 1.0
      */
     CmisObject getObjectByPath(String path, OperationContext context);
@@ -370,6 +466,8 @@ public interface Session extends Seriali
      * 
      * @param objectId
      *            object ID
+     * 
+     * @see #removeObjectFromCache(String)
      */
     void removeObjectFromCache(ObjectId objectId);
 
@@ -384,13 +482,15 @@ public interface Session extends Seriali
     // discovery
 
     /**
-     * Sends a query to the repository. (See CMIS spec "2.1.10 Query".)
+     * Sends a query to the repository. Refer to the CMIS specification for the
+     * CMIS query language syntax.
      * 
      * @param statement
      *            the query statement (CMIS query language)
      * @param searchAllVersions
-     *            specifies if the latest and non-latest versions of document
-     *            objects should be included
+     *            specifies whether non-latest document versions should be
+     *            included or not, {@code true} searches all document versions,
+     *            {@false} only searches latest document versions
      * 
      * @cmis 1.0
      */
@@ -403,26 +503,30 @@ public interface Session extends Seriali
      * @param statement
      *            the query statement (CMIS query language)
      * @param searchAllVersions
-     *            specifies if the latest and non-latest versions of document
-     *            objects should be included
+     *            specifies whether non-latest document versions should be
+     *            included or not, {@code true} searches all document versions,
+     *            {@false} only searches latest document versions
      * @param context
-     *            the OperationContext
+     *            the operation context to use
      * 
      * @cmis 1.0
      */
     ItemIterable<QueryResult> query(String statement, boolean searchAllVersions, OperationContext
context);
 
     /**
+     * Builds a CMIS query and returns the query results as an iterator of
+     * {@link CmisObject} objects.
      * 
      * @param type
      *            the ID of the object type
      * @param where
      *            the WHERE part of the query
      * @param searchAllVersions
-     *            specifies if the latest and non-latest versions of document
-     *            objects should be included
+     *            specifies whether non-latest document versions should be
+     *            included or not, {@code true} searches all document versions,
+     *            {@false} only searches latest document versions
      * @param context
-     *            the OperationContext
+     *            the operation context to use
      * 
      * @cmis 1.0
      */
@@ -433,7 +537,10 @@ public interface Session extends Seriali
      * Creates a query statement.
      * 
      * @param statement
-     *            the query statement with placeholders ('?').
+     *            the query statement with placeholders ('?'), see
+     *            {@link QueryStatement} for details
+     * 
+     * @return a new query statement object
      * 
      * @see QueryStatement
      * 
@@ -445,12 +552,14 @@ public interface Session extends Seriali
      * Returns the content changes.
      * 
      * @param changeLogToken
-     *            the change log token to start from or {@code null}
+     *            the change log token to start from or {@code null} to start
+     *            from the first available event in the repository
      * @param includeProperties
-     *            indicates if changed properties should be included in the
-     *            result
+     *            indicates whether changed properties should be included in the
+     *            result or not
      * @param maxNumItems
      *            maximum numbers of events
+     * 
      * @return the change events
      * 
      * @cmis 1.0
@@ -461,14 +570,16 @@ public interface Session extends Seriali
      * Returns the content changes.
      * 
      * @param changeLogToken
-     *            the change log token to start from or {@code null}
+     *            the change log token to start from or {@code null} to start
+     *            from the first available event in the repository
      * @param includeProperties
-     *            indicates if changed properties should be included in the
-     *            result
+     *            indicates whether changed properties should be included in the
+     *            result or not
      * @param maxNumItems
      *            maximum numbers of events
      * @param context
      *            the OperationContext
+     * 
      * @return the change events
      * 
      * @cmis 1.0
@@ -483,10 +594,11 @@ public interface Session extends Seriali
      * Note: Paging and skipping are not supported.
      * 
      * @param changeLogToken
-     *            the change log token to start from or {@code null}
+     *            the change log token to start from or {@code null} to start
+     *            from the first available event in the repository
      * @param includeProperties
-     *            indicates if changed properties should be included in the
-     *            result
+     *            indicates whether changed properties should be included in the
+     *            result or not
      * 
      * @cmis 1.0
      */
@@ -499,10 +611,11 @@ public interface Session extends Seriali
      * Note: Paging and skipping are not supported.
      * 
      * @param changeLogToken
-     *            the change log token to start from or {@code null}
+     *            the change log token to start from or {@code null} to start
+     *            from the first available event in the repository
      * @param includeProperties
-     *            indicates if changed properties should be included in the
-     *            result
+     *            indicates whether changed properties should be included in the
+     *            result or not
      * @param context
      *            the OperationContext
      * 
@@ -714,10 +827,11 @@ public interface Session extends Seriali
     void delete(ObjectId objectId, boolean allVersions);
 
     /**
-     * Retrieves the main content stream of a document
+     * Retrieves the main content stream of a document.
      * 
      * @param docId
      *            the ID of the document
+     * 
      * @return the content stream or {@code null} if the document has no content
      *         stream
      * 
@@ -726,7 +840,7 @@ public interface Session extends Seriali
     ContentStream getContentStream(ObjectId docId);
 
     /**
-     * Retrieves the content stream of a document
+     * Retrieves the content stream of a document.
      * 
      * @param docId
      *            the ID of the document
@@ -764,7 +878,7 @@ public interface Session extends Seriali
     Acl getAcl(ObjectId objectId, boolean onlyBasicPermissions);
 
     /**
-     * Applies ACL changes to an object and potentially dependent objects.
+     * Applies ACL changes to an object and dependent objects.
      * 
      * Only direct ACEs can be added and removed.
      * 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-api/src/main/java/org/apache/chemistry/opencmis/client/api/SessionFactory.java
Wed Oct 30 23:24:33 2013
@@ -22,7 +22,6 @@ import java.util.List;
 import java.util.Map;
 
 import org.apache.chemistry.opencmis.commons.SessionParameter;
-import org.apache.chemistry.opencmis.commons.exceptions.CmisBaseException;
 
 /**
  * Entry point into the OpenCMIS Client API. The <code>SessionFactory</code>
@@ -60,19 +59,21 @@ public interface SessionFactory {
      * 
      * @param parameters
      *            a {@code Map} of name/value pairs with parameters for the
-     *            session
+     *            session, see {@link SessionParameter} for
+     * 
      * @return a {@link Session} connected to the CMIS repository
-     * @throws CmisBaseException
-     *             if the connection could not be established
      * 
      * @see SessionParameter
      */
     Session createSession(Map<String, String> parameters);
 
     /**
-     * Returns all repositories that are available at the endpoint. See
-     * {@link #createSession(Map)} for parameter details. The parameter
+     * Returns all repositories that are available at the endpoint.
+     * 
+     * See {@link #createSession(Map)} for parameter details. The parameter
      * {@code SessionParameter.REPOSITORY_ID} should not be set.
+     * 
+     * @return a list of all available repositories
      */
     List<Repository> getRepositories(Map<String, String> parameters);
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/ChangeEventsImpl.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/ChangeEventsImpl.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/ChangeEventsImpl.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/ChangeEventsImpl.java
Wed Oct 30 23:24:33 2013
@@ -18,6 +18,7 @@
  */
 package org.apache.chemistry.opencmis.client.runtime;
 
+import java.util.ArrayList;
 import java.util.List;
 
 import org.apache.chemistry.opencmis.client.api.ChangeEvent;
@@ -50,6 +51,10 @@ public class ChangeEventsImpl implements
     }
 
     public List<ChangeEvent> getChangeEvents() {
+        if (events == null) {
+            events = new ArrayList<ChangeEvent>();
+        }
+
         return events;
     }
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/QueryResultImpl.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/QueryResultImpl.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/QueryResultImpl.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/QueryResultImpl.java
Wed Oct 30 23:24:33 2013
@@ -52,15 +52,15 @@ public class QueryResultImpl implements 
      * Constructor.
      */
     public QueryResultImpl(Session session, ObjectData objectData) {
+        propertiesById = new LinkedHashMap<String, PropertyData<?>>();
+        propertiesByQueryName = new LinkedHashMap<String, PropertyData<?>>();
+
         if (objectData != null) {
 
             ObjectFactory of = session.getObjectFactory();
 
             // handle properties
             if (objectData.getProperties() != null) {
-                propertiesById = new LinkedHashMap<String, PropertyData<?>>();
-                propertiesByQueryName = new LinkedHashMap<String, PropertyData<?>>();
-
                 List<PropertyData<?>> queryProperties = of.convertQueryProperties(objectData.getProperties());
 
                 for (PropertyData<?> property : queryProperties) {
@@ -95,46 +95,20 @@ public class QueryResultImpl implements 
         }
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see org.apache.opencmis.client.api.QueryResult#getProperties()
-     */
     public List<PropertyData<?>> getProperties() {
         return new ArrayList<PropertyData<?>>(propertiesByQueryName.values());
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyById(java.lang.
-     * String)
-     */
     @SuppressWarnings("unchecked")
     public <T> PropertyData<T> getPropertyById(String id) {
         return (PropertyData<T>) propertiesById.get(id);
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyByQueryName(java
-     * .lang.String)
-     */
     @SuppressWarnings("unchecked")
     public <T> PropertyData<T> getPropertyByQueryName(String queryName) {
         return (PropertyData<T>) propertiesByQueryName.get(queryName);
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyValueById(java.
-     * lang.String)
-     */
     public <T> T getPropertyValueById(String id) {
         PropertyData<T> property = getPropertyById(id);
         if (property == null) {
@@ -144,13 +118,6 @@ public class QueryResultImpl implements 
         return property.getFirstValue();
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyValueByQueryName
-     * (java.lang.String)
-     */
     public <T> T getPropertyValueByQueryName(String queryName) {
         PropertyData<T> property = getPropertyByQueryName(queryName);
         if (property == null) {
@@ -160,13 +127,6 @@ public class QueryResultImpl implements 
         return property.getFirstValue();
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyMultivalueById(
-     * java.lang.String)
-     */
     public <T> List<T> getPropertyMultivalueById(String id) {
         PropertyData<T> property = getPropertyById(id);
         if (property == null) {
@@ -176,13 +136,6 @@ public class QueryResultImpl implements 
         return property.getValues();
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see
-     * org.apache.opencmis.client.api.QueryResult#getPropertyMultivalueByQueryName
-     * (java.lang.String)
-     */
     public <T> List<T> getPropertyMultivalueByQueryName(String queryName) {
         PropertyData<T> property = getPropertyByQueryName(queryName);
         if (property == null) {
@@ -192,29 +145,14 @@ public class QueryResultImpl implements 
         return property.getValues();
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see org.apache.opencmis.client.api.QueryResult#getAllowableActions()
-     */
     public AllowableActions getAllowableActions() {
         return allowableActions;
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see org.apache.opencmis.client.api.QueryResult#getRelationships()
-     */
     public List<Relationship> getRelationships() {
         return relationships;
     }
 
-    /*
-     * (non-Javadoc)
-     * 
-     * @see org.apache.opencmis.client.api.QueryResult#getRenditions()
-     */
     public List<Rendition> getRenditions() {
         return renditions;
     }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/RenditionImpl.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/RenditionImpl.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/RenditionImpl.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-client/chemistry-opencmis-client-impl/src/main/java/org/apache/chemistry/opencmis/client/runtime/RenditionImpl.java
Wed Oct 30 23:24:33 2013
@@ -79,7 +79,7 @@ public class RenditionImpl extends Rendi
     }
 
     public ContentStream getContentStream() {
-        if ((objectId == null) || (getStreamId() == null)) {
+        if (objectId == null || getStreamId() == null) {
             return null;
         }
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/ChangeEventInfo.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/ChangeEventInfo.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/ChangeEventInfo.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/ChangeEventInfo.java
Wed Oct 30 23:24:33 2013
@@ -30,14 +30,14 @@ public interface ChangeEventInfo extends
     /**
      * Returns the change event type.
      * 
-     * @return the change event type
+     * @return the change event type, not {@code null}
      */
     ChangeType getChangeType();
 
     /**
      * Returns when the change took place.
      * 
-     * @return the timespamp of the change
+     * @return the timespamp of the change, not {@code null}
      */
     GregorianCalendar getChangeTime();
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/MutableContentStream.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/MutableContentStream.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/MutableContentStream.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-api/src/main/java/org/apache/chemistry/opencmis/commons/data/MutableContentStream.java
Wed Oct 30 23:24:33 2013
@@ -35,7 +35,7 @@ public interface MutableContentStream ex
     void setFileName(String filename);
 
     /**
-     * Sets the length of the stream
+     * Sets the length of the stream.
      * 
      * @param length
      *            the length of the stream in bytes or {@code null} if the
@@ -52,7 +52,7 @@ public interface MutableContentStream ex
     void setMimeType(String mimeType);
 
     /**
-     * Sets the stream
+     * Sets the stream.
      * 
      * @param stream
      *            the stream

Modified: chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-impl/src/main/java/org/apache/chemistry/opencmis/commons/impl/XMLConstraints.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-impl/src/main/java/org/apache/chemistry/opencmis/commons/impl/XMLConstraints.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-impl/src/main/java/org/apache/chemistry/opencmis/commons/impl/XMLConstraints.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-commons/chemistry-opencmis-commons-impl/src/main/java/org/apache/chemistry/opencmis/commons/impl/XMLConstraints.java
Wed Oct 30 23:24:33 2013
@@ -25,6 +25,6 @@ public final class XMLConstraints {
 
     public static final int MAX_STRING_LENGTH = 100 * 1024;
 
-    public static final int MAX_EXTENSIONS_WIDTH = 100;
-    public static final int MAX_EXTENSIONS_DEPTH = 10;
+    public static final int MAX_EXTENSIONS_WIDTH = 500;
+    public static final int MAX_EXTENSIONS_DEPTH = 20;
 }

Modified: chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService.java
Wed Oct 30 23:24:33 2013
@@ -65,7 +65,7 @@ import com.sun.xml.ws.developer.Streamin
  * CMIS Object Service.
  */
 @MTOM
-@StreamingAttachment(parseEagerly = true, memoryThreshold = 4 * 1024 * 1204)
+@StreamingAttachment(parseEagerly = false, memoryThreshold = 4 * 1024 * 1204)
 @WebService(endpointInterface = "org.apache.chemistry.opencmis.commons.impl.jaxb.ObjectServicePort")
 public class ObjectService extends AbstractService implements ObjectServicePort {
     @Resource

Modified: chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService10.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService10.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService10.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/ObjectService10.java
Wed Oct 30 23:24:33 2013
@@ -27,7 +27,7 @@ import com.sun.xml.ws.developer.Streamin
  * CMIS 1.0 Object Service. Excludes CMIS 1.1 operations.
  */
 @MTOM
-@StreamingAttachment(parseEagerly = true, memoryThreshold = 4 * 1024 * 1204)
+@StreamingAttachment(parseEagerly = false, memoryThreshold = 4 * 1024 * 1204)
 @WebService(endpointInterface = "org.apache.chemistry.opencmis.server.impl.webservices.ObjectServicePort10")
 public class ObjectService10 extends ObjectService {
 

Modified: chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/VersioningService.java
URL: http://svn.apache.org/viewvc/chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/VersioningService.java?rev=1537341&r1=1537340&r2=1537341&view=diff
==============================================================================
--- chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/VersioningService.java
(original)
+++ chemistry/opencmis/trunk/chemistry-opencmis-server/chemistry-opencmis-server-bindings/src/main/java/org/apache/chemistry/opencmis/server/impl/webservices/VersioningService.java
Wed Oct 30 23:24:33 2013
@@ -53,7 +53,7 @@ import com.sun.xml.ws.developer.Streamin
  * CMIS Versioning Service.
  */
 @MTOM
-@StreamingAttachment(parseEagerly = true, memoryThreshold = 4 * 1024 * 1204)
+@StreamingAttachment(parseEagerly = false, memoryThreshold = 4 * 1024 * 1204)
 @WebService(endpointInterface = "org.apache.chemistry.opencmis.commons.impl.jaxb.VersioningServicePort")
 public class VersioningService extends AbstractService implements VersioningServicePort {
     @Resource



Mime
View raw message