com.bea.campaign
Interface CampaignService

public interface CampaignService

extends javax.ejb.EJBObject, AdStatus

EJB object interface for the CampaignService session EJB.

Method Summary

void	clearEndStates(java.lang.String campaignId) Clear all of the user end states associated to a campaign.
java.util.Collection	getActiveCampaigns() Get back a list of the active Campaign objects.
AdBucketService	getAdBucketService() Get a reference to the AdBucketService being used.
AdService	getAdService() Get a reference to the AdService being used
Campaign	getCampaign(java.lang.String id) Retrieve a deployed campaign.
java.util.Collection	getDeployedCampaigns() Get back a list of the deployed Campaign objects.
MailService	getMailService() Get a reference to the mail service being used.
ScenarioService	getScenarioService() Get a reference to the scenario service this uses.
void	handleEvent(Event event) Handle an event from the event service.
boolean	isActive(java.lang.String campaignId) Tell if the specified campaign is currently active.
void	resetCampaign(java.lang.String campaignId) Reset any cached state on the specified campaign.

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Method Detail

handleEvent

public void handleEvent(Event event)
                 throws java.rmi.RemoteException,
                        javax.ejb.EJBException

Handle an event from the event service.

Parameters:

event - the event.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

isActive

public boolean isActive(java.lang.String campaignId)
                 throws java.rmi.RemoteException,
                        javax.ejb.EJBException

Tell if the specified campaign is currently active.

Specified by:

isActive in interface AdStatus

Parameters:

campaignId - the campaign's unique id.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

getDeployedCampaigns

public java.util.Collection getDeployedCampaigns()
                                          throws java.rmi.RemoteException,
                                                 javax.ejb.EJBException

Get back a list of the deployed Campaign objects.

getActiveCampaigns

public java.util.Collection getActiveCampaigns()
                                        throws java.rmi.RemoteException,
                                               javax.ejb.EJBException

Get back a list of the active Campaign objects.

getCampaign

public Campaign getCampaign(java.lang.String id)
                     throws java.rmi.RemoteException,
                            javax.ejb.EJBException

Retrieve a deployed campaign.

clearEndStates

public void clearEndStates(java.lang.String campaignId)
                    throws java.rmi.RemoteException,
                           javax.ejb.EJBException

Clear all of the user end states associated to a campaign.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

See Also:

ScenarioService.clearEndStates(com.bea.campaign.ScenarioContainer)

resetCampaign

public void resetCampaign(java.lang.String campaignId)
                   throws java.rmi.RemoteException,
                          javax.ejb.EJBException

Reset any cached state on the specified campaign.

This will cause the Campaign to redetermine it's state the next time it's accessed.

This includes: reseting the goal achieved state.

getScenarioService

public ScenarioService getScenarioService()
                                   throws java.rmi.RemoteException,
                                          javax.ejb.EJBException

Get a reference to the scenario service this uses.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

getAdService

public AdService getAdService()
                       throws java.rmi.RemoteException,
                              javax.ejb.EJBException

Get a reference to the AdService being used

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

getAdBucketService

public AdBucketService getAdBucketService()
                                   throws java.rmi.RemoteException,
                                          javax.ejb.EJBException

Get a reference to the AdBucketService being used.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.

getMailService

public MailService getMailService()
                           throws java.rmi.RemoteException,
                                  javax.ejb.EJBException

Get a reference to the mail service being used.

Throws:

javax.ejb.EJBException - thrown on an error.

java.rmi.RemoteException - thrown on a communications error.