// This Source Code is in the Public Domain per: http://unlicense.org
package org.litesoft.core.simpletypes;

public interface ResourceKeyNameURLprovider
{
    /**
     * Get the ResourceKeyNameURLs locally available.
     * <p/>
     * If null then there are none locally available, and they must be requested
     *
     * @return if none locally available then null, otherwise the locally available list (which may be empty)
     */
    public ResourceKeyNameURL[] getLocalResourceKeyNameURLs();

    /**
     * Request the non-Locally available ResourceKeyNameURLs.
     *
     * @param pCallback Not null!
     *
     * @throws UnsupportedOperationException if there are Locally available ResourceKeyNameURLs, as that means that they are updated via "push"
     */
    public void requestResourceKeyNameURLs( ResourceKeyNameURLsAvailableCallback pCallback )
            throws UnsupportedOperationException;
}