Mark Rogers 03d130e99c ALF-2031 - DR and VT can't start
- undeleted and reinstated use of org.alfresco.util.Pair
   - undeleted org.alfresco.util.PropertyCheck which is used in the deployment code.
   - undeleted other org.alfresco.util.* classes which probably should never have been moved to spring surf.

git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@19312 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261
2010-03-16 15:05:47 +00:00

81 lines
3.2 KiB
Java

/*
* Copyright (C) 2005-2010 Alfresco Software Limited.
*
* This file is part of Alfresco
*
* Alfresco is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Alfresco 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
*/
package org.alfresco.repo.domain;
import java.util.Locale;
import org.alfresco.error.AlfrescoRuntimeException;
import org.alfresco.repo.domain.hibernate.DirtySessionAnnotation;
import org.alfresco.util.Pair;
/**
* Data abstraction layer for Locale entities.
*
* @author Derek Hulley
* @since 2.2.1
*/
public interface LocaleDAO
{
/**
* @param id the unique ID of the entity
* @return the locale (never null)
* @throws AlfrescoRuntimeException if the ID provided is invalid
*/
@DirtySessionAnnotation(markDirty=false)
Pair<Long, Locale> getLocalePair(Long id);
/**
* @param id the locale to fetch or <tt>null</tt> to get the default locale
* @return the locale or <tt>null</tt> if no such locale exists
*/
@DirtySessionAnnotation(markDirty=false)
Pair<Long, Locale> getLocalePair(Locale locale);
/**
* @return the locale pair for the default locale. Although the <tt>Locale</tt>
* object will be populated, the ID will point to an instance that generically
* refers to the system's default locale i.e. the value returned can vary
* depending on the executing thread's default locale.
*/
@DirtySessionAnnotation(markDirty=false)
Pair<Long, Locale> getDefaultLocalePair();
/**
* Gets the locale ID for an existing instance or creates a new entity if
* one doesn't exist.
*
* @param id the locale to fetch or <tt>null</tt> to get or create the default
* locale.
* @return the locale - never <tt>null</tt>
*/
@DirtySessionAnnotation(markDirty=true)
Pair<Long, Locale> getOrCreateLocalePair(Locale locale);
/**
* Find or create the details representing the default locale.
*
* @return the locale pair for the default locale. Although the <tt>Locale</tt>
* object will be populated, the ID will point to an instance that generically
* refers to the system's default locale i.e. the value returned can vary
* depending on the executing thread's default locale.
*/
@DirtySessionAnnotation(markDirty=true)
Pair<Long, Locale> getOrCreateDefaultLocalePair();
}