mirror of
https://github.com/Alfresco/alfresco-community-repo.git
synced 2025-10-22 15:12:38 +00:00
Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-5 to HEAD:
20678: DAO5 branch: Preparation for merge back to HEAD
20689: Merged DAO4 to DAO5
- Removed all 'dbscripts/create/3.x/SomeDialect' and replaced with 'dbscripts/create/SomeDialect'
DB create scripts are taken from latest DAO4
- TODO: FixAuthoritiesCrcValuesPatch needs query implementation in PatchDAO
Merged DAO3 to DAO4
- Reapplied fixes for ALF-713 (race condition on Usages)
19350: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-2 to BRANCHES/DEV/V3.3-DAO-REFACTOR-3:
18939: SAIL-4 :2nd stage branch for DAO refactor off HEAD rev 18898
18948: Merged V3.3-DAO-REFACTOR to V3.3-DAO-REFACTOR-2
18202: Dev branch for DAO refactor
18252: SAIL-233: QName.hbm.xml
18295: Added missing CREATE TABLE statements for QName-related code
18324: SAIL-234: Node.hbm.xml: Node aspects initial integration
18355: Added 'setValue' method to manually update the cached value
18356: MV property stressing lowered to speed test up
18357: SAIL-234: Node.hbm.xml
18376: Pulled all Alfresco-related create SQL into script
18389: SAIL-234: Permissions DAO refactor - initial checkpoint
18390: Formatting only (line-endings)
18400: SAIL-234: Node.hbm.xml
18418: SAIL-234: Node.hbm.xml: 'alf_node_assoc' CRUD
18429: SAIL-234: Node.hbm.xml: Cleaned out all Hibernate references to NodeAssocImpl
18457: SAIL-234: Permissions DAO refactor
18959: Merged DEV/V3.3-DAO-REFACTOR to DEV/V3.3-DAO-REFACTOR-2
18479: SAIL-234: Node.hbm.xml - fix updateNode (missing id when saving oldDummyNode)
18482: SAIL-235: remove Permissions.hbm.xml
18517: SAIL-235: Permissions DAO refactor
18523: SAIL-234: Node.hbm.xml
18524: SAIL-235: Permissions DAO refactor
18960: Merged DEV/V3.3-DAO-REFACTOR to DEV/V3.3-DAO-REFACTOR-2
18533: Flipped back to Windows line endings
18535: Formatting-only (eol)
18540: Formatting-only (eol)
18541: SAIL-235: Permissions DAO refactor
18543: SAIL-234: Node.hbm.xml: Start alf_store changes
18567: SAIL-235: Permissions DAO refactor
18596: SAIL-305: Alfresco DDL - formatted/rationalized and added missing indexes & fk constraints
18603: SAIL-311: Minor cleanup for schema upgrade scripts (V3.3)
18604: SAIL-311: Remove empty dirs
18619: SAIL-274: Locale.hbm.xml
18621: Added method to create default ACL
18622: SAIL-234: Node.hbm.xml: Store, Transaction, Server and some node
18624: Formatting only (eol)
18631: SAIL-235: Permissions DAO refactor
18633: SAIL-235: Permissions DAO refactor - do not expose CRUD for AceContext (or AuthorityAlias) since currently unused
18639: getLocale(Locale) should return null if it doesn't exist
18640: SAIL-234 NodeDAO: More replacement of node queries and updates
18648: SAIL-310: Create SQL script for core repo tables (All DB ports)
18651: SAIL-234 NodeDAO: Moves across stores handle presence of target deleted nodes
18961: Merged DEV/V3.3-DAO-REFACTOR to DEV/V3.3-DAO-REFACTOR-2
18658: SAIL-274 Locale DAO: Missing getValueKey() method
18662: SAIL-235: Permissions DAO refactor - further cleanup (of DbAccessControlList usage, including copyACLs)
18664: DB scripts porting for PostgreSQL finished.
18668: SAIL-234 Node DAO: Note in case Transaction Change ID is dropped from indexes
18669: SAIL-234 Node DAO: deleteNode and archive (store move) fixes
18672: DB scripts porting for Oracle finished.
18675: SAIL-235: Permissions DAO refactor
18677: DB scripts porting for DB2 finished.
18964: Merged DEV/V3.3-DAO-REFACTOR to DEV/V3.3-DAO-REFACTOR-2
18687: Execute a callback with retries
18688: SAIL-234 Node DAO: Child association creation
18690: SAIL-234 Node DAO: Comment out raw creation of stores as it breaks subsequent bootstrap checks
18691: SAIL-234 Node DAO: More replacement of alf_child_assoc handling
18713: Commented about needing a more efficient removeChildAssociation method
18714: SAIL-234 Node DAO: Replaced queries on alf_child_assoc
18715: SAIL-234 Node DAO: More alf_child_assoc query replacement
18727: SAIL-234 Node DAO: alf_child_assoc queries complete
18737: SAIL-234 Node DAO: Tweaks to newNode and implemented prependPaths
18741: SAIL-234 and SAIL-334: Moved UsageDelta Hibernate code and queries over to UsageDeltaDAO
18748: SAIL-234 Node DAO: fix NPE (EditionServiceImplTest)
18769: SAIL-234 Node DAO: alf_node_properties ground work
18786: SAIL-234 Node DAO: alf_node_properties and cm:auditable properties
18810: Added EqualsHelper.getMapComparison
18813: TransactionalCache propagates cache clears and removals during rollback
18826: SAIL-234 Node DAO: Moved over sundry references to NodeDaoService to NodeDAO
18849: SAIL-237: UsageDelta.hbm.xml - eol formatting only (including removal of unwanted svn:eol-style=native property)
18869: SAIL-234 NodeDAO: Fixed more references to 'nodeDaoService'
18895: SAIL-234 NodeDAO: Queries for alf_transaction
18899: SAIL-234 Node DAO: Fixed bean fetching for 'nodeDAO'
18909: SAIL-234 NodeDAO: Fixes to getNodeRefStatus and various txn queries
18916: SAIL-234 NodeDAO: Fixed moveNode alf_child_assoc updates
18922: SAIL-235: DAO refactoring: Permission.hbm.xml
18930: SAIL-235: DAO refactoring: Permission.hbm.xml
18932: SAIL-234 NodeDAO: Fixing up gotchas, javadocs and some naming
18933: SAIL-234 NodeDAO: Minor neatening
18935: SAIL-234 Node DAO: Caches for ID to NodeRef and StoreRef
18936: EHCache config files line endings
18938: SAIL-237: Usage DAO refactor - initial checkpoint
18945: SAIL-235: DAO refactoring: Permission.hbm.xml. Move Node.
18975: Fix for move-node ACL jiggery-pokery
19067: SAIL-4: fix VersionHistoryImpl.getSuccessors (causing VersionServiceImplTest.testGetVersionHistorySameWorkspace failure)
19068: SAIL-234: fix VersionMigratorTest.testMigrateOneVersion
19074: SAIL-237: Usage DAO - update to common iBatis mapping pattern(s) to ease DB porting
19076: SAIL-231: Activities DAO - update to common iBatis mapping pattern(s)
19077: SAIL-232: AppliedPatch DAO - minor cleanup (comments & formatting only)
19092: Merging HEAD to DEV/V3.3-DAO-REFACTOR-2
18973: Temporarily comment out AVMTestSuite and run AVM tests individually
19056: AVM unit test improvements
19097: SAIL-235: DAO refactoring: Permission.hbm.xml: Additional index to support queries to find the id and acl id for the primary children of a node.
19185: SAIL-238: Permissions DAO - (minor) update to common iBatis mapping pattern
19289: SAIL-234 NodeDAO: Node cache replaces NodeRef cache
19302: SAIL-234 Node DAO: Added cache for node properties
19318: SAIL-4: AVM DAO - (minor) update to common iBatis mapping pattern
20690: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-4 to BRANCHES/DEV/V3.3-DAO-REFACTOR-5:
20063: (RECORD ONLY) DAO refactor branch V4
20146: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
19401: SAIL-234 Node DAO: Fix permission service tests (setPrimaryChildrenSharedAclId needs to invalidate nodesCache)
19428: Fixed TransactionalCache issue with null and NullValueMarker
19429: Took empty cm:content creation out of FileFolderService#createImpl
19430: SAIL-234 Node DAO: Tweaks around caching and cm:auditable
19431: SAIL-4 DAO Refactor: Exception thrown when attempting writes in read-only txn have changed
19436: SAIL-234 Node DAO: Fix NPE during cm:auditable update
19475: Allow debugging of code without stepping into trivial stuff
19476: Follow-up on 19429 by ensuring CIFS/FTP set a mimetype on the ContentWriter
19477: SAIL-234 Node DAO: Leverage DAO better for NodeService.addProperties
19478: SAIL-234 NodeDAO: Added toString() for ParentAssocsInfo (cache value for parent assocs)
19479: SAIL-234 Node DAO: Fixed for parent association and property caches
19480: Made TransactionAwareSingleton bind-key a GUID
19481: SAIL-234 Node DAO: Reinstated 100K collection property tests
19482: SAIL-234 Node DAO: Node and property cache fixes highlighted by unit tests
19483: SAIL-234 Node DAO: Start on NodeBulkLoader implementation
19595: SAIL-234 Node DAO: Fix moveNode to detect cyclic relationship prior to updating ACLs for moved tree FileFolderServiceImplTest.testETHREEOH_3088_MoveIntoSelf)
20147: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
19602: (RECORD ONLY) Reintegrated with HEAD up to rev 19433
19621: (RECORD ONLY) SAIL-347
19683: (RECORD ONLY) Reverse-merged 19621 for SAIL-347
19722: (RECORD ONLY) Merged /alfresco/HEAD:r19434-19721
20150: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
19741: Merged DEV\V3.3-DAO-REFACTOR-2 to DEV\V3.3-DAO-REFACTOR-3
19739: Extended "move" tests
19743: Fix AuditableAspectTest.testAddAspect (to allow for node modified date tolerance)
19748: Remaining part of merge from HEAD to V3.3-DAO-REFACTOR-3
19367: Merged BRANCHES/V3.2 to HEAD:
19286: Fix for ALF-626 "Using 'null' as an authority argument in clearPermissions() cause a java.lang.NullPointerException"
19755: SAIL-234 Node DAO: Fix RepoAdminServiceImplTest.testConcurrentDynamicModelDelete (handle InvalidNodeRefException after getChildAssocs)
20692: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-4 to BRANCHES/DEV/V3.3-DAO-REFACTOR-5:
- Retired all 1.3 and 1.4 upgrade scripts ... R.I.P.
- Fixed CRC patch for Authorities (only tested on MySQL)
- Fixed SQL patch revision numbers and bumped version schema number up
20158: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
19773: SQL mappings and scripts: SAIL-310, SAIL-304, SAIL-303 and SAIL-347
19774: Futher fix for SAIL-310: Sequence patch must take into account sequences created for 3.3
19851: SAIL-371 (SAIL-294) NodeDAO fallout: Fix QName and Namespace read/write handling and bean name in unit test
20183: Merged DAO3 to DAO4
19852: SAIL-370: Remove LinkValidation
19853: SAIL-239 (SAIL-294) Attributes.hbm.xml: Added ability to attach arbitrary property to unique context
19857: SAIL-373 Fallout from Permissions DAO refactor (SAIL-235)
19864: SAIL-239 (SAIL-294): Removed AttributeService RMI API
19865: More SAIL-239 (SAIL-294): Removed AttributeService RMI API
20208: DAO-refactor implementation of ALF-2712 query improvements
20209: Merged BRANCHES/DEV/V3.3-DAO-REFACTOR-3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
20060: Removal of AttributeService for SAIL-239 (SAIL-294)
20348: SAIL-371 (SAIL-294): Protect collection properties during map insert and retrieval
20547: SAIL-371 (SAIL-294) Attributes.hbm.xml: implement getAttributes + fixes
20573: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests and other fallout
20597: SAIL-239 Attributes.hbm.xml: WCM/AVM locking test fixes (wip)
20598: SAIL-239 Attributes.hbm.xml: WCM/AVM locking test fixes (wip) - fix AssetServiceImplTest.testSimpleLockFile NPE
20600: Fix PropertyValueDAOTest.testPropertyValue_Enum (follow-on to r20060 for SAIL-239 - which introduces ENUM prop vals)
20601: Fix UsageDAOTest.testCreateAndDeleteUsageDeltas NPE (would also affect ContentStoreCleanerScalabilityRunner)
20603: Fix CMISPropertyServiceTest.* (fallout from r20146 <- r19429 <- Took empty cm:content creation out of FileFolderService#createImpl)
20604: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - TransferServiceImplTest.*
20618: SAIL-371 (SAIL-294): NodeDAO: AuditableAspectTest (fix testCreateNodeWithAuditableProperties_ALF_2565 + add remove aspect test)
20624: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - UserUsageTest.*
20626: Fixed random keys for RuleTrigger NodeRef tracking
20635: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - PersonTest.testSplitDuplicates
20642: SAIL-371 (SAIL-294) DAO: Fixed CacheTest
20643: Removed must of the 'distribute' target's dependencies. Not for HEAD
20645: Follow-on to r20643 (Removed most of the 'distribute' target's dependencies. Not for HEAD)
20654: SAIL-371 (SAIL-294): NodeDAO: DMDeploymentTargetTest.* (do not try to remove mandatory aspects)
20655: SAIL-371 (SAIL-294): NodeDAO: Initial fix for TaggingServiceImplTest.testTagScopeUpdateViaNodePolicies (+ minor test cleanup)
20657: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - VersionMigratorTest.testMigrateOneVersion (cm:accessed not returned if null)
20658: Merged (back merge only - no merge info) BRANCHES/V3.3 to BRANCHES/DEV/V3.3-DAO-REFACTOR-4:
20090: Dynamic models: minor improvements to DictionaryModelType
20554: Improvement to model delete validation (investigating intermittent failure of RepoAdminServiceImplTest.testSimpleDynamicModelViaNodeService)
20662: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - RecordsManagementAuditServiceImplTest.* (we now ignore attempt to update 'cm:modifier' prop so update 'cm:title' prop instead)
20666: SAIL-371 (SAIL-294): NodeDAO: Fix unit tests - ADMLuceneTest.*
20668: SAIL-239 (SAIL-294) - delete WCM locks + tests (follow-on to r20060)
20674: SAIL-371 (SAIL-294) NodeDAO fallout: Cleaner and additional checks for ContentStoreCleaner
20675: SAIL-371 (SAIL-294) NodeDAO fallout: Fixed handling of ContentData
git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@20693 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
This commit is contained in:
Derek Hulley
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright (C) 2005-2010 Alfresco Software Limited.
|
||||
* Copyright (C) 2005-2009 Alfresco Software Limited.
|
||||
*
|
||||
* This file is part of Alfresco
|
||||
*
|
||||
@@ -18,31 +18,6 @@
|
||||
*/
|
||||
package org.alfresco.repo.node.db;
|
||||
|
||||
import java.io.Serializable;
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Set;
|
||||
import java.util.Stack;
|
||||
|
||||
import org.alfresco.repo.domain.ChildAssoc;
|
||||
import org.alfresco.repo.domain.NodeAssoc;
|
||||
import org.alfresco.repo.domain.NodePropertyValue;
|
||||
import org.alfresco.repo.domain.PropertyMapKey;
|
||||
import org.alfresco.repo.domain.Transaction;
|
||||
import org.alfresco.repo.domain.hibernate.DirtySessionAnnotation;
|
||||
import org.alfresco.service.cmr.dictionary.DataTypeDefinition;
|
||||
import org.alfresco.service.cmr.dictionary.InvalidTypeException;
|
||||
import org.alfresco.service.cmr.repository.AssociationRef;
|
||||
import org.alfresco.service.cmr.repository.ChildAssociationRef;
|
||||
import org.alfresco.service.cmr.repository.CyclicChildRelationshipException;
|
||||
import org.alfresco.service.cmr.repository.NodeRef;
|
||||
import org.alfresco.service.cmr.repository.Path;
|
||||
import org.alfresco.service.cmr.repository.StoreExistsException;
|
||||
import org.alfresco.service.cmr.repository.StoreRef;
|
||||
import org.alfresco.service.namespace.QName;
|
||||
import org.alfresco.util.Pair;
|
||||
|
||||
/**
|
||||
* Service layer accessing persistent <b>node</b> entities directly
|
||||
*
|
||||
@@ -61,611 +36,4 @@ public interface NodeDaoService
|
||||
* Flush the data changes to the persistence layer.
|
||||
*/
|
||||
public void flush();
|
||||
|
||||
/**
|
||||
* Fetch a list of all stores in the repository
|
||||
*
|
||||
* @return Returns a list of stores
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public List<Pair<Long, StoreRef>> getStores();
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, NodeRef> getRootNode(StoreRef storeRef);
|
||||
|
||||
/**
|
||||
* Creates a unique store for the given protocol and identifier combination.
|
||||
* The root node is created with the "root" aspect.
|
||||
* @return Returns the root node, which is added automatically.
|
||||
* @throws StoreExistsException if the store already exists
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, NodeRef> createStore(StoreRef storeRef);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public NodeRef.Status getNodeRefStatus(NodeRef nodeRef);
|
||||
|
||||
/**
|
||||
* Create a new node. Note that allowing the <b>uuid</b> to be assigned by passing in a <tt>null</tt>
|
||||
* is more efficient.
|
||||
*
|
||||
* @param storeRef the store to which the node must belong
|
||||
* @param uuid the node store-unique identifier, or <tt>null</tt> to assign a GUID
|
||||
* @param nodeTypeQName the type of the node
|
||||
* @return Returns a new node Id of the given type and attached to the store
|
||||
* @throws InvalidTypeException if the node type is invalid or if the node type
|
||||
* is not a valid real node
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, NodeRef> newNode(StoreRef storeRef, String uuid, QName nodeTypeQName) throws InvalidTypeException;
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, NodeRef> moveNodeToStore(Long nodeId, StoreRef storeRef);
|
||||
|
||||
/**
|
||||
* @param nodeRef the node reference
|
||||
* @return Returns the <b>node</b> entity ID
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, NodeRef> getNodePair(NodeRef nodeRef);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, NodeRef> getNodePair(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public QName getNodeType(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void setNodeStatus(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Long getNodeAccessControlList(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void setNodeAccessControlList(Long nodeId, Long aclId);
|
||||
|
||||
/**
|
||||
* @param storeRef the new store or <tt>null</tt> to keep the existing one
|
||||
* @param uuid the new UUID for the node or <tt>null</tt> to keep it the same
|
||||
* @param nodeTypeQName the new type QName for the node or <tt>null</tt> to keep the existing one
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void updateNode(Long nodeId, StoreRef storeRef, String uuid, QName nodeTypeQName);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Serializable getNodeProperty(Long nodeId, QName propertyQName);
|
||||
|
||||
/**
|
||||
*
|
||||
* @param nodeId the node's ID
|
||||
* @return Returns a copy of the low-level properties including auditable properties
|
||||
* @throws ObjectNotFoundException if the node ID is invalid
|
||||
*
|
||||
* @see #getNodePair(NodeRef)
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Map<PropertyMapKey, NodePropertyValue> getNodePropertiesRaw(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Map<QName, Serializable> getNodeProperties(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void addNodeProperty(Long nodeId, QName qname, Serializable value);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void addNodeProperties(Long nodeId, Map<QName, Serializable> properties);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void removeNodeProperties(Long nodeId, Set<QName> propertyQNames);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void setNodeProperties(Long nodeId, Map<QName, Serializable> properties);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Set<QName> getNodeAspects(Long nodeId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void addNodeAspects(Long nodeId, Set<QName> aspectQNames);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void removeNodeAspects(Long nodeId, Set<QName> aspectQNames);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public boolean hasNodeAspect(Long nodeId, QName aspectQName);
|
||||
|
||||
/**
|
||||
* Deletes the node and all entities. Note that the node entry will still exist and be
|
||||
* associated with a live transaction.
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void deleteNode(Long nodeId);
|
||||
|
||||
/**
|
||||
* Remove all traces of the node. This assumes that the node has been marked
|
||||
* for deletion using {@link #deleteNode(Long)}.
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void purgeNode(Long nodeId);
|
||||
|
||||
/**
|
||||
* @param name the <b>cm:name</b> to apply to the association
|
||||
* @return Returns the persisted and filled association's ID
|
||||
*
|
||||
* @see ChildAssoc
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, ChildAssociationRef> newChildAssoc(
|
||||
Long parentNodeId,
|
||||
Long childNodeId,
|
||||
boolean isPrimary,
|
||||
QName assocTypeQName,
|
||||
QName qname,
|
||||
String name);
|
||||
|
||||
/**
|
||||
* Change the name of the child node.
|
||||
*
|
||||
* @param childId the child association to change
|
||||
* @param childName the name to put on the association
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void setChildNameUnique(Long assocId, String childName);
|
||||
|
||||
/**
|
||||
* @param index the association index. <b>-1</b> to keep the existing value
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, ChildAssociationRef> updateChildAssoc(
|
||||
Long childAssocId,
|
||||
Long parentNodeId,
|
||||
Long childNodeId,
|
||||
QName assocTypeQName,
|
||||
QName qname,
|
||||
int index,
|
||||
String childName);
|
||||
|
||||
/**
|
||||
* Interface used to iterate over results from child association queries
|
||||
* @author Derek Hulley
|
||||
*/
|
||||
public interface ChildAssocRefQueryCallback
|
||||
{
|
||||
/**
|
||||
*
|
||||
* @return Return <tt>true</tt> if resursion into the child node
|
||||
* is required.
|
||||
*/
|
||||
boolean handle(
|
||||
Pair<Long, ChildAssociationRef> childAssocPair,
|
||||
Pair<Long, NodeRef> parentNodePair,
|
||||
Pair<Long, NodeRef> childNodePair
|
||||
);
|
||||
|
||||
boolean preLoadNodes();
|
||||
}
|
||||
|
||||
/**
|
||||
* Interface used to iterate over results from child association queries
|
||||
* @author Derek Hulley
|
||||
*/
|
||||
public interface ChildAssocRefQueryCallbackFilter extends ChildAssocRefQueryCallback
|
||||
{
|
||||
/**
|
||||
* Method to handle raw query results and decide if the result should be filtered out or not.
|
||||
* If <tt>true</tt> is returned, the standard {@link #handle(Pair, Pair, Pair) handler} method
|
||||
* will be called. If <tt>false</tt> is returned, then the query result will be skipped.
|
||||
* <p>
|
||||
* This provides a quick way to filter out results without having to pull in full entities.
|
||||
*
|
||||
* @return Return <tt>true</tt> if the standard {@link #handle(Pair, Pair, Pair) handler}
|
||||
* method should be called, or <tt>false</tt> to filter the result out.
|
||||
*/
|
||||
boolean isDesiredRow(
|
||||
Pair<Long, ChildAssociationRef> childAssocPair,
|
||||
Pair<Long, NodeRef> parentNodePair,
|
||||
Pair<Long, NodeRef> childNodePair,
|
||||
String assocChildNodeName,
|
||||
Long assocChildNodeNameCrc
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get a collection of all child association references for a given parent node.
|
||||
* <p>
|
||||
* <b>WARNING:</b> Be sure selective when doing this call recursively.
|
||||
*
|
||||
* @param parentNodeId the parent node
|
||||
* @param resultsCallback the callback that will be called with the results
|
||||
* @param recurse if <tt>true</tt> then iterate over the entire tree of nodes.
|
||||
* Resursion is done top-down i.e. the first level children are all
|
||||
* enumerated first, followed by all second level children and so on.
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocs(Long parentNodeId, ChildAssocRefQueryCallback resultsCallback, boolean recurse);
|
||||
|
||||
/**
|
||||
* Get a collection of all child association references for a given parent node.
|
||||
*
|
||||
* @param parentNodeId the parent node
|
||||
* @param resultsCallback the callback that will be called with the results
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocs(Long parentNodeId, QName assocQName, ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Get a collection of all child associations references where the child name is an exact match.
|
||||
* This method only works if the association type fundamentally supports unique-name enforcement.
|
||||
*
|
||||
* @param parentNodeId the parent node
|
||||
* @param assocTypeQName the type of the association to check.
|
||||
* @param childNames the names of the child nodes (<b>cm:name</b>). These will be matched exactly.
|
||||
* @param resultsCallback the callback that will be called with the results
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocs(Long parentNodeId, QName assocTypeQName, Collection<String> childNames, ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocsByTypeQNames(
|
||||
Long parentNodeId,
|
||||
List<QName> assocTypeQNames,
|
||||
ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocsByTypeQNameAndQName(
|
||||
Long parentNodeId,
|
||||
QName assocTypeQName,
|
||||
QName assocQName,
|
||||
ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getChildAssocsByChildTypes(
|
||||
Long parentNodeId,
|
||||
Set<QName> childNodeTypeQNames,
|
||||
ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getPrimaryChildAssocs(Long parentNodeId, ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getPrimaryChildAssocsNotInSameStore(Long parentNodeId, ChildAssocRefQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Interface used to iterate over pure node results
|
||||
* @author Derek Hulley
|
||||
*/
|
||||
public interface NodeRefQueryCallback
|
||||
{
|
||||
/**
|
||||
*
|
||||
* @param nodePair the node result
|
||||
* @return Returns <tt>true</tt> if more results are required
|
||||
*/
|
||||
boolean handle(Pair<Long, NodeRef> nodePair);
|
||||
}
|
||||
|
||||
/**
|
||||
* Gets a set of nodes that have parents in the given store, but are themselves located in a different
|
||||
* store.
|
||||
*
|
||||
* @param storeId the store of the parent nodes
|
||||
* @param minNodeId the min node ID to return
|
||||
* @param count the maximum number of results
|
||||
* @param resultsCallback the node callback
|
||||
*
|
||||
* @deprecated Since 2.2SP6, 3.1SP2, 3.2: not performant and not relevant to any use-cases
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getNodesWithChildrenInDifferentStore(
|
||||
Long storeId,
|
||||
Long minNodeId,
|
||||
int count,
|
||||
NodeRefQueryCallback resultsCallback);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getNodesWithAspect(QName aspectQName, Long minNodeId, int count, NodeRefQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Gets the set of child associations of a certain parent node without parent associations of a certain type to
|
||||
* other nodes with the same parent! In effect the 'orphans' with respect to a certain association type.
|
||||
*
|
||||
* @param parentNodeId
|
||||
* the parent node ID
|
||||
* @param assocTypeQName
|
||||
* the association type QName
|
||||
* @param resultsCallback
|
||||
* the callback that will be called with the results
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty = false)
|
||||
public void getChildAssocsWithoutParentAssocsOfType(final Long parentNodeId, final QName assocTypeQName,
|
||||
ChildAssocRefQueryCallback resultsCallback);
|
||||
/**
|
||||
* @return Returns an association matching the given parent, type and child name (<b>cm:name</b>) - or <tt>null</tt> if not found
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, ChildAssociationRef> getChildAssoc(Long parentNodeId, QName assocTypeQName, String childName);
|
||||
|
||||
/**
|
||||
* @return Returns a matching association or null if one was not found
|
||||
*
|
||||
* @see ChildAssoc
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, ChildAssociationRef> getChildAssoc(
|
||||
Long parentNodeId,
|
||||
Long childNodeId,
|
||||
QName assocTypeQName,
|
||||
QName qname);
|
||||
|
||||
/**
|
||||
* Deletes an explicit child association.
|
||||
*
|
||||
* @return Returns <tt>true</tt> if the association was deleted, otherwise <tt>false</tt>
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public boolean deleteChildAssoc(
|
||||
final Long parentNodeId,
|
||||
final Long childNodeId,
|
||||
final QName assocTypeQName,
|
||||
final QName qname);
|
||||
|
||||
/**
|
||||
* @param assoc the child association to remove
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void deleteChildAssoc(Long childAssocId);
|
||||
|
||||
/**
|
||||
* Finds the association between the node's primary parent and the node itself
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, ChildAssociationRef> getPrimaryParentAssoc(Long childNodeId);
|
||||
|
||||
/**
|
||||
* Get all parent associations for the node. This methods includes a cache safety check.
|
||||
* @param childNode the child node
|
||||
* @return Returns all parent associations for the node.
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Collection<Pair<Long, ChildAssociationRef>> getParentAssocs(final Long childNodeId);
|
||||
|
||||
/**
|
||||
* @return Returns the persisted and filled association
|
||||
* @see NodeAssoc
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Pair<Long, AssociationRef> newNodeAssoc(
|
||||
Long sourceNodeId,
|
||||
Long targetNodeId,
|
||||
QName assocTypeQName);
|
||||
|
||||
/**
|
||||
* @return Returns a list of all node associations associated with the given node
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Collection<Pair<Long, AssociationRef>> getNodeAssocsToAndFrom(final Long nodeId);
|
||||
|
||||
/**
|
||||
* @return Returns the node association or null if not found
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Pair<Long, AssociationRef> getNodeAssoc(Long sourceNodeId, Long targetNodeId, QName assocTypeQName);
|
||||
|
||||
/**
|
||||
* Gets a node association by ID.
|
||||
*
|
||||
* @param assocId
|
||||
* the association id
|
||||
* @return the node association, or <code>null</code> if it does not exist
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty = false)
|
||||
public AssociationRef getNodeAssocOrNull(Long assocId);
|
||||
|
||||
/**
|
||||
* @return Returns all the node associations where the node is the <b>source</b>
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Collection<Pair<Long, AssociationRef>> getTargetNodeAssocs(Long sourceNodeId);
|
||||
|
||||
/**
|
||||
* @return Returns all the node associations where the node is the </b>target</b>
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Collection<Pair<Long, AssociationRef>> getSourceNodeAssocs(Long targetNodeId);
|
||||
|
||||
/**
|
||||
* @param assoc the node association to remove
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void deleteNodeAssoc(Long assocId);
|
||||
|
||||
/**
|
||||
* Iterate over all nodes that have a given property type with a given string value.
|
||||
*
|
||||
* @param storeRef the store to search in
|
||||
* @param propertyQName the qualified name of the property
|
||||
* @param value the string value to match
|
||||
* @param handler the callback to use while iterating over the URLs
|
||||
* @return Returns the values for the given type definition
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getPropertyValuesByPropertyAndValue(
|
||||
StoreRef storeRef,
|
||||
QName propertyQName,
|
||||
String value,
|
||||
NodePropertyHandler handler);
|
||||
|
||||
/**
|
||||
* Interface used to iterate over object array results
|
||||
*/
|
||||
public interface ObjectArrayQueryCallback
|
||||
{
|
||||
boolean handle(Object[] array);
|
||||
}
|
||||
|
||||
/**
|
||||
* Iterate over all content nodes to get owner/creator and content url (in order to extract content size)
|
||||
*
|
||||
* @param storeRef the store to search in
|
||||
* @param handler the callback to use while iterating over the URLs
|
||||
* @return Returns the values for the given owner, creator and content url
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getContentUrlsForStore(
|
||||
StoreRef storeRef,
|
||||
ObjectArrayQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Iterate over all person nodes with missing usage property (for one-off patch)
|
||||
*
|
||||
* @param storeRef the store to search in
|
||||
* @param handler the callback to use while iterating over the people
|
||||
* @return Returns the values for person node uuid
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getUsersWithoutUsageProp(
|
||||
StoreRef storeRef,
|
||||
ObjectArrayQueryCallback resultsCallback);
|
||||
|
||||
|
||||
/**
|
||||
* Iterate over all person nodes to get users without a calculated usage
|
||||
*
|
||||
* @param storeRef the store to search in
|
||||
* @param handler the callback to use while iterating over the people
|
||||
* @return Returns the values for username and person node uuid (excluding System)
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getUsersWithoutUsage(
|
||||
StoreRef storeRef,
|
||||
ObjectArrayQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Iterate over all person nodes to get users with a calculated usage
|
||||
*
|
||||
* @param storeRef the store to search in
|
||||
* @param handler the callback to use while iterating over the people
|
||||
* @return Returns the values for the username and person node uuid (excluding System)
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getUsersWithUsage(
|
||||
StoreRef storeRef,
|
||||
ObjectArrayQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Iterate over all property values for the given type definition. This will also dig out values that
|
||||
* were persisted as type <b>d:any</b>.
|
||||
*
|
||||
* @param actualDataTypeDefinition the persisted type to retrieve
|
||||
* @param handler the callback to use while iterating over the URLs
|
||||
* @return Returns the values for the given type definition
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void getPropertyValuesByActualType(DataTypeDefinition actualDataTypeDefinition, NodePropertyHandler handler);
|
||||
|
||||
/**
|
||||
* Gets a batch of deleted nodes in old transactions.
|
||||
*
|
||||
* @param minNodeId the minimum node ID
|
||||
* @param maxCommitTime the maximum commit time (to set a minimum transaction age)
|
||||
* @param count the maximum number of results (for batching)
|
||||
* @param resultsCallback the callback to pass results back
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void getNodesDeletedInOldTxns(Long minNodeId, long maxCommitTime, int count, NodeRefQueryCallback resultsCallback);
|
||||
|
||||
/**
|
||||
* Iterface to handle callbacks when iterating over properties
|
||||
*
|
||||
* @author Derek Hulley
|
||||
* @since 2.0
|
||||
*/
|
||||
public interface NodePropertyHandler
|
||||
{
|
||||
void handle(NodeRef nodeRef, QName nodeTypeQName, QName propertyQName, Serializable value);
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieves the maximum transaction ID for which the commit time is less than the given time.
|
||||
*
|
||||
* @param maxCommitTime the max commit time (ms)
|
||||
* @return the last transaction <i>on or before</i> the given time
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Long getMaxTxnIdByCommitTime(final long maxCommitTime);
|
||||
/**
|
||||
* Retrieves a specific transaction.
|
||||
*
|
||||
* @param txnId the unique transaction ID.
|
||||
* @return the requested transaction or <tt>null</tt>
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public Transaction getTxnById(long txnId);
|
||||
/**
|
||||
* Get all transactions in a given time range. Since time-based retrieval doesn't guarantee uniqueness
|
||||
* for any given millisecond, a list of optional exclusions may be provided.
|
||||
*
|
||||
* @param excludeTxnIds a list of txn IDs to ignore. <tt>null</tt> is allowed.
|
||||
* @param remoteOnly <tt>true</tt> if locally-written transactions must be ignored
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public List<Transaction> getTxnsByCommitTimeAscending(
|
||||
long fromTimeInclusive,
|
||||
long toTimeExclusive,
|
||||
int count,
|
||||
List<Long> excludeTxnIds,
|
||||
boolean remoteOnly);
|
||||
/**
|
||||
* Get all transactions in a given time range. Since time-based retrieval doesn't guarantee uniqueness
|
||||
* for any given millisecond, a list of optional exclusions may be provided.
|
||||
*
|
||||
* @param excludeTxnIds a list of txn IDs to ignore. <tt>null</tt> is allowed.
|
||||
* @param remoteOnly <tt>true</tt> if locally-written transactions must be ignored
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public List<Transaction> getTxnsByCommitTimeDescending(
|
||||
long fromTimeInclusive,
|
||||
long toTimeExclusive,
|
||||
int count,
|
||||
List<Long> excludeTxnIds,
|
||||
boolean remoteOnly);
|
||||
/**
|
||||
* Get the lowest commit time for a set of transactions
|
||||
*
|
||||
* @param includeTxnIds a list of transaction IDs to search for
|
||||
* @return Returns the transactions by commit time for the given IDs
|
||||
*/
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public List<Transaction> getTxnsByMinCommitTime(List<Long> includeTxnIds);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public int getTxnUpdateCount(final long txnId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public int getTxnDeleteCount(final long txnId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public int getTransactionCount();
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public List<NodeRef> getTxnChangesForStore(final StoreRef storeRef, final long txnId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public List<NodeRef> getTxnChanges(final long txnId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public List<Long> getTxnsUnused(Long minTxnId, long maxCommitTime, int count);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=true)
|
||||
public void purgeTxn(Long txnId);
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Long getMinTxnCommitTime();
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public Long getMaxTxnCommitTime();
|
||||
|
||||
@DirtySessionAnnotation(markDirty=false)
|
||||
public void prependPaths(Pair<Long, NodeRef> currentNodePair, Pair<StoreRef, NodeRef> currentRootNodePair,
|
||||
Path currentPath, Collection<Path> completedPaths, Stack<Long> assocIdStack, boolean primaryOnly)
|
||||
throws CyclicChildRelationshipException;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user