Clover coverage report - JFox Service-Oriented Application Framework - 1.0-M2
Coverage timestamp: 星期四 十一月 25 2004 17:14:11 PST
file stats: LOC: 117   Methods: 0
NCLOC: 29   Classes: 1
30 day Evaluation Version distributed via the Maven Jar Repository. Clover is not free. You have 30 days to evaluate it. Please visit http://www.thecortex.net/clover to obtain a licensed version of Clover
 
 Source file Conditionals Statements Methods TOTAL
ServiceLocator.java - - - -
coverage
 1   
 /** 
 2   
  * JFoxSOAF, Service-Oriented Application Framework
 3   
  * 
 4   
  * Copyright (C) www.huihoo.org
 5   
  *
 6   
  * Distributable under GNU LGPL
 7   
  * 
 8   
  * For more information, please visit: http://www.huihoo.org/jfox/jfoxsoaf
 9   
  */
 10   
 
 11   
 package org.huihoo.jfox.soaf.services.ejb;
 12   
 
 13   
 import java.net.URL;
 14   
 
 15   
 import javax.ejb.EJBHome;
 16   
 import javax.ejb.EJBLocalHome;
 17   
 import javax.jms.Queue;
 18   
 import javax.jms.QueueConnectionFactory;
 19   
 import javax.jms.Topic;
 20   
 import javax.jms.TopicConnectionFactory;
 21   
 import javax.mail.Session;
 22   
 import javax.sql.DataSource;
 23   
 
 24   
 import org.huihoo.jfox.soaf.exception.ServiceLocatorException;
 25   
 
 26   
 /**
 27   
  * <p>
 28   
  * This class is an implementation of the Service Locator pattern. It is used to
 29   
  * looukup resources such as EJBHomes, JMS Destinations, etc. This
 30   
  * implementation uses the "singleton instance" strategy and also the "caching"
 31   
  * strategy.
 32   
  * </p>
 33   
  * 
 34   
  * @author <a href="mailto:founder_chen@yahoo.com.cn">Peter Cheng </a>
 35   
  * @version $Revision: 1.4 $ $Date: 2004/11/02 04:15:25 $
 36   
  * @version Revision: 1.0
 37   
  */
 38   
 
 39   
 public interface ServiceLocator {
 40   
 
 41   
     /**
 42   
      * will get the ejb Local home factory. If this ejb home factory has already
 43   
      * been clients need to cast to the type of EJBHome they desire
 44   
      * 
 45   
      * @return the EJB Home corresponding to the homeName
 46   
      */
 47   
     public EJBLocalHome getLocalHome(String jndiHomeName)
 48   
             throws ServiceLocatorException;
 49   
 
 50   
     /**
 51   
      * will get the ejb Remote home factory. If this ejb home factory has
 52   
      * already been clients need to cast to the type of EJBHome they desire
 53   
      * 
 54   
      * @return the EJB Home corresponding to the homeName
 55   
      */
 56   
     public EJBHome getRemoteHome(String jndiHomeName, Class className)
 57   
             throws ServiceLocatorException;
 58   
 
 59   
     /**
 60   
      * @return the factory for the factory to get queue connections from
 61   
      */
 62   
     public QueueConnectionFactory getQueueConnectionFactory(
 63   
             String qConnFactoryName) throws ServiceLocatorException;
 64   
 
 65   
     /**
 66   
      * @return the Queue Destination to send messages to
 67   
      */
 68   
     public Queue getQueue(String queueName) throws ServiceLocatorException;
 69   
 
 70   
     /**
 71   
      * This method helps in obtaining the topic factory
 72   
      * 
 73   
      * @return the factory for the factory to get topic connections from
 74   
      */
 75   
     public TopicConnectionFactory getTopicConnectionFactory(
 76   
             String topicConnFactoryName) throws ServiceLocatorException;
 77   
 
 78   
     /**
 79   
      * This method obtains the topc itself for a caller
 80   
      * 
 81   
      * @return the Topic Destination to send messages to
 82   
      */
 83   
     public Topic getTopic(String topicName) throws ServiceLocatorException;
 84   
 
 85   
     /**
 86   
      * This method obtains the datasource itself for a caller
 87   
      * 
 88   
      * @return the DataSource corresponding to the name parameter
 89   
      */
 90   
     public DataSource getDataSource(String dataSourceName)
 91   
             throws ServiceLocatorException;
 92   
 
 93   
     /**
 94   
      * This method obtains the mail seesion itself for a caller
 95   
      * 
 96   
      * @return the Session corresponding to the name parameter
 97   
      */
 98   
     public Session getMailSession(String mailSessionName)
 99   
             throws ServiceLocatorException;
 100   
 
 101   
     /**
 102   
      * @return the URL value corresponding to the env entry name.
 103   
      */
 104   
     public URL getUrl(String envName) throws ServiceLocatorException;
 105   
 
 106   
     /**
 107   
      * @return the boolean value corresponding to the env entry such as
 108   
      *         SEND_CONFIRMATION_MAIL property.
 109   
      */
 110   
     public boolean getBoolean(String envName) throws ServiceLocatorException;
 111   
 
 112   
     /**
 113   
      * @return the String value corresponding to the env entry name.
 114   
      */
 115   
     public String getString(String envName) throws ServiceLocatorException;
 116   
 
 117   
 }