public class Order {
...
// 此方法必须返回 true 才能使此订单有效
@AssertTrue(message="customer_order_invoice_must_match")
private boolean isInvoiceCustomerMatches() {
return invoice == null || // invoice is optional
invoice.getCustomer().getNumber() == getCustomer().getNumber();
}
}
customer_order_invoice_must_match=发票和订单的客户必须匹配
public class Order extends CommercialDocument {
@ManyToOne
@ReferenceView("NoCustomerNoOrders")
@OnChange(ShowHideCreateInvoiceAction.class)
@SearchAction("Order.searchInvoice") // 定义我们自己的动作来搜索发票
Invoice invoice;
...
}
<controller name="Order">
...
<action name="searchInvoice"
class="com.yourcompany.invoicing.actions.SearchInvoiceFromOrderAction"
hidden="true" icon="magnify"/>
<!--
hidden="true" : 因为我们不希望动作显示在模块的按钮栏中
icon="magnify" : 与标准搜索动作相同的图标
-->
</controller>
package com.yourcompany.invoicing.actions; // 在 actions 包
import org.openxava.actions.*; // 用于使用 ReferenceSearchAction
public class SearchInvoiceFromOrderAction
extends ReferenceSearchAction { // 搜索参照时的标准逻辑
public void execute() throws Exception {
int customerNumber =
getView().getValueInt("customer.number"); // 从视图中读取当前订单的客户编号
super.execute(); // 它会执行显示对话框的标准逻辑
if (customerNumber > 0) { // 如果有客户我们就用它
getTab().setBaseCondition("${customer.number} = " + customerNumber);
}
}
}
abstract public class CommercialDocument extends Deletable {
@SearchKey // 添加此注解
@Column(length=4)
@DefaultValueCalculator(CurrentYearCalculator.class)
int year;
@SearchKey // 添加此注解
@Column(length=6)
@ReadOnly
int number;
...
}
public class Order extends CommercialDocument {
@ManyToOne
@ReferenceView("NoCustomerNoOrders")
@OnChange(ShowHideCreateInvoiceAction.class)
@OnChangeSearch(OnChangeSearchInvoiceAction.class) // 添加此注解
@SearchAction("Order.searchInvoice")
Invoice invoice;
...
}
package com.yourcompany.invoicing.actions; // 在 actions 包
import java.util.*;
import org.openxava.actions.*; // 用于使用 OnChangeSearchAction
import org.openxava.model.*;
import org.openxava.view.*;
import com.yourcompany.invoicing.model.*;
public class OnChangeSearchInvoiceAction
extends OnChangeSearchAction { // 当搜索参照而用户界面中的键值有变化时的标准逻辑 (1)
public void execute() throws Exception {
super.execute(); // 它执行标准逻辑(2)
Map keyValues = getView()// getView() 这里是参照的视图，不是主视图 (3)
.getKeyValuesWithValue();
if (keyValues.isEmpty()) return; // 如果 key 为空，则不执行额外的逻辑
Invoice invoice = (Invoice) // 我们从输入的键搜索 Invoice 实体 (4)
MapFacade.findEntity(getView().getModelName(), keyValues);
View customerView = getView().getRoot().getSubview("customer"); // (5)
int customerNumber = customerView.getValueInt("number");
if (customerNumber == 0) { // 如果没有客户，我们填 (6)
customerView.setValue("number", invoice.getCustomer().getNumber());
customerView.refresh();
}
else { // 如果已经有客户，我们验证他是否跟发票的客户匹配 (7)
if (customerNumber != invoice.getCustomer().getNumber()) {
addError("invoice_customer_not_match",
invoice.getCustomer().getNumber(), invoice, customerNumber);
getView().clear();
}
}
}
}
invoice_customer_not_match=发票 {1} 的客户编号 {0} 与当前订单的客户编号 {2} 不匹配
public class Invoice extends CommercialDocument {
@OneToMany(mappedBy="invoice")
@CollectionView("NoCustomerNoInvoice")
@AddAction("Invoice.addOrders") // 定义我们的添加订单的动作
Collection<Order> orders;
...
}
<controller name="Invoice">
<extends controller="Invoicing"/>
<action name="addOrders"
class="com.yourcompany.invoicing.actions.GoAddOrdersToInvoiceAction"
hidden="true" icon="table-row-plus-after"/>
<!--
hidden="true" : 因为我们不希望动作显示在模块的按钮栏中
icon="table-row-plus-after" : 与标准動作相同的图标
-->
</controller>
package com.yourcompany.invoicing.actions; // 在 actions 包
import org.openxava.actions.*; // 用于使用 GoAddElementsToCollectionAction
public class GoAddOrdersToInvoiceAction
extends GoAddElementsToCollectionAction { // 到列表的标准逻辑（将元素添加到集合的列表）
public void execute() throws Exception {
super.execute(); // 它执行标准逻辑，显示一个对话框
int customerNumber =
getPreviousView() // getPreviousView() 是主视图（我们在一个对话框中）
.getValueInt("customer.number"); // 读取当前发票视图的客户编号
getTab().setBaseCondition( // 要添加的订单列表的条件
"${customer.number} = " + customerNumber +
" and ${delivered} = true and ${invoice} is null"
);
}
}
public class GoAddOrdersToInvoiceAction ... {
...
public String getNextController() { // 添加这个方法
return "AddOrdersToInvoice"; // 具有动作的控制器（添加订单列表中的动作）
}
}
<controller name="AddOrdersToInvoice">
<extends controller="AddToCollection" /> <!-- 从标准控制器扩展 -->
<!-- 覆盖 add 的动作 -->
<action name="add"
class="com.yourcompany.invoicing.actions.AddOrdersToInvoiceAction" />
</controller>
package com.yourcompany.invoicing.actions; // 在 actions 包中
import java.rmi.*;
import java.util.*;
import javax.ejb.*;
import org.openxava.actions.*; // 用于使用 AddElementsToCollectionAction
import org.openxava.model.*;
import org.openxava.util.*;
import org.openxava.validators.*;
import com.yourcompany.invoicing.model.*;
public class AddOrdersToInvoiceAction
extends AddElementsToCollectionAction { // 将元素添加集合的标准逻辑
public void execute() throws Exception {
super.execute(); // 我们如实使用标准逻辑
getView().refresh(); // 用于显示新数据，包括重新计算的税额等
}
protected void associateEntity(Map keyValues) // 用於关联的方法，在本例中将每个订单关联到发票
throws ValidationException,
XavaException, ObjectNotFoundException,
FinderException, RemoteException
{
super.associateEntity(keyValues); //它执行标准逻辑 (1)
Order order = (Order) MapFacade.findEntity("Order", keyValues); // (2)
order.copyDetailsToInvoice(); // 将主要工作委托给实体 (3)
}
}