1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/*
*
* Derby - Class org.apache.derbyTesting.system.oe.client.Display
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
* either express or implied. See the License for the specific
* language governing permissions and limitations under the License.
*/
package org.apache.derbyTesting.system.oe.client;
import org.apache.derbyTesting.system.oe.model.Customer;
import org.apache.derbyTesting.system.oe.model.District;
import org.apache.derbyTesting.system.oe.model.Order;
import org.apache.derbyTesting.system.oe.model.OrderLine;
import org.apache.derbyTesting.system.oe.model.Warehouse;
/**
* Interface to display the results of the business operations.
* Methods are called by implementations of Operations.
* There is no requirement for implementations to follow
* the layout dictated by the TPC-C specification.
* All the information required by the TPC-C specification
* for display will be provided through the passed in parameters.
* <BR>
* Objects passed in from the data model (Customer etc.) may not
* be fully populated, but they will contain all the information
* required for that specific operation.
* <BR>
* Any display method must not retain references to any objects
* it is passed, the caller may be re-using the objects across transactions.
* <P>
* DECIMAL values are represented as String objects to allow
* Order Entry to be run on J2ME/CDC/Foundation which does
* not support BigDecimal.
*/
public interface Display {
/**
* Display the result of a stock level. Stock level terminal i/o is
* described in clause 2.8.3.
*
* @param displayData
* Client specific display information, such as servlet context.
* @param w
* Warehouse (input)
* @param d
* District (input)
* @param threshold
* Threshold (input)
* @param lowStock
* (result)
* @throws Exception
* Error displaying data
*/
public void displayStockLevel(Object displayData, short w, short d,
int threshold, int lowStock) throws Exception;
/**
* Display the result of an order status. Order status terminal i/o is
* decribed in clause 2.6.3.
*
* @param displayData
* Client specific display information, such as servlet context.
* @param byName
* Executed by name or by identifier.
* @param customer
* Customer for order
* @param order
* Order fetched.
* @param lineItems Items for the order
* @throws Exception
*/
public void displayOrderStatus(Object displayData, boolean byName,
Customer customer, Order order, OrderLine[] lineItems) throws Exception;
/**
* Display the result of a payment. Payment terminal i/o
* is described in clause 2.5.3.
* @param displayData Client specific display information, such as servlet context.
* @param amount Amount of payment.
* @param byName Executed by name or by identifier.
* @param warehouse Warehouse of payment
* @param district District of payment
* @param customer Customer of payment.
* @throws Exception
*/
public void displayPayment(Object displayData, String amount,
boolean byName, Warehouse warehouse, District district,
Customer customer) throws Exception;
/**
* Display the result of a new order. New order terminal i/o
* is described in clause 2.4.3.
* May need more parameters.
* @param displayData Client specific display information, such as servlet context.
* @param warehouse Warehouse of new order
* @param district District of new order
* @param customer Customer of new order
* @param order The new order
* @throws Exception
*/
public void displayNewOrder(Object displayData, Warehouse warehouse,
District district, Customer customer, Order order) throws Exception;
/**
* Display the result of a delivery schedule.
*
* @param displayData Client specific display information, such as servlet context.
* @param w Warehouse identifier
* @param carrier Carrier identifier
* @throws Exception
*/
public void displayScheduleDelivery(Object displayData, short w,
short carrier) throws Exception;
}
|
