appsshareservice.java

java 写的一个新闻发布系统

//
//                                   ____.
//                       __/\ ______|    |__/\.     _______
//            __   .____|    |       \   |    +----+       \
//    _______|  /--|    |    |    -   \  _    |    :    -   \_________
//   \\______: :---|    :    :           |    :    |         \________>
//           |__\---\_____________:______:    :____|____:_____\
//                                      /_____|
//
//                 . . . i n   j a h i a   w e   t r u s t . . .
//
//
//  AppsShareService
//
//  NK      31.04.2001
// 
package org.jahia.services.shares;

import java.util.Enumeration;

import org.jahia.services.JahiaService;
import org.jahia.services.sites.*;
import org.jahia.services.applications.*;
import org.jahia.data.applications.*;
import org.jahia.settings.JahiaPrivateSettings;
import org.jahia.exceptions.JahiaException;
import org.jahia.exceptions.JahiaInitializationException;

import org.jahia.data.JahiaDOMObject;


/**
 * Application Share Service
 *
 * @author Khue ng
 */
public abstract class AppsShareService extends JahiaService
{


	/**
	 * return an enumeration of sites' key having access to a gived app
	 *
	 * @param ApplicationBean, the app
	 * @return Enumeration, an enumeration of sites' keys
	 */
	public abstract Enumeration getSites( ApplicationBean app ) throws JahiaException;


	/**
	 * add a share between a site and an application
	 *
	 * @param JahiaSite, the site
	 * @param ApplicationBean, the app
	 */
	public abstract void addShare( JahiaSite site, ApplicationBean app ) throws JahiaException;

	/**
	 * remove a share between a site and an application
	 *
	 * @param JahiaSite, the site
	 * @param ApplicationBean, the app
	 */
	public abstract void removeShare( JahiaSite site, ApplicationBean app ) throws JahiaException;
	
	/**
	 * remove all share referencing a site
	 *
	 * @param JahiaSite, the site
	 */
	public abstract void removeShares( JahiaSite site ) throws JahiaException;

	/**
	 * remove all share referencing an app
	 *
	 * @param ApplicationBean, the app
	 */
	public abstract void removeShares( ApplicationBean app ) throws JahiaException;


    //--------------------------------------------------------------------------
	/**
	 * Return a share between a site and an application
	 *
	 * @param JahiaSite, the site
	 * @param ApplicationBean, the app
	 */
	public abstract AppShare getShare( JahiaSite site, ApplicationBean app ) throws JahiaException;


    //--------------------------------------------------------------------------
	/**
	 * return a DOM document of application shares content
	 *
	 * @param int the site id
	 *
	 * @return JahiaDOMObject a DOM representation of this object
	 *
	 * @author NK
	 */
	public abstract JahiaDOMObject getApplicationSharesAsDOM( int siteID )
	throws JahiaException;


}