org.broadleafcommerce.common.site.service

Interface SiteService

All Known Implementing Classes:

SiteServiceImpl

public interface SiteService

Most of the methods below return a Site which is not attached to a Hibernate session (which is what is referred to as 'non-persistent'). While this prevents LazyInitializationExceptions that might occur if there is not continually a Hibernate session, this also means that while the results of these will return you an instance, you might need to look the entity back up from the database to refresh it.

Note also that when resolving sites (via the BroadleafSiteResolver) the usual case is to return a non-persistent version not attached to a Hibernate session.

Author:

Phillip Verheyden (phillipuniverse)

Method Summary

Methods

Modifier and Type	Method and Description
Site	createSite() Creates an instance of Site.
List<Site>	findAllActiveSites() Deprecated. use findAllNonPersistentActiveSites() instead
List<Site>	findAllNonPersistentActiveSites() Returns all of the active sites in the system and does not attach them to a Hibernate session
List<Site>	findAllPersistentActiveSites() Returns all of the active sites in the system that are still attached to a Hibernate session
Catalog	findCatalogById(Long id) Finds a catalog by its id.
Site	retrieveDefaultSite() Deprecated. use retrieveNonPersistentDefaultSite() instead
Site	retrieveNonPersistentDefaultSite() Retrieves the non-persistent version of the default site
Site	retrieveNonPersistentSiteByDomainName(String domain) Finds a site by the given domain name and returns a non-persistent version
Site	retrieveNonPersistentSiteById(Long id) Retrieves a site by its primary key disconnected from a Hibernate session
Site	retrievePersistentDefaultSite() Retrieves the default site attached to a Hibernate session
Site	retrievePersistentSiteByDomainName(String domain) Finds a site by the domain name which is still attached to a Hibernate session
Site	retrievePersistentSiteById(Long id) Retrieves a site by its primary key whose return value is still attached to a Hibernate session
Site	retrieveSiteByDomainName(String domain) Deprecated. use retrieveNonPersistentSiteByDomainName(String) instead
Site	retrieveSiteById(Long id) Deprecated. use retrieveNonPersistentSiteById(Long) instead
Catalog	save(Catalog catalog) Saves the given catalog and returns the merged instance
Site	save(Site site) Deprecated. use saveAndReturnNonPersisted(Site) instead
Site	saveAndReturnNonPersisted(Site site) Save updates to a site and returns a non-persistent instance
Site	saveAndReturnPersisted(Site site) Save updates to a site and return the persistent instance attached to a Hibernate session

Method Detail

createSite

Site createSite()

Creates an instance of Site. Default implementation delegates to SiteDao.create().

Returns:

retrieveSiteById

@Deprecated
Site retrieveSiteById(Long id)

Deprecated. use retrieveNonPersistentSiteById(Long) instead

Find a site by its id and returns a non-persistent version

Parameters:

id -

Returns:

retrieveNonPersistentSiteById

Site retrieveNonPersistentSiteById(Long id)

Retrieves a site by its primary key disconnected from a Hibernate session

retrievePersistentSiteById

Site retrievePersistentSiteById(Long id)

Retrieves a site by its primary key whose return value is still attached to a Hibernate session

retrieveSiteByDomainName

@Deprecated
Site retrieveSiteByDomainName(String domain)

Deprecated. use retrieveNonPersistentSiteByDomainName(String) instead

Find a site by its domain and returns a non-persistent version

Parameters:

id -

Returns:

retrieveNonPersistentSiteByDomainName

Site retrieveNonPersistentSiteByDomainName(String domain)

Finds a site by the given domain name and returns a non-persistent version

retrievePersistentSiteByDomainName

Site retrievePersistentSiteByDomainName(String domain)

Finds a site by the domain name which is still attached to a Hibernate session

Parameters:

domain -

Returns:

save

@Deprecated
Site save(Site site)

Deprecated. use saveAndReturnNonPersisted(Site) instead

Save updates to a site and returns a cloned instance

Parameters:

id -

Returns:

saveAndReturnNonPersisted

Site saveAndReturnNonPersisted(Site site)

Save updates to a site and returns a non-persistent instance

Parameters:

site -

Returns:

saveAndReturnPersisted

Site saveAndReturnPersisted(Site site)

Save updates to a site and return the persistent instance attached to a Hibernate session

Parameters:

site -

Returns:

retrieveDefaultSite

@Deprecated
Site retrieveDefaultSite()

Deprecated. use retrieveNonPersistentDefaultSite() instead

Returns a clone of the default site.

Parameters:

id -

Returns:

See Also:

SiteDaoImpl}

retrieveNonPersistentDefaultSite

Site retrieveNonPersistentDefaultSite()

Retrieves the non-persistent version of the default site

retrievePersistentDefaultSite

Site retrievePersistentDefaultSite()

Retrieves the default site attached to a Hibernate session

findAllActiveSites

@Deprecated
List<Site> findAllActiveSites()

Deprecated. use findAllNonPersistentActiveSites() instead

Returns:

a List of non-persistent versions of all sites in the system

findAllNonPersistentActiveSites

List<Site> findAllNonPersistentActiveSites()

Returns all of the active sites in the system and does not attach them to a Hibernate session

findAllPersistentActiveSites

List<Site> findAllPersistentActiveSites()

Returns all of the active sites in the system that are still attached to a Hibernate session

findCatalogById

Catalog findCatalogById(Long id)

Finds a catalog by its id.

Parameters:

id -

Returns:

the catalog

save

Catalog save(Catalog catalog)

Saves the given catalog and returns the merged instance

Parameters:

catalog -

Returns: