messageresourceservice.java

噶额外噶外骨骼感广泛高热感 就 啊啊

/*
 * @author                        : Neelesh
 * @Version                       : 1.0
 *
 * Development Environment        : Oracle 9i JDeveloper
 * Name of the File               : MessageResourceService.java
 * Creation/Modification History  :
 *
 * Neelesh    03-Feb-2002      Created
 *
 */
package oracle.otnsamples.vsm.services;

import java.rmi.RemoteException;

import java.util.Locale;

import javax.ejb.EJBObject;


/**
 * This is a distributed service for looking up messages and errors. A
 * ServiceException thrown by the VSM Services layer is associated with a key.
 * Clients can look up for the detailed message/error in their preferred
 * language (which is supported by the VSM Services layer) using this
 * stateless session bean. The bean has a set of getMessage methods to look up
 * the messages
 */
public interface MessageResourceService extends EJBObject {
  /**
   * This method returns a message for a given key and language id
   *
   * @param <b>key</b> - The message key
   * @param <b>langID</b> - The language id
   *
   * @return <b>String</b> - The corresponding message or null, if not present
   */
  public String getMessage(String key, String langID)
                    throws RemoteException, 
                           ServiceException;
  /**
   * This method returns a message for a given key and the defaullanguage id
   *
   * @param <b>key</b> - The message key
   * @param <b>langID</b> - The language id
   *
   * @return <b>String</b> - The corresponding message or null, if not present
   */
  public String getMessage(String key) throws RemoteException, 
                                              ServiceException;
  /**
   * This method returns a message for a given key and locale
   *
   * @param <b>key</b> - The message key
   * @param <b>locale</b> - The locale
   *
   * @return <b>String</b> - The corresponding message or null, if not present
   */
  public String getMessage(String key, Locale locale)
                    throws RemoteException, 
                           ServiceException;
  /**
   * This method returns a list of messages for a given set of keys and
   * language id
   *
   * @param <b>keys</b> - The set of message keys
   * @param <b>langID</b> - The language id
   *
   * @return <b>String[]</b> - The corresponding set of messages. An entry in
   *         this array may be null, if the message for that key is not
   *         present
   */
  public String[] getMessages(String[] keys, String langID)
                       throws RemoteException, 
                              ServiceException;
}