org.apache.chemistry.opencmis.client.api.CmisObject Maven / Gradle / Ivy
/*
* 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.api;
import java.util.List;
import java.util.Map;
import org.apache.chemistry.opencmis.commons.data.Ace;
import org.apache.chemistry.opencmis.commons.data.Acl;
import org.apache.chemistry.opencmis.commons.data.AllowableActions;
import org.apache.chemistry.opencmis.commons.data.CmisExtensionElement;
import org.apache.chemistry.opencmis.commons.enums.AclPropagation;
import org.apache.chemistry.opencmis.commons.enums.ExtensionLevel;
import org.apache.chemistry.opencmis.commons.exceptions.CmisObjectNotFoundException;
/**
* Base interface for all CMIS objects.
*/
public interface CmisObject extends ObjectId, CmisObjectProperties {
// object
/**
* Returns the allowable actions if they have been fetched for this object.
*
* @cmis 1.0
*/
AllowableActions getAllowableActions();
/**
* Returns the relationships if they have been fetched for this object.
*
* @cmis 1.0
*/
List getRelationships();
/**
* Returns the ACL if it has been fetched for this object.
*
* @cmis 1.0
*/
Acl getAcl();
// object service
/**
* Deletes this object. If this object is a document, the whole version
* series is deleted.
*
* @cmis 1.0
*/
void delete();
/**
* Deletes this object.
*
* @param allVersions
* if this object is a document this parameter defines if only
* this version or all versions should be deleted
*
* @cmis 1.0
*/
void delete(boolean allVersions);
/**
* Updates the provided properties and refreshes this object afterwards. If
* the repository created a new object, for example a new version, this new
* object is returned. Otherwise the current object is returned.
*
* @param properties
* the properties to update
*
* @return the updated object
*
* @cmis 1.0
*/
CmisObject updateProperties(Map properties);
/**
* Updates the provided properties. If the repository created a new object,
* for example a new version, the object id of the new object is returned.
* Otherwise the object id of the current object is returned.
*
* @param properties
* the properties to update
* @param refresh
* indicates if this object should be refresh after the update
*
* @return the object id of the updated object
*
* @cmis 1.0
*/
ObjectId updateProperties(Map properties, boolean refresh);
// renditions
/**
* Returns the renditions if they have been fetched for this object.
*
* @cmis 1.0
*/
List getRenditions();
// policy service
/**
* Applies the provided policies and refreshes this object afterwards.
*
* @cmis 1.0
*/
void applyPolicy(ObjectId... policyIds);
/**
* Remove the provided policies and refreshes this object afterwards.
*
* @cmis 1.0
*/
void removePolicy(ObjectId... policyIds);
/**
* Returns the applied policies if they have been fetched for this object.
*
* @cmis 1.0
*/
List getPolicies();
// ACL service
/**
* Adds and removes ACEs to the object and refreshes this object afterwards.
*
* @return the new ACL of this object
*
* @cmis 1.0
*/
Acl applyAcl(List addAces, List removeAces, AclPropagation aclPropagation);
/**
* Adds ACEs to the object and refreshes this object afterwards.
*
* @return the new ACL of this object
*
* @cmis 1.0
*/
Acl addAcl(List addAces, AclPropagation aclPropagation);
/**
* Removes ACEs to the object and refreshes this object afterwards.
*
* @return the new ACL of this object
*
* @cmis 1.0
*/
Acl removeAcl(List removeAces, AclPropagation aclPropagation);
/**
* Removes the direct ACE of this object, sets the provided ACEs to the
* object and refreshes this object afterwards.
*
* @return the new ACL of this object
*
* @cmis 1.0
*/
Acl setAcl(List aces);
// extensions
/**
* Returns the extensions for the given level.
*
* @cmis 1.0
*/
List getExtensions(ExtensionLevel level);
// adapters
/**
* Returns an adapter based on the given interface.
*/
T getAdapter(Class adapterInterface);
/**
* Returns a transient object adapter.
*
* @see TransientCmisObject
*
* @deprecated Support for transient objects will be removed in the future.
*/
@Deprecated
TransientCmisObject getTransientObject();
// session handling
/**
* Returns the timestamp (in milliseconds) of the last refresh.
*/
long getRefreshTimestamp();
/**
* Reloads this object from the repository.
*
* If the object doesn't exist anymore in the repository, a
* {@link CmisObjectNotFoundException} is thrown.
*/
void refresh();
/**
* Reloads the data from the repository if the last refresh did not occur
* within durationInMillis.
*
* If the object doesn't exist anymore in the repository, a
* {@link CmisObjectNotFoundException} is thrown.
*/
void refreshIfOld(long durationInMillis);
}