Derek Hulley 6f302f0350 Merged V2.2 to HEAD
10963: Merged DEV/LARGE_COLLECTION_PROPERTIES_2.2.1 to V2.2
          - PersonService: Lucene removal
          - Lucene optimizations (in progress)
          - Multi-valued and locale-specific properties persisted in alf_node_properties
          - Removal of unused AVM tables
   10987: Oracle dialects and enhanced SQL patch support
          - Only support Alfresco's 9i and 10g dialects (with auto-switching)
          - SQL script patches can now apply selectively to ranges
   11007: Test to check cached retrieval of QNames


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@11206 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2008-10-06 13:26:18 +00:00

125 lines
4.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 java.util.Map;
import java.util.Set;
import org.alfresco.error.AlfrescoRuntimeException;
import org.alfresco.service.namespace.QName;
import org.alfresco.util.Pair;
/**
* Data abstraction layer for QName and Namespace entities.
*
* @author Derek Hulley
* @since 2.1
*/
public interface QNameDAO
{
/**
* @param id the unique ID of the entity
* @return the namespace entity (never null)
* @throws AlfrescoRuntimeException if the ID provided is invalid
*/
NamespaceEntity getNamespaceEntity(Long id);
/**
* @param namespaceUri the namespace URI to query for
* @return the namespace entity of null if it doesn't exist
*/
NamespaceEntity getNamespaceEntity(String namespaceUri);
/**
* Get an existing instance matching the URI or create one if necessary.
* Note that this method should be treated as a write method and should not
* be used in the context of read-only or query methods.
*
* @param namespaceUri the namespace URI to create
* @return the existing namespace entity if found or a new one
*/
NamespaceEntity getOrCreateNamespaceEntity(String namespaceUri);
/**
* @param namespaceUri the namespace URI to create
* @return Returns the new instance
*/
NamespaceEntity newNamespaceEntity(String namespaceUri);
/**
* Modifies an existing namespace URI. If the new URI already exists, then no
* new entity is created and a concurrency
*
* @param oldNamespaceUri the old namespace URI
* @param newNamespaceUri the new namespace URI
* @throws AlfrescoRuntimeException if the new namespace is in use
*/
void updateNamespaceEntity(String oldNamespaceUri, String newNamespaceUri);
/**
* @param id the unique ID of the entity
* @return the QName entity (never null)
* @throws AlfrescoRuntimeException if the ID provided is invalid
*/
QNameEntity getQNameEntity(Long id);
/**
* @param id the unique ID of the entity
* @return the QName (never null)
* @throws AlfrescoRuntimeException if the ID provided is invalid
*/
QName getQName(Long id);
/**
* @param qname the QName to query for
* @return the QName entity of null if it doesn't exist
*/
QNameEntity getQNameEntity(QName qname);
/**
* Get an existing instance matching the QName or create one if necessary.
* Note that this method should be treated as a write method and should not
* be used in the context of read-only or query methods.
*
* @param qname the QName to query for
* @return an existing QName entity if found or a new one
*/
QNameEntity getOrCreateQNameEntity(QName qname);
Pair<Long, QName> getOrCreateQNamePair(QName qname);
/**
* @param qname the QName to create
* @return the new instance
*/
QNameEntity newQNameEntity(QName qname);
Set<QName> convertIdsToQNames(Set<Long> ids);
Map<QName, ? extends Object> convertIdMapToQNameMap(Map<Long, ? extends Object> idMap);
Set<Long> convertQNamesToIds(Set<QName> qnames, boolean create);
}