# com.bea.commerce.ebusiness.discount.mgmt
DiscountMgmt Interface

public interface DiscountMgmt
extends `EJBObject`

This interface defines the public interface of the `DiscountMgmt` service. This service controls the persistance of discount sets and the creation and access of discounts.

All Superinterfaces
  `EJBObject`, `Remote`

## Method Summary

`public `QualificationDiscountDef`` | `getDiscountById`(`QualificationDiscountId` id) Gets a discount (`QualificationDiscountDef`) by it's id (`QualificationDiscountId`).
`public `QualificationDiscountDef`` | `getDiscountByName`(`String` discountName) Gets a discount definition (`QualificationDiscountDef`) by its name.
`public `QualificationDiscountDef`` | `getDiscountByName`(`String` setName, `String` discountName)
`public `Set`` | `getDiscountsById`(`Set` idSet, `Set` qualDiscountDefSet) Gets a `Set` of `QualificationDiscountDef`s whose ids (`QualificationDiscountId`)s are in the `Set` argument passed.
`public `Set`` | `getGlobalDiscounts`() Gets all the global discounts currently deployed

Methods from interface `javax.ejb.`EJBObject``
`getEJBHome, getHandle, getPrimaryKey, isIdentical, remove`

## Method Detail

### getDiscountById(QualificationDiscountId) Method

    public QualificationDiscountDef getDiscountById(QualificationDiscountId id)
         throws RemoteException

Gets a discount (`QualificationDiscountDef`) by it's id (`QualificationDiscountId`).

#### Parameters

id
  the `QualificationDiscountId` of the discount

#### Returns

the `QualificationDiscountDef` specifed by the id or null if the discount was not found

#### Exceptions

``RemoteException``
  thrown on a communication error

### getDiscountByName(String) Method

    public QualificationDiscountDef getDiscountByName(String discountName)
         throws RemoteException

Gets a discount definition (`QualificationDiscountDef`) by its name. Since discount name are only unquie within a discount set the set name is required also.

#### Parameters

discountName
  the name of the set to which the discount belongs

#### Returns

the discount definition (`QualificationDiscountDef`), or null if the discount was not found

#### Exceptions

``RemoteException``
  thrown on a communication error

### getDiscountByName(String, String) Method

DEPRECATED use getDiscountByName(String discountName)

    public QualificationDiscountDef getDiscountByName(String setName,
                                                      String discountName)
         throws RemoteException

#### Exceptions

``RemoteException``

### getDiscountsById(Set, Set) Method

    public Set getDiscountsById(Set idSet,
                                Set qualDiscountDefSet)
         throws RemoteException

Gets a `Set` of `QualificationDiscountDef`s whose ids (`QualificationDiscountId`)s are in the `Set` argument passed.

#### Parameters

idSet
  a Set of `QualificationDiscountId` objects. This Set will not be modified by this method.

qualDiscountDefSet
  an empty set into which the `QualificationDiscountDef` objects will be placed. This set must be modifiable. Anything that was already in the set will be removed.

#### Returns

a Set, the one specifed by the `qualDiscountDefSet` parameter, of `QualificationDiscountDef` objects whose `QualificationDiscountId`s match those passed in the `idSet` parameter. If no matching `QualificationDiscountDef` objects the returned set will be empty.

#### Exceptions

``RemoteException``
  thrown on a communication error

### getGlobalDiscounts() Method

    public Set getGlobalDiscounts()
         throws RemoteException

Gets all the global discounts currently deployed

#### Returns

a Set containging all of the global QualificationDiscountDef objects currently deployed, if there are no global discounts deployed the Set will be empty.

#### Exceptions

``RemoteException``
  thrown on a communication error