Dave Ward b8aaa9c372 Merged V3.2 to HEAD
17163: org.alfresco.repo.domain.hibernate.AclDaoComponentImpl.updateAuthority() needs to flush/dirty the session in order to work
   17160: Fix HeartBeat
      - Lazy initialization in scheduled job needed its own transaction
   17146: Fix failing unit tests
      - HibernateNodeDaoServiceImpl.moveNodeToStore() must invalidate parentAssocsCache now that it contains NodeRefs
   17145: Fixes to patches for new CRC schema changes
      - Sequenced patch.fixNameCrcValues-2 before all other patches
      - Fixed typos in schema upgrade script and added CRCs for the repository descriptor nodes, so that the descriptor service and patch service can boot up
      - HeartBeat initializes lazily so that it doesn't try to load information before the patch service has bootstrapped
      - Made FixNameCrcValuesPatch industrial strength by using BatchProcessor to handle multi threading, progress reporting and transaction delineation
   17097: Removal of spurious logs directory accidentally introduced in 17096
   17096: Performance tuning for improved throughput during high volume import from LDAP directory
      - Lucene indexer will now no longer index and then reindex the same node in the same transaction
      - lucene.indexer.mergerTargetOverlaysBlockingFactor reduced to 1 (improves indexing performance and no excessive throttling observed during 10 hour test)
      - HomeFolderManager fixed so that it pays attention to the eager home folder creation flag
      - HibernateNodeDaoServiceImpl.parentAssocsCache 'upgraded' to hold information about root nodes and node refs so that recursive methods such as prependPaths can run entirely out of the cache
      - Boolean argument added to getChildAssocs() so that preloading of all child nodes is optional
      - qname_crc column added to alf_child_assoc to allow efficient lookup and indexing of child associations by QName. CRC of (qname_namespace, qname_localname).
      - idx_alf_cass_qnln on qname_localname replaced with idx_alf_cass_qncrc (qname_crc, type_qname_id, parent_node_id)
      - All node service lookup queries involving qname_localname modified to include qname_crc in WHERE clause
      - schema patch provided
      - existing org.alfresco.repo.admin.patch.impl.FixNameCrcValuesPatch extended to also fill in qname_crc column and forced to run on newer schemas
      - Optimized ChainingUserRegistrySynchronizer so that it doesn't have to look up the entire set of authorities during  an 'empty' incremental sync
      - ChainingUserRegistrySynchronizer no longer starts an outer transaction around all its smaller transactions (used to die due to timeout)
      - rule service disabled for LDAP batch processing threads
      - org.alfresco.cache.parentAssocsCache and org.alfresco.cache.storeAndNodeIdCache size increased to 80,000
      - Fixed case sensitivity issue with person caching in PersonServiceImpl
      - Cache the people container in PersonServiceImpl for faster person lookups
      - PersonDAO removed and replaced with now more efficient node service child assoc lookup methods


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@17168 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2009-10-26 15:52:59 +00:00

187 lines
5.7 KiB
Java

/*
* Copyright (C) 2005-2007 Alfresco Software Limited.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* As a special exception to the terms and conditions of version 2.0 of
* the GPL, you may redistribute this Program in connection with Free/Libre
* and Open Source Software ("FLOSS") applications as described in Alfresco's
* FLOSS exception. You should have recieved a copy of the text describing
* the FLOSS exception, and it is also available here:
* http://www.alfresco.com/legal/licensing"
*/
package org.alfresco.repo.domain;
import org.alfresco.service.cmr.repository.ChildAssociationRef;
import org.alfresco.service.namespace.QName;
/**
* Represents a special type of association between nodes, that of the
* parent-child relationship.
*
* @author Derek Hulley
*/
public interface ChildAssoc extends Comparable<ChildAssoc>
{
/**
* Performs the necessary work on the provided nodes to ensure that a bidirectional
* association is properly set up.
* <p>
* The association attributes still have to be set up.
*
* @param parentNode
* @param childNode
*
* @see #setName(String)
* @see #setIsPrimary(boolean)
*/
public void buildAssociation(Node parentNode, Node childNode);
/**
* Performs the necessary work on the {@link #getParent() parent} and
* {@link #getChild() child} nodes to maintain the inverse association sets
*/
public void removeAssociation();
/**
* A convenience method to get a reference to this association.
*
* @param qnameDAO the DAO to resolve the qname references
* @return Returns a reference to this association
*/
public ChildAssociationRef getChildAssocRef(QNameDAO qnameDAO);
/**
* Convenience method to get the association's type
*
* @param qnameDAO the helper DAO
* @return the association's type QName
*/
public QName getTypeQName(QNameDAO qnameDAO);
/**
* Convenience method to set the association's type
*
* @param qnameDAO the helper DAO
* @param typeQName the association's type QName
*/
public void setTypeQName(QNameDAO qnameDAO, QName typeQName);
/**
* A convenience method to aggregate the qualified name's namespace and localname
* into a single qualified name.
*
* @return Returns the qualified name of the association
*/
public QName getQName(QNameDAO qnameDAO);
/**
* Convenience method to set the association's qname
*
* @param qnameDAO the helper DAO
* @param qname the association's QName
*/
public void setQName(QNameDAO qnameDAO, QName qname);
public Long getId();
/**
* @return Return the current version number
*/
public Long getVersion();
public Node getParent();
public Node getChild();
/**
* @return Returns the type of the association
*/
public Long getTypeQNameId();
/**
* @param typeQNameId the association's dictionary type
*/
public void setTypeQNameId(Long typeQNameId);
/**
* @return Returns the child node name. This may be truncated, in which case it
* will end with <b>...</b>
*/
public String getChildNodeName();
/**
* @param childNodeName the name of the child node, which may be truncated and
* terminated with <b>...</b> in order to not exceed 50 characters.
*/
public void setChildNodeName(String childNodeName);
/**
* @return Returns the crc value for the child node name.
*/
public long getChildNodeNameCrc();
/**
* @param crc the crc value
*/
public void setChildNodeNameCrc(long crc);
/**
* @return Returns the namespace of the association's local QName
*/
public Long getQnameNamespaceId();
/**
* @param namespaceId the namespace of the association's local QName
*/
public void setQnameNamespaceId(Long namespaceId);
/**
* @return Returns the localname of the association's local QName
*/
public String getQnameLocalName();
/**
* @param localName the localname of the association's local QName
*/
public void setQnameLocalName(String localName);
/**
* @return Returns the crc value for the association's local QName
*/
public long getQnameCrc();
/**
* @param crc the crc value
*/
public void setQnameCrc(long crc);
public boolean getIsPrimary();
public void setIsPrimary(boolean isPrimary);
/**
* @return Returns the user-assigned index
*/
public int getIndex();
/**
* Set the index of this association
*
* @param index the association index
*/
public void setIndex(int index);
}