Provide a resolver that finds the Confluence space key or root of an entity reference

/**
 * Confluence Space resolver.
 * @since 9.61.0
 * @version $Id$
 */
@Role
public interface ConfluenceSpaceResolver
{
    /**
     * @return The Confluence space in which the given reference (space or document) lives
     * @param reference the space or document for which to get the space
     * @throws ConfluenceResolverException if something wrong happens
     */
    EntityReference getSpace(EntityReference reference) throws ConfluenceResolverException;

    /**
     * @return The Confluence space in which the given reference (space or document) lives
     * @param reference the space or document for which to get the space key
     * @throws ConfluenceResolverException if something wrong happens
     */
    String getSpaceKey(EntityReference reference) throws ConfluenceResolverException;
}