2 * Copyright (C) 2017, 2020 Free Software Foundation
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 3 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.jfinancials.model.receipt_item;
19 import java.io.Serializable;
20 import java.util.List;
21 import javax.ejb.Remote;
22 import org.mxchange.jfinancials.exceptions.receipt_item.ReceiptItemAlreadyAddedException;
23 import org.mxchange.jfinancials.model.receipt.BillableReceipt;
24 import org.mxchange.jusercore.model.user.User;
27 * A remote interface for financial receipt items
29 * @author Roland Häder<roland@mxchange.org>
32 public interface FinancialReceiptItemSessionBeanRemote extends Serializable {
35 * Returns a list of all receipt items
37 * @return A list of all receipt items
39 List<BillableReceiptItem> allReceiptItems ();
42 * Returns a list of all items by given receipt instance
44 * @param receipt Receipt instance
46 * @return A list of all assigned receipt items
48 List<BillableReceiptItem> allReceiptItems (final BillableReceipt receipt);
51 * Returns a list of all user's receipt items
53 * @param user User instance to get all receipts for
55 * @return A list of all user's receipt items
57 List<BillableReceiptItem> allUsersReceiptItems (final User user);
60 * Adds given receipt item and returns the updated version. If the receipt
61 * item has already been found, a proper exception is being thrown.
63 * @param receiptItem Receipt item being added
65 * @return Updated receipt
67 * @throws ReceiptItemAlreadyAddedException If the receipt item has already
70 BillableReceiptItem addReceiptItem (final BillableReceiptItem receiptItem) throws ReceiptItemAlreadyAddedException;