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 Affero General Public License as
6 * published by the Free Software Foundation, either version 3 of the
7 * License, or (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 Affero General Public License for more details.
14 * You should have received a copy of the GNU Affero General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 package org.mxchange.jfinancials.model.receipt;
19 import java.io.Serializable;
20 import java.text.MessageFormat;
21 import java.util.Objects;
24 * A utilities class for receipts
26 * @author Roland Häder<roland@mxchange.org>
28 public class Receipts implements Serializable {
33 private static final long serialVersionUID = 2_867_938_676_165_401L;
36 * Compares both receipt instances. This method returns -1 if second
39 * @param receipt1 BillableReceipt instance 1
40 * @param receipt2 BillableReceipt instance 2
42 * @return Comparison value
44 public static int compare (final BillableReceipt receipt1, final BillableReceipt receipt2) {
45 // Check euqality, then at least first must be given
46 if (Objects.equals(receipt1, receipt2)) {
49 } else if (null == receipt1) {
52 } else if (null == receipt2) {
57 // Invoke compareTo() method
58 return receipt1.compareTo(receipt2);
62 * Copies all fields from source receipt to target receipt.
64 * @param sourceReceipt Source receipt instance
65 * @param targetReceipt Target Receipt instance
67 public static void copyReceiptData (final BillableReceipt sourceReceipt, final BillableReceipt targetReceipt) {
68 // Both should not be null
69 if (null == sourceReceipt) {
71 throw new NullPointerException("sourceReceipt is null"); //NOI18N
72 } else if (null == targetReceipt) {
74 throw new NullPointerException("targetReceipt is null"); //NOI18N
75 } else if (Objects.equals(sourceReceipt, targetReceipt)) {
76 // Is exactly the same!
77 throw new IllegalArgumentException("sourcerReceipt and targetReceipt are the same."); //NOI18N
81 targetReceipt.setReceiptBarCodeNumber(sourceReceipt.getReceiptBarCodeNumber());
82 targetReceipt.setReceiptBonusCard(sourceReceipt.getReceiptBonusCard());
83 targetReceipt.setReceiptBranchOffice(sourceReceipt.getReceiptBranchOffice());
84 targetReceipt.setReceiptCreated(sourceReceipt.getReceiptCreated());
85 targetReceipt.setReceiptId(sourceReceipt.getReceiptId());
86 targetReceipt.setReceiptIssued(sourceReceipt.getReceiptIssued());
87 targetReceipt.setReceiptNumber(sourceReceipt.getReceiptNumber());
88 targetReceipt.setReceiptPaymentType(sourceReceipt.getReceiptPaymentType());
89 targetReceipt.setReceiptRegisterNumber(sourceReceipt.getReceiptRegisterNumber());
90 targetReceipt.setReceiptSellerEmployee(sourceReceipt.getReceiptSellerEmployee());
91 targetReceipt.setReceiptSequenceNumber(sourceReceipt.getReceiptSequenceNumber());
92 targetReceipt.setReceiptTransactionNumber(sourceReceipt.getReceiptTransactionNumber());
93 targetReceipt.setReceiptUpdated(sourceReceipt.getReceiptUpdated());
94 targetReceipt.setReceiptUser(sourceReceipt.getReceiptUser());
98 * Checks whether both receipts are the same, means not true entity equality
99 * but if the receipt in general terms does already exist. A pre-check on
100 * entity equality is however performed to avoid below much longer code.
102 * @param receipt1 BillableReceipt instance 1
103 * @param receipt2 BillableReceipt instance 2
105 * @return Whether both receipts are the same (not instances)
107 public static boolean isSameReceipt (final BillableReceipt receipt1, final BillableReceipt receipt2) {
108 // Pre-compare both as entities (same id)
109 if (Objects.equals(receipt1, receipt2)) {
110 // Same entity (with id number)
114 // Validate parameter
115 if (null == receipt1) {
117 throw new NullPointerException("receipt1 is null"); //NOI18N
118 } else if ((receipt1.getReceiptId() instanceof Long) && (receipt1.getReceiptId() < 1)) {
120 throw new IllegalArgumentException(MessageFormat.format("receipt1.receiptId={0} is not valid.", receipt1.getReceiptId())); //NOI18N
121 } else if (receipt1.getReceiptBranchOffice() == null) {
123 throw new NullPointerException("receipt1.receiptBranchOffice is null"); //NOI18N
124 } else if (receipt1.getReceiptBranchOffice().getBranchId() == null) {
126 throw new NullPointerException("receipt1.receiptBranchOffice.branchId is null"); //NOI18N
127 } else if (receipt1.getReceiptBranchOffice().getBranchId() < 1) {
129 throw new NullPointerException(MessageFormat.format("receipt1.receiptBranchOffice.branchId={0} is not valid", receipt1.getReceiptBranchOffice().getBranchId())); //NOI18N
130 } else if ((receipt1.getReceiptNumber() != null) && (receipt1.getReceiptNumber().isEmpty())) {
132 throw new IllegalArgumentException("receipt1.receiptNumber is empty."); //NOI18N
133 } else if (receipt1.getReceiptPaymentType() == null) {
135 throw new NullPointerException("receipt1.receiptPaymentType is null"); //NOI18N
136 } else if (null == receipt2) {
138 throw new NullPointerException("receipt2 is null"); //NOI18N
139 } else if ((receipt2.getReceiptId() instanceof Long) && (receipt2.getReceiptId() < 1)) {
141 throw new IllegalArgumentException(MessageFormat.format("receipt2.receiptId={0} is not valid.", receipt2.getReceiptId())); //NOI18N
142 } else if (receipt2.getReceiptBranchOffice() == null) {
144 throw new NullPointerException("receipt2.receiptBranchOffice is null"); //NOI18N
145 } else if (receipt2.getReceiptBranchOffice().getBranchId() == null) {
147 throw new NullPointerException("receipt2.receiptBranchOffice.branchId is null"); //NOI18N
148 } else if (receipt2.getReceiptBranchOffice().getBranchId() < 1) {
150 throw new NullPointerException(MessageFormat.format("receipt2.receiptBranchOffice.branchId={0} is not valid", receipt2.getReceiptBranchOffice().getBranchId())); //NOI18N
151 } else if ((receipt2.getReceiptNumber() != null) && (receipt2.getReceiptNumber().isEmpty())) {
153 throw new IllegalArgumentException("receipt2.receiptNumber is empty."); //NOI18N
154 } else if (receipt2.getReceiptPaymentType() == null) {
156 throw new NullPointerException("receipt2.receiptPaymentType is null"); //NOI18N
159 // Now check all individually
160 if (!Objects.equals(receipt1.getReceiptBranchOffice(), receipt2.getReceiptBranchOffice())) {
161 // Other branch offices
163 } else if (!Objects.equals(receipt1.getReceiptNumber(), receipt2.getReceiptNumber())) {
164 // Other receipt number
166 } else if (!Objects.equals(receipt1.getReceiptIssued(), receipt2.getReceiptIssued())) {
169 } else if (!Objects.equals(receipt1.getReceiptUser(), receipt2.getReceiptUser())) {
170 // Other user (unlikely to happen
174 // Maybe same receipt!
179 * Private default constructor
181 private Receipts () {
182 // Utilities don't have instances