/*
* 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 org.apache.chemistry.opencmis.client.runtime;
import java.math.BigInteger;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.apache.chemistry.opencmis.client.api.CmisObject;
import org.apache.chemistry.opencmis.client.api.Document;
import org.apache.chemistry.opencmis.client.api.FileableCmisObject;
import org.apache.chemistry.opencmis.client.api.Folder;
import org.apache.chemistry.opencmis.client.api.ObjectFactory;
import org.apache.chemistry.opencmis.client.api.ObjectId;
import org.apache.chemistry.opencmis.client.api.ObjectType;
import org.apache.chemistry.opencmis.client.api.OperationContext;
import org.apache.chemistry.opencmis.client.api.ItemIterable;
import org.apache.chemistry.opencmis.client.api.Policy;
import org.apache.chemistry.opencmis.client.api.Tree;
import org.apache.chemistry.opencmis.client.runtime.util.AbstractPageFetch;
import org.apache.chemistry.opencmis.client.runtime.util.CollectionIterable;
import org.apache.chemistry.opencmis.client.runtime.util.TreeImpl;
import org.apache.chemistry.opencmis.commons.PropertyIds;
import org.apache.chemistry.opencmis.commons.data.Ace;
import org.apache.chemistry.opencmis.commons.data.ContentStream;
import org.apache.chemistry.opencmis.commons.data.FailedToDeleteData;
import org.apache.chemistry.opencmis.commons.data.ObjectData;
import org.apache.chemistry.opencmis.commons.data.ObjectInFolderContainer;
import org.apache.chemistry.opencmis.commons.data.ObjectInFolderData;
import org.apache.chemistry.opencmis.commons.data.ObjectInFolderList;
import org.apache.chemistry.opencmis.commons.data.ObjectList;
import org.apache.chemistry.opencmis.commons.data.PropertyData;
import org.apache.chemistry.opencmis.commons.data.PropertyString;
import org.apache.chemistry.opencmis.commons.enums.BaseTypeId;
import org.apache.chemistry.opencmis.commons.enums.IncludeRelationships;
import org.apache.chemistry.opencmis.commons.enums.UnfileObject;
import org.apache.chemistry.opencmis.commons.enums.Updatability;
import org.apache.chemistry.opencmis.commons.enums.VersioningState;
import org.apache.chemistry.opencmis.commons.exceptions.CmisRuntimeException;
import org.apache.chemistry.opencmis.commons.spi.NavigationService;
public class PersistentFolderImpl extends AbstractPersistentFilableCmisObject implements Folder {
private static final Set<Updatability> CREATE_UPDATABILITY = new HashSet<Updatability>();
static {
CREATE_UPDATABILITY.add(Updatability.ONCREATE);
CREATE_UPDATABILITY.add(Updatability.READWRITE);
}
/**
* Constructor.
*/
public PersistentFolderImpl(PersistentSessionImpl session, ObjectType objectType, ObjectData objectData,
OperationContext context) {
initialize(session, objectType, objectData, context);
}
public Document createDocument(Map<String, ?> properties, ContentStream contentStream,
VersioningState versioningState, List<Policy> policies, List<Ace> addAces, List<Ace> removeAces,
OperationContext context) {
if ((properties == null) || (properties.isEmpty())) {
throw new IllegalArgumentException("Properties must not be empty!");
}
String objectId = getObjectId();
ObjectFactory of = getObjectFactory();
String newId = getBinding().getObjectService().createDocument(getRepositoryId(),
of.convertProperties(properties, null, CREATE_UPDATABILITY), objectId,
of.convertContentStream(contentStream), versioningState, of.convertPolicies(policies),
of.convertAces(addAces), of.convertAces(removeAces), null);
// if no context is provided the object will not be fetched
if ((context == null) || (newId == null)) {
return null;
}
// get the new object
CmisObject object = getSession().getObject(getSession().createObjectId(newId), context);
if (!(object instanceof Document)) {
throw new CmisRuntimeException("Newly created object is not a document! New id: " + newId);
}
return (Document) object;
}
public Document createDocumentFromSource(ObjectId source, Map<String, ?> properties,
VersioningState versioningState, List<Policy> policies, List<Ace> addAces, List<Ace> removeAces,
OperationContext context) {
if ((source == null) || (source.getId() == null)) {
throw new IllegalArgumentException("Source must be set!");
}
String objectId = getObjectId();
// get the type of the source document
ObjectType type = null;
if (source instanceof CmisObject) {
type = ((CmisObject) source).getBaseType();
} else {
CmisObject sourceObj = getSession().getObject(source);
type = sourceObj.getType();
}
if (type.getBaseTypeId() != BaseTypeId.CMIS_DOCUMENT) {
throw new IllegalArgumentException("Source object must be a document!");
}
ObjectFactory of = getObjectFactory();
Set<Updatability> updatebility = new HashSet<Updatability>();
updatebility.add(Updatability.READWRITE);
String newId = getBinding().getObjectService().createDocumentFromSource(getRepositoryId(), source.getId(),
of.convertProperties(properties, type, updatebility), objectId, versioningState,
of.convertPolicies(policies), of.convertAces(addAces), of.convertAces(removeAces), null);
// if no context is provided the object will not be fetched
if ((context == null) || (newId == null)) {
return null;
}
// get the new object
CmisObject object = getSession().getObject(getSession().createObjectId(newId), context);
if (!(object instanceof Document)) {
throw new CmisRuntimeException("Newly created object is not a document! New id: " + newId);
}
return (Document) object;
}
public Folder createFolder(Map<String, ?> properties, List<Policy> policies, List<Ace> addAces,
List<Ace> removeAces, OperationContext context) {
if ((properties == null) || (properties.isEmpty())) {
throw new IllegalArgumentException("Properties must not be empty!");
}
String objectId = getObjectId();
ObjectFactory of = getObjectFactory();
String newId = getBinding().getObjectService().createFolder(getRepositoryId(),
of.convertProperties(properties, null, CREATE_UPDATABILITY), objectId, of.convertPolicies(policies),
of.convertAces(addAces), of.convertAces(removeAces), null);
// if no context is provided the object will not be fetched
if ((context == null) || (newId == null)) {
return null;
}
// get the new object
CmisObject object = getSession().getObject(getSession().createObjectId(newId), context);
if (!(object instanceof Folder)) {
throw new CmisRuntimeException("Newly created object is not a folder! New id: " + newId);
}
return (Folder) object;
}
public Policy createPolicy(Map<String, ?> properties, List<Policy> policies, List<Ace> addAces,
List<Ace> removeAces, OperationContext context) {
if ((properties == null) || (properties.isEmpty())) {
throw new IllegalArgumentException("Properties must not be empty!");
}
String objectId = getObjectId();
ObjectFactory of = getObjectFactory();
String newId = getBinding().getObjectService().createPolicy(getRepositoryId(),
of.convertProperties(properties, null, CREATE_UPDATABILITY), objectId, of.convertPolicies(policies),
of.convertAces(addAces), of.convertAces(removeAces), null);
// if no context is provided the object will not be fetched
if ((context == null) || (newId == null)) {
return null;
}
// get the new object
CmisObject object = getSession().getObject(getSession().createObjectId(newId), context);
if (!(object instanceof Policy)) {
throw new CmisRuntimeException("Newly created object is not a policy! New id: " + newId);
}
return (Policy) object;
}
public List<String> deleteTree(boolean allVersions, UnfileObject unfile, boolean continueOnFailure) {
String repositoryId = getRepositoryId();
String objectId = getObjectId();
FailedToDeleteData failed = getBinding().getObjectService().deleteTree(repositoryId, objectId, allVersions,
unfile, continueOnFailure, null);
return failed.getIds();
}
public List<ObjectType> getAllowedChildObjectTypes() {
List<ObjectType> result = new ArrayList<ObjectType>();
readLock();
try {
List<String> otids = getPropertyMultivalue(PropertyIds.ALLOWED_CHILD_OBJECT_TYPE_IDS);
if (otids == null) {
return result;
}
for (String otid : otids) {
result.add(getSession().getTypeDefinition(otid));
}
} finally {
readUnlock();
}
return result;
}
public ItemIterable<Document> getCheckedOutDocs() {
return getCheckedOutDocs(getSession().getDefaultContext());
}
public ItemIterable<Document> getCheckedOutDocs(OperationContext context) {
final String objectId = getObjectId();
final NavigationService navigationService = getBinding().getNavigationService();
final ObjectFactory objectFactory = getSession().getObjectFactory();
final OperationContext ctxt = new OperationContextImpl(context);
return new CollectionIterable<Document>(new AbstractPageFetch<Document>(ctxt.getMaxItemsPerPage()) {
@Override
protected AbstractPageFetch.PageFetchResult<Document> fetchPage(long skipCount) {
// get checked out documents for this folder
ObjectList checkedOutDocs = navigationService.getCheckedOutDocs(getRepositoryId(), objectId, ctxt
.getFilterString(), ctxt.getOrderBy(), ctxt.isIncludeAllowableActions(), ctxt
.getIncludeRelationships(), ctxt.getRenditionFilterString(), BigInteger
.valueOf(this.maxNumItems), BigInteger.valueOf(skipCount), null);
// convert objects
List<Document> page = new ArrayList<Document>();
if (checkedOutDocs.getObjects() != null) {
for (ObjectData objectData : checkedOutDocs.getObjects()) {
CmisObject doc = objectFactory.convertObject(objectData, ctxt);
if (!(doc instanceof Document)) {
// should not happen...
continue;
}
page.add((Document) doc);
}
}
return new AbstractPageFetch.PageFetchResult<Document>(page, checkedOutDocs.getNumItems(),
checkedOutDocs.hasMoreItems());
}
});
}
public ItemIterable<CmisObject> getChildren() {
return getChildren(getSession().getDefaultContext());
}
public ItemIterable<CmisObject> getChildren(OperationContext context) {
final String objectId = getObjectId();
final NavigationService navigationService = getBinding().getNavigationService();
final ObjectFactory objectFactory = getSession().getObjectFactory();
final OperationContext ctxt = new OperationContextImpl(context);
return new CollectionIterable<CmisObject>(new AbstractPageFetch<CmisObject>(ctxt.getMaxItemsPerPage()) {
@Override
protected AbstractPageFetch.PageFetchResult<CmisObject> fetchPage(long skipCount) {
// get the children
ObjectInFolderList children = navigationService.getChildren(getRepositoryId(), objectId, ctxt
.getFilterString(), ctxt.getOrderBy(), ctxt.isIncludeAllowableActions(), ctxt
.getIncludeRelationships(), ctxt.getRenditionFilterString(), ctxt.isIncludePathSegments(),
BigInteger.valueOf(this.maxNumItems), BigInteger.valueOf(skipCount), null);
// convert objects
List<CmisObject> page = new ArrayList<CmisObject>();
List<ObjectInFolderData> childObjects = children.getObjects();
if (childObjects != null) {
for (ObjectInFolderData objectData : childObjects) {
if (objectData.getObject() != null) {
page.add(objectFactory.convertObject(objectData.getObject(), ctxt));
}
}
}
return new AbstractPageFetch.PageFetchResult<CmisObject>(page, children.getNumItems(), children
.hasMoreItems());
}
});
}
public List<Tree<FileableCmisObject>> getDescendants(int depth) {
return getDescendants(depth, getSession().getDefaultContext());
}
public List<Tree<FileableCmisObject>> getDescendants(int depth, OperationContext context) {
String objectId = getObjectId();
// get the descendants
List<ObjectInFolderContainer> providerContainerList = getBinding().getNavigationService().getDescendants(
getRepositoryId(), objectId, BigInteger.valueOf(depth), context.getFilterString(),
context.isIncludeAllowableActions(), context.getIncludeRelationships(),
context.getRenditionFilterString(), context.isIncludePathSegments(), null);
return convertProviderContainer(providerContainerList, context);
}
public List<Tree<FileableCmisObject>> getFolderTree(int depth) {
return getFolderTree(depth, getSession().getDefaultContext());
}
public List<Tree<FileableCmisObject>> getFolderTree(int depth, OperationContext context) {
String objectId = getObjectId();
// get the folder tree
List<ObjectInFolderContainer> providerContainerList = getBinding().getNavigationService().getFolderTree(
getRepositoryId(), objectId, BigInteger.valueOf(depth), context.getFilterString(),
context.isIncludeAllowableActions(), context.getIncludeRelationships(),
context.getRenditionFilterString(), context.isIncludePathSegments(), null);
return convertProviderContainer(providerContainerList, context);
}
/**
* Converts a provider container into an API container.
*/
private List<Tree<FileableCmisObject>> convertProviderContainer(
List<ObjectInFolderContainer> providerContainerList, OperationContext context) {
if (providerContainerList == null) {
return null;
}
ObjectFactory of = getSession().getObjectFactory();
List<Tree<FileableCmisObject>> result = new ArrayList<Tree<FileableCmisObject>>();
for (ObjectInFolderContainer oifc : providerContainerList) {
if ((oifc.getObject() == null) || (oifc.getObject().getObject() == null)) {
// shouldn't happen ...
continue;
}
// convert the object
CmisObject object = of.convertObject(oifc.getObject().getObject(), context);
if (!(object instanceof FileableCmisObject)) {
// the repository must not return objects that are not fileable,
// but you never know...
continue;
}
// convert the children
List<Tree<FileableCmisObject>> children = convertProviderContainer(oifc.getChildren(), context);
// add both to current container
result.add(new TreeImpl<FileableCmisObject>((FileableCmisObject) object, children));
}
return result;
}
public boolean isRootFolder() {
String objectId = getObjectId();
String rootFolderId = getSession().getRepositoryInfo().getRootFolderId();
return objectId.equals(rootFolderId);
}
public Folder getFolderParent() {
if (isRootFolder()) {
return null;
}
List<Folder> parents = super.getParents();
if ((parents == null) || (parents.isEmpty())) {
return null;
}
return parents.get(0);
}
public String getPath() {
String path;
readLock();
try {
// get the path property
path = getPropertyValue(PropertyIds.PATH);
// if the path property isn't set, get it
if (path == null) {
String objectId = getObjectId();
ObjectData objectData = getBinding().getObjectService().getObject(getRepositoryId(), objectId,
getPropertyQueryName(PropertyIds.PATH), false, IncludeRelationships.NONE, "cmis:none", false,
false, null);
if ((objectData.getProperties() != null) && (objectData.getProperties().getProperties() != null)) {
PropertyData<?> pathProperty = objectData.getProperties().getProperties().get(PropertyIds.PATH);
if (pathProperty instanceof PropertyString) {
path = ((PropertyString) pathProperty).getFirstValue();
}
}
}
} finally {
readUnlock();
}
// we still don't know the path ... it's not a CMIS compliant repository
if (path == null) {
throw new CmisRuntimeException("Repository didn't return " + PropertyIds.PATH + "!");
}
return path;
}
@Override
public List<String> getPaths() {
return Collections.singletonList(getPath());
}
}